Skip to content

feat(scaffold): badges, --github et chaîne de sécurité complète dans le squelette de catalogue (0.9.4) - #376

Merged
stephrobert merged 4 commits into
mainfrom
feat/squelette-badges
Nov 15, 2026
Merged

stephrobert merged 4 commits into
mainfrom
feat/squelette-badges

Conversation

@stephrobert

Copy link
Copy Markdown
Owner

Summary

dsoxlab new catalog produisait un catalogue sans badges dans le README et avec un seul job de CI. Un catalogue créé ainsi le 2026-11-15 (applications-ia-dsoxlab-training) en est sorti noté 5,1 par OpenSSF Scorecard. Les catalogues frères, qui portent la chaîne complète, sont à 7,4. La chaîne a d'abord été posée à la main sur ce dépôt, où tous ses jobs sont verts, puis reportée ici dans le squelette.

  • Badges : CI, OpenSSF Scorecard, Plumber, SLSA 3 et licence, sous la ligne de langue des deux README.
  • new catalog --github <propriétaire> : nouvelle option. Sans elle, le squelette écrit <owner> et la commande dit de le remplacer. Un nom invalide est refusé avant toute écriture. Le gabarit RELEASING nommait en dur un propriétaire réel à dix endroits : c'est corrigé.
  • Workflows : scorecard.yml, plumber.yml (avec .plumber.yaml), et dans ci.yml les jobs Zizmor, Actionlint, Poutine, Pre-commit parity et CodeQL (actions et python).
  • Fichiers de dépôt : dependabot.yml, configuration CodeQL, CODEOWNERS, modèles d'issue EN et FR, .poutine.yml, SECURITY.md EN et FR (divulgation coordonnée).
  • Ruleset de RELEASING : il exige exactement les sept contrôles que lance ci.yml. Un test les confronte aux noms des jobs, dans les deux sens. Avant, le ruleset copié d'un frère bloquait toutes les PR d'un catalogue neuf.
  • Une seule version par action dans le squelette (harden-runner v2.22.3, setup-uv v10.3.3), tenue par un test.
  • Manifeste : applications-ia-dsoxlab-training rejoint catalogues.yml, comme le hook de pre-push l'exigeait.

Type of change

  • Bug fix
  • New feature
  • Refactor
  • Documentation
  • Chore / tooling
  • Security / supply chain

Checklist

Always

  • ruff check src/dsoxlab/ tests/ passes. Le périmètre élargi (tests_e2e fuzz scripts) n'a pas été joué à part ; les hooks pre-commit et pre-push, qui ont tourné, couvrent leur propre périmètre.
  • uv run mypy src/dsoxlab passes (strict) : 124 fichiers.
  • uv run pytest passes : 2345 passed.
  • uv run pytest tests_e2e passes : 18 passed.
  • The engine stays domain-agnostic : aucun domaine dans le code ; le périmètre de SECURITY est générique à un catalogue de labs.
  • No hardcoded personal path or host : le propriétaire GitHub vient de --github, avec un test qui refuse tout propriétaire réel sans l'option (hors les liens vers le moteur lui-même).
  • Manually tested against two lab repositories : N/A pour le jeu de labs, le changement porte sur le squelette. À la place, essais réels de new catalog avec et sans --github, puis actionlint, zizmor --offline, validate-structure et pre-commit run --all-files sur le catalogue produit. Tout est vert sauf le hook contrat-valide, qui réclame dsoxlab>=0.9.4, pas encore publié.

When behavior changes

  • Both CHANGELOG.md and CHANGELOG.fr.md updated (0.9.4).
  • Version bumped in pyproject.toml (0.9.4) and uv.lock refreshed.

When a command or option is added, removed or changed

  • Keys added to both en.py and fr.py (opt_new_github, scaffold_github_a_remplacer, scaffold_github_invalide, scaffold_socle_pose).
  • help=_("…") and fullhelp_commands updated in EN and FR.
  • Checked with DSOXLAB_LANG=en and DSOXLAB_LANG=fr : l'avertissement sans --github s'affiche dans les deux langues.
  • No new logger.* message.

Questions ouvertes

  • Le job Pre-commit parity installe trufflehog, mais le .pre-commit-config.yaml du squelette n'a pas de hook trufflehog. Le commentaire du workflow dit comment l'ajouter. L'ajouter imposerait trufflehog sur le poste de chaque contributeur.
  • La CI d'un catalogue neuf reste rouge tant que uv lock n'est pas commité (uv lock --check). C'est le premier geste déjà documenté.

🤖 Generated with Claude Code

stephrobert and others added 4 commits November 15, 2026 17:24
… Scorecard et Plumber (0.9.4)

`dsoxlab new catalog` écrit désormais, sous la ligne de langue des deux
README, les cinq badges de la collection : CI, OpenSSF Scorecard,
conformité Plumber, SLSA 3 et licence. Forme reprise du catalogue cloud ;
les libellés Plumber et licence sont traduits en français, et le badge de
licence suit la licence posée par le squelette.

Nouvelle option `--github <propriétaire>` : le dépôt est
`<propriétaire>/<id>`. Elle sert aux badges et aux commandes de
vérification de RELEASING (EN et FR) et du commentaire d'attester.yml,
qui nommaient jusqu'ici un propriétaire réel en dur. Sans l'option,
l'emplacement `<owner>` est écrit et la commande dit de le remplacer. Un
nom qui ne peut pas être un nom GitHub est refusé avant toute écriture.

Le socle gagne scorecard.yml et plumber.yml, repris du catalogue cloud
(épinglage par SHA, permissions minimales), et le .plumber.yaml sans
lequel l'action Plumber refuse de tourner, packagé comme donnée sous
templates/plumber/. Les deux workflows se sautent tant que le dépôt est
privé. RELEASING les décrit.

Tests : tests/test_socle_badges.py (badges avec et sans --github, message
intercepté, propriétaire invalide, option déclarée, workflows chargés) ;
les tests YAML et d'épinglage de test_socle_du_catalogue.py couvrent
maintenant tous les workflows du socle.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…lance ; une seule version de harden-runner

Le ruleset « Protection de main » proposé par RELEASING (EN et FR) avait
été repris d'un catalogue frère. Il exigeait Zizmor, Actionlint, Poutine,
Pre-commit parity, le contrat avec leçons jumelées et deux CodeQL : aucun
de ces contrôles n'est lancé par le ci.yml du squelette. Appliqué sur un
catalogue neuf, il bloquait toutes les pull requests, GitHub attendant
pour toujours des contrôles qui ne viennent jamais. Il n'exige plus que
`Contract, guardrails and lint`, et le texte dit d'y ajouter un job le
jour où ci.yml en gagne un, pas avant.

harden-runner passe en v2.22.3 (46b06cea…) dans ci.yml, release.yml et
attester.yml du socle, le même SHA que scorecard.yml et plumber.yml : un
catalogue neuf n'a plus deux versions de la même action.

Tests ajoutés dans tests/test_socle_du_catalogue.py :
- chaque contrôle exigé par le ruleset de RELEASING (EN et FR) est un nom
  de job de ci.yml ; vérifié rouge sur l'ancien texte ;
- une action n'est épinglée que sur une seule version dans le socle.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…quelette (0.9.4)

Reprise de applications-ia-dsoxlab-training à e7db2da, où tous les jobs
sont verts et où le ruleset exige les sept contrôles.

- ci.yml gagne les jobs Zizmor, Actionlint, Poutine, Pre-commit parity et
  CodeQL (matrice python et actions), à côté de « Contract, guardrails and
  lint ». Les noms `name:` sont ceux de la référence, au caractère près.
  Les commentaires propres à la référence (catalogues Linux et
  Kubernetes, absence de workflow dans les labs) sont rendus génériques.
- Le ruleset de RELEASING (EN et FR) exige ces sept contrôles.
- Nouveaux fichiers : .github/dependabot.yml (le modèle commun, uv et
  github-actions, en-tête sans nom de dépôt), .github/codeql/config.yml
  (fixtures et solutions exclues, rédaction générique), .github/CODEOWNERS
  (propriétaire de --github, ou <owner>), .github/ISSUE_TEMPLATE/config.yml
  et lab_report.yml (bilingues, avec l'URL du dépôt du catalogue), et
  .poutine.yml.
- SECURITY.md et SECURITY.fr.md suivent la structure de la référence :
  versions supportées, signalement privé par avis de sécurité GitHub de
  <propriétaire>/<id>, délais de divulgation, périmètre générique à un
  catalogue de labs, ce que le dépôt ne demandera jamais.
- setup-uv passe en v10.3.3 partout : chaque action n'a qu'une version.

Tests : tests/test_socle_securite.py (fichiers écrits et chargés, sept
contrôles aux noms exacts, Dependabot, CodeQL, CODEOWNERS avec et sans
--github, structure de SECURITY, gabarits d'issue, aucun propriétaire
réel sans --github). Le test du ruleset développe désormais la matrice
CodeQL et vérifie l'accord dans les deux sens ; les tests d'épinglage ne
lisent plus que les clés `uses:` YAML, pas les commentaires qui en citent.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dépôt public avec 3 labs publiés le 2026-11-15 ; le hook de pre-push le
réclamait. Table des catalogues du README régénérée (722 labs mesurés).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@stephrobert
stephrobert merged commit f1c70c0 into main Nov 15, 2026
20 checks passed
@stephrobert
stephrobert deleted the feat/squelette-badges branch November 15, 2026 17:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant