Aller au contenu

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

Les workflows d'intégration continue et de releaseSché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.push / PRfmtrustfmt --checkdiagram index derived and currentdiagram-drift (PR only)a covered file changed:its diagram changed too,or a Diagram-Unchanged trailer with a reasonclippy-D warningstest matrixubuntu, macos, windowsstable and beta+ nightly, advisorydocscargo doc, warnings deniedMSRV 1.88cargo build --all-featuresCI Successcoveragecargo llvm-covCodecovproject: informationalpatch: blocking at 80%securitycargo-deny, advisorytag v*generate the changelogcreate the GitHub Releasebuild artifactsLinux x64, ARM64tar.gzmacOS x64, ARM64tar.gzWindows x64zipupload to the releasepublish to crates.ionexus-claude, then claude-code-apiupdate the version branch

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.

DézoomerZoomerPlein écran
Redessiné depuis le diagramme vérifié nexus-ci-pipeline (vérifié 2026-10-03). Les libellés sont les noms utilisés dans le code.
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

  1. É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.

  2. É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.

  3. É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.

  4. É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.

  5. É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.

  6. É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.