ET-CLI-AUTOMATION-EVIDENCE-CONTRACT-001

CLI Automation and Evidence Contract#

Nichtinteraktive Nutzung#

Freigegebene CLI-Services dürfen keine interaktive Eingabe voraussetzen. Alle für Automatisierung erforderlichen Werte kommen aus Argumenten, versionierbarer Konfiguration oder dokumentierten Umgebungsvariablen.

Reproduzierbarkeit#

• Eingaben und Zielpfade müssen im Aufruf oder in referenzierter Konfiguration nachvollziehbar sein.
• Zeitstempel und Laufkennungen dürfen variieren; fachliche Ergebnisse identischer Eingaben bleiben stabil.
• Temporäre Dateien werden außerhalb führender Repository-Inhalte erzeugt und nach Möglichkeit bereinigt.

Evidence#

Materialisierende und deployende Services dokumentieren mindestens:

• ⌘ServiceEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung. und Version beziehungsweise Repositorystand,
• Lauf- oder Roundtrip-ID, soweit vorhanden,
• Zielumgebung oder Zielpfad,
• Ergebnisstatus,
• relevante Phasen oder Findings,
• Pfad zu Detailreport oder Log.

Pipeline-Nutzung#

Pipelines bewerten zuerst den Exit-Code und archivieren danach benannte ⌘EvidenceTechnical documentation artifact.. Textsuche in freier Konsolenausgabe ist kein Ersatz für einen stabilen Vertrag.

Sicherheit#

Secrets dürfen nicht als Pflichtargumente modelliert, in Reports gespiegelt oder in Beispielaufrufen ausgeschrieben werden. Lokale Secret-Quellen bleiben außerhalb des Repositorys.