ET-VALIDATION-TOOL-CONTRACT-001

Artifact Manifest Validator Tool Contract#

Verantwortung#

validiert deklarierte Artifact-Manifeste eines Repositorys sowie optional deren Bezüge zur Solution und Enterprise Architecture. Das Werkzeug entscheidet keine Architekturfragen und verändert keine geprüften Repositorys.

Eingabe#

validate-artifact-manifests.py REPOSITORY \
                  [--solution-architecture PATH] \
                  [--enterprise-architecture PATH]

REPOSITORY ist das zu prüfende Repository.
Architekturpfade sind optionale, lesende Referenzquellen für zusätzliche Prüfungen.

Ausgaben#

Das Werkzeug gibt Validierungsergebnisse und Findings über seine Befehlsausgabe aus. Erfolgreiche Ausführung bedeutet, dass die implementierten Prüfregeln erfüllt wurden; sie ersetzt weder Regressionstests noch fachliche Freigaben.

Seiteneffekte#

Der Validator ist lesend. Änderungen an Eingaberepositorys, Architekturquellen oder Runtime-Zuständen sind unzulässig.

Fehlerverhalten#

Ein von null verschiedener Exit-Code signalisiert mindestens einen Validierungsfehler oder eine nicht vollständig ausführbare Prüfung. Findings müssen so konkret sein, dass das betroffene oder die betroffene Regel identifizierbar ist.

Verifikation#

../98-tests/artifact-manifest-validator-test.sh
human-readable-code-contract-rules.md
human-readable-test-contract-rules.md

Architekturbezug#

Explizite, versionierte Compliance-Verträge werden modular geprüft. Historische Dokumentation oder beliebige Fließtexte werden nicht als implizite ausführbare Verträge interpretiert.