Formats et référentiels
Des pièces que vos outils savent lire.
runward écrit son verdict dans des formats ouverts. Ce sont des pièces à l’appui d’un examen : la conformité reste celle de l’entité évaluée.
Les formats
Une commande, un format, un lecteur.
Ces sorties viennent de la commande runward, dans votre chaîne de livraison. Aucune n’appelle le réseau.
runward check --strict --jsonLe verdict, l’état de chaque pièce du dossier, les écarts un par un.
Vos outils et vos tableaux de bord : un fichier à lire, ligne par ligne.
runward check --strict --attestLe verdict, lié à l’empreinte du dossier et des preuves citées.
La commande runward verify, qui le rejoue hors ligne.
runward check --strict --sarifUne annotation par cause de refus, sur la ligne du dossier concernée.
Validé contre le schéma SARIF 2.1.0 d’OASIS. Vous le téléversez vous-même dans votre forge.
runward compliance eu-ai-actUne définition de composant, au format du NIST : dix exigences, les catégories ASI01 à ASI10 de l’OWASP, chacune avec un statut dérivé du contrôle.
compliance-trestle 4.2.0 le charge à chaque exécution de la chaîne de runward.
runward compliance iso-42001Un brouillon par référentiel : ce que runward fournit, et ce qui reste à l’entité. La commande le dit elle-même : « a readiness draft, never a compliance claim ».
Un évaluateur.
runward check --strict --vsa --resource-uri pkg:npm/request-triage@1.0.0Un résumé du verdict pour un moteur de politique. Il n’affirme aucun niveau SLSA.
Recette documentée : une politique Kyverno d’exemple.
runward reportUne page HTML autonome : le verdict, pour un lecteur sans terminal ni compte.
Un évaluateur, seul.
runward check --freezeL’empreinte de chaque preuve citée. Une modification ultérieure fait refuser le contrôle.
La commande runward check --strict.
- Aucune de ces sorties n’est signée par runward. La signature est votre geste, avec votre propre clé.
- runward lit aussi vos rapports comme preuves : JUnit, SARIF, couverture, et un inventaire logiciel au format CycloneDX. Il les lit ; il ne les produit pas pour votre projet.
Les référentiels
Un référentiel est une étiquette et un brouillon.
Le fichier OSCAL garde toujours les mêmes contrôles : les dix catégories de l’OWASP pour les applications agentiques. Le référentiel choisi change le brouillon qui l’accompagne, pas ces contrôles.
- iso-42001ISO/IEC 42001:2023Des preuves d’ingénierie qu’un programme de management de l’IA peut utiliser comme intrants.
- nist-ai-rmfNIST AI RMF 1.0Un cadre volontaire. Le brouillon rattache les décisions écrites, le verdict et les règles à ses fonctions.
- eu-ai-actAI Act, règlement (UE) 2024/1689Le brouillon alimente la documentation technique de l’annexe IV, en particulier son point 2 : les choix de conception et leur justification. Il nomme ce qui reste au fournisseur.
Usages concrets
Neuf situations, chacune avec sa limite.
Ce que vous avez en main dans chaque cas, la commande qui le produit, et jusqu’où cela va.
- 01Comité de changement
Un changement produit par un agent arrive en comité. Vous avez un verdict rejouable sur le commit, avec les écarts par cause.
runward report --format mdLimiteCe n’est pas un contrôle d’approbation indépendant : runward ne lit pas les approbations de la forge.
- 02Revue d’architecture
La revue veut les décisions structurantes et ce qui les ferait rouvrir. Vous avez le journal des décisions écrites, avec leurs dates.
runward status --jsonLimiteLa pièce vient de la commande.
- 03Audit interne
Des mois plus tard, l’audit demande si la preuve citée est encore celle qui a été contrôlée. Vous avez un sceau, et une attestation qui se rejoue hors ligne.
runward verify verdict.intoto.jsonLimiteLe sceau n’est pas signé : il détecte une dérive, pas une réécriture par qui peut modifier le fichier. La relecture compare le dossier à l’empreinte ; elle ne vérifie aucune signature.
- 04Dossier AI Act
Un fournisseur constitue la documentation technique de l’annexe IV. Vous avez un brouillon qui en alimente le point 2 depuis les décisions écrites.
runward compliance eu-ai-actLimiteUn brouillon de préparation, pas une évaluation. Les journaux d’exécution viennent du système déployé.
- 05Contrôle des changements, dans la finance
Vous devez montrer comment chaque changement a été décidé et vérifié. Vous avez, par changement, la décision, des preuves qui se résolvent et un verdict rejouable.
runward check --strict --jsonLimiteDes pièces à verser à votre propre dossier. Aucune lecture propre au règlement DORA n’est livrée.
- 06Évaluation d’un fournisseur
Un intégrateur livre du code produit par des agents. Vous exigez le commit, la version et la commande exacte, et vous rejouez le contrôle vous-même.
npx runward@0.46.0 check --strict --jsonLimiteSur un dépôt privé, il faut un accès en lecture pour rejouer.
- 07Reprise par une autre équipe
Une équipe hérite d’un système. Le contrôle exige la procédure de reprise et la note de passation avant de laisser passer.
runward checkLimiteIl vérifie que ces pièces existent et sont remplies. Leur qualité reste votre jugement.
- 08Outil de gouvernance et de risque
L’équipe conformité veut une pièce lisible par une machine, pas un PDF. Vous avez un fichier OSCAL 1.2.3.
runward compliance iso-42001 -o preuvesLimiteOutil éprouvé : compliance-trestle. L’import dans votre propre outil reste votre étape de vérification.
- 09Admission d’un déploiement
La production ne doit accepter que ce dont le contrôle est passé. Vous avez un résumé de vérification que vous signez avec votre clé.
runward check --strict --vsa --resource-uri pkg:npm/request-triage@1.0.0LimiteRecette documentée, avec une politique Kyverno d’exemple. Elle n’est pas rejouée dans la chaîne de runward.
Essayez sur un exemple, en une commande.
Essayer sur un exemple