Contribuer à feuristic¶
Les correctifs ciblés, la documentation, les résultats matériels et les améliorations de protocole sont bienvenus. Consultez les issues avant un gros changement. Pour une vulnérabilité, suivez la politique de sécurité.
Préparer une contribution¶
Lisez l’architecture, le modèle de menace
et le protocole concerné. Installez l’environnement.
Pour la documentation seule, uv sync --frozen --only-group docs suffit.
Les contributions sont sous GPL-3.0-only. Vous devez disposer des droits nécessaires, préserver les notices amont et ajouter l’en-tête SPDX aux nouveaux fichiers concernés. Aucun accord de cession de droits séparé n’est demandé.
Politique de pull request¶
- Décrivez le problème concret et le comportement obtenu ; liez l’issue utile. Séparez les modifications sans rapport.
- Expliquez les effets sur PIN, consentement, USB, stockage, clés ou récupération. Une propriété de sécurité ne doit pas être affaiblie silencieusement.
- Donnez les vérifications réellement exécutées, modèle/OS et preuves. Indiquez explicitement les essais matériels non exécutés.
- Ajoutez un test de régression adapté aux changements de comportement. Les textes d’interface doivent exister en anglais et en français.
- Un responsable vérifie correction, sécurité, licences et tests. Les contrôles requis doivent passer avant fusion. Une approbation d’un responsable est attendue pour le code ; les changements sensibles demandent une personne connaissant le protocole concerné.
Ne joignez ni PIN, seed, clé privée, sauvegarde réelle, identifiant d’appareil personnel ni export d’environnement sans rapport. Employez des identités jetables.
Vérifications¶
| Changement | Contrôles |
|---|---|
| Documentation | uv run --group docs mkdocs build --strict |
| Logique Python | make test-host et make lint |
| Interface / USB / démarrage | Tests hôte et tests fonctionnels concernés sur les deux émulateurs |
| C, analyseurs, crypto | make test-c, compilation ARM et fuzzing concernés |
| Candidat matériel | Deux builds, CI requise et procédures physiques applicables |
Les rapports matériels vont dans docs/acceptance/. Consultez les
tests et les règles de traduction.
Modifications amont¶
Gardez les changements dans patches/, documentés avec un trailer
Feuristic-Rationale:. Ne stagez pas le gitlink du sous-module modifié et ne
réinitialisez pas un arbre préparé comme réparation courante. Suivez le
guide des correctifs.
Le projet n’ajoute ni fonctions de cryptomonnaies, télémétrie, compte réseau ni service compagnon obligatoire. La politique complète et le code de conduite s’appliquent.