Docs · Internals
Comment un changement devient une version
Chaque pull request du dépôt nexus passe les mêmes contrôles, et un tag de version devient des archives de release et des crates publiés. Ce schéma suit les workflows tels qu'ils sont écrits.
Ce que ça fait
À chaque push ou pull request : formatage et contrôle de l'index des diagrammes, clippy avec avertissements refusés, une matrice de tests sur Linux, macOS et Windows, la documentation, et un build à la version minimale de Rust prise en charge, 1.88.
Sur les pull requests, un contrôle de dérive refuse un changement d'un fichier couvert par un diagramme, sauf si le diagramme change aussi ou si un trailer de commit dit pourquoi non.
Un tag commençant par v crée la release GitHub avec un changelog généré, construit des archives Linux, macOS et Windows, publie les crates et met à jour la branche de version.
Le schéma
Fais glisser pour te déplacer. Pince, Ctrl + molette ou les touches + et - pour zoomer ; flèches pour bouger ; 0 ou double-clic pour ajuster. Choisis un nœud pour allumer ses liens.
Description textuelle du schéma
Schéma de flux en deux parties. Pull request ou push : un push démarre le job fmt et, sur les pull requests seulement, le job diagram-drift. Après fmt viennent clippy, la matrice de tests, la construction de la documentation et le build à la version minimale. Tous, avec diagram-drift, alimentent une porte nommée CI Success. La matrice de tests alimente aussi la couverture, qui va à Codecov : la couverture du projet est informative et celle du patch bloque à 80 pour cent. Un audit de sécurité avec cargo-deny est consultatif. Release : un tag commençant par v génère le changelog, crée la release GitHub et construit des archives pour Linux x64 et ARM64, macOS x64 et ARM64 et Windows x64, envoyées sur la release. La release publie aussi les crates nexus-claude puis claude-code-api, et met à jour la branche de version.
Lecture guidée
Étape 1. fmt
rustfmt en mode contrôle, et une vérification que l'index des diagrammes est dérivé des en-têtes des diagrammes et à jour.
Étape 2. diagram-drift (pull requests seulement)
Si un fichier modifié est couvert par un diagramme, la même pull request doit changer ce diagramme, ou l'un de ses commits doit porter un trailer Diagram-Unchanged avec une raison. Il est sauté sur les push, où il n'y a pas de branche à comparer.
Étape 3. clippy, tests, docs, version minimale
Clippy refuse les avertissements. La matrice de tests exécute Ubuntu, macOS et Windows en stable et beta, plus nightly sur Ubuntu à titre consultatif. La documentation se construit avec les avertissements refusés. Le crate doit compiler avec Rust 1.88.
Étape 4. CI Success
La porte requise attend fmt, diagram-drift (ou son saut), clippy, les tests, la doc et le build à la version minimale. La couverture et l'audit de sécurité n'en font pas partie.
Étape 5. Couverture
cargo llvm-cov alimente Codecov. Le chiffre du projet est informatif. La porte du patch bloque : les lignes changées par une pull request doivent être couvertes à au moins 80 pour cent.
Étape 6. Release
Un tag commençant par v génère le changelog et crée la release GitHub, construit des archives (tar.gz pour Linux et macOS, zip pour Windows) et les envoie, publie nexus-claude puis claude-code-api sur crates.io, et met à jour la branche de version.
Pourquoi c'est conçu ainsi
La CI garde les diagrammes honnêtes
Le contrôle de dérive force à se demander si un diagramme tient encore à chaque changement de son code. Il ne prouve pas que le diagramme est exact, seulement que quelqu'un a regardé.
Consultatif là où le signal est bruité
Le compilateur nightly est sujet à des erreurs internes sans rapport avec le code : il ne peut pas bloquer. L'audit des dépendances est consultatif pour l'instant.
La couverture du patch bloque, celle du projet informe
Le chiffre du projet est informatif tant que la base n'est pas relevée. Tenir chaque nouveau changement à la barre le fait quand même évoluer dans le bon sens.
Un test bloqué est coupé
Le job de tests a un délai de 30 minutes. Un blocage passé sur Windows avait laissé un job muet pendant presque une heure avant d'être annulé à la main.
Sources publiques
Où vérifier chaque affirmation, dans les dépôts publics.