ET-VALIDATOR-EXECUTION-CONTRACT-001
Validation Execution Contract#
Eingaben#
- Eingaben müssen explizit als Pfad oder Option übergeben werden.
- Optionale Architekturquellen sind ausschließlich lesende Referenzen.
- Fehlende Pflichtquellen und nicht lesbare Daten sind Fehler, keine übersprungenen Erfolge.
Seiteneffekte#
Validatoren sind lesend. Reporter dürfen ausschließlich das explizit angegebene Ausgabeartefakt erzeugen und hierfür notwendige Elternverzeichnisse anlegen. Änderungen an geprüften Quellen sind unzulässig.
Exit-Vertrag#
| Exit | GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen |
|---|---|
0 |
alle implementierten Pflichtprüfungen erfolgreich |
ungleich 0 |
mindestens ein Fehler oder eine nicht zuverlässig ausführbare Pflichtprüfung |
Ein Exit-Code 0 darf nicht verwendet werden, wenn keine prüfbaren Eingabeartefakte gefunden wurden und der Werkzeugzweck dadurch nicht erfüllt wurde.
Ausgabe#
- Standardausgabe enthält Erfolg oder angeforderte Reportdaten.
- Standardfehler enthält fehlgeschlagene Prüfungen und konkrete Findings.
- Automatisierung darf nicht von dekorativer Formatierung abhängen.
- Ausgabedateien müssen deterministisch aus denselben Eingaben erzeugbar sein.
Zusammenspiel#
Code-ArtifactCodeansicht öffnen ist der führende ausführbare Validator für Artifact-Manifeste. Die Reportwerkzeuge projizieren bereits deklarierte Daten und dürfen einen fehlgeschlagenen Validatorlauf nicht in positive GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen umdeuten.