ET-PKG-ROUNDTRIP-DELIVERY-CONTRACT-001

Vertrag der Roundtrip-Rücklieferung#

◆roundtrip_delivery.py ist der kanonische Abschluss-Gate für eine Rücklieferung. Es akzeptiert ausschließlich die konkret auszuliefernden Repository-ZIPs und ein installierbares Semantic-GAP-ZIP.

Für jedes Repository sind mindestens eine erwartete geänderte Datei und ein Inhaltsmarker anzugeben. Fehlt einer dieser Pfade im ZIP, stimmen Repository-Identität oder Prüfsumme nicht, oder existiert das Ausgabeverzeichnis bereits, bricht der Lauf ohne Rücklieferung ab.

Bei Erfolg entstehen in einem neuen, eindeutigen Ausgabeverzeichnis:

• je Repository eine mit deliveryId präfixierte Einzel-ZIP,
• eine ebenso präfixierte Semantic-GAP-ZIP,
• delivery-manifest.json mit Reihenfolge, ⌘SHA-256Technical documentation artifact., erwarteten Dateien und

Markern,

• ein roundtrip-import-package mit exakt diesen Einzel-ZIPs und expliziter

repositoryOrder.

Das Gesamtpaket enthält keine zusätzliche Lieferliste, damit der lokale Importer seine strikte Paketstruktur beibehalten kann. Die Lieferliste liegt daneben und beschreibt exakt dieselben Bytes. Der Importer prüft das gesamte Paket vor dem ersten Schreibvorgang und bricht bei einem Fehler ab.

Beispiel:

python3 roundtrip_delivery.py \
                  --output-dir delivery \
                  --repository engineering-tools=engineering-tools.zip \
                  --repository runtime=runtime.zip \
                  --gap semantic-gap.zip \
                  --expected engineering-tools=engineering-tools/60-packaging/roundtrip_delivery.py \
                  --marker engineering-tools=engineering-tools/manifest.json \
                  --expected runtime=runtime/bin/import-roundtrip.py \
                  --marker runtime=runtime/manifest.json