README

Packaging#

Zweck#

ZIP-Erzeugung, Dateilisten, Prüfsummen, Signaturen und Distributionspakete.

Verantwortlichkeit#

Dieser Bereich verantwortet ausschließlich die unter „Zweck“ beschriebene Sicht innerhalb von engineering-tools.

Inhalt#

Freigegebene Quellen und Modelle dieses Verantwortungsbereichs.
Navigation und Querverweise zu abhängigen Artefakten.
Arbeitsdokumente nur dann, wenn sie bewusst bei diesem fachlichen Eigentümer geführt werden.

Gehört ausdrücklich nicht hier hinein#

Veränderliche Laufzeitzustände oder generierte Betriebsausgaben.
Inhalte, deren höchste allgemeingültige Ebene in einem anderen Repository liegt.
Unkontrollierte Duplikate bereits führender Quellen.

Beziehungen#

Ist Bestandteil von engineering-tools.
Wird durch Contract, Baselines und ADRs eingeordnet.
Kann durch engineering-tools validiert, materialisiert oder paketiert werden.

Typischer Workflow#

Inhalte werden innerhalb des beauftragten Scopes erstellt oder geändert, gegen führende Quellen validiert und erst danach promoted.

Langfristige Entwicklung#

Der Bereich wird schrittweise mit realen Artefakten gefüllt; seine Verantwortungsgrenze bleibt dabei stabil.

Implementierte Werkzeuge#

– deterministische Repository-ZIP-Erzeugung.
ZIP_ERZEUGUNGSVERTRAG.md – Verhalten, Grenzen und Migrationsbezug.
– Erzeugung und Validierung des Zwei-Archiv-GAP-Arbeitspakets.
GAP_ARBEITSPAKET_VERTRAG.md – Rootstruktur, Promptbildung, Scope- und Sicherheitsregeln.
– versionierte, repositorybezogene Regeln für ausschließlich temporäre Uploadkopien.
Workspace-archive/ wird als lokaler Importbestand bereits bei der Repository-ZIP-Erzeugung und zusätzlich im Uploadfilter ausgeschlossen.
gap_work_package.py validate – Paketvalidator für Rollen, Identitäten, Prüfsummen, sichere ZIP-Strukturen und Filter-Evidence.
– prüft die konkret zurückzugebenden Einzel-ZIPs, schreibt eine Lieferliste und erzeugt daraus ein geordnetes Gesamtpaket.
– reproduzierbarer Inhaltsvergleich zwischen Legacy-Uploadset und neuem GAP-Arbeitspaket.
LEGACY_GLEICHWERTIGKEITSVERTRAG.md – zulässige bewusste Unterschiede und harte Abbruchkriterien des Migrationsvergleichs.

Der Legacy-Vergleich ist nach SE-0012 historische Migrationsevidence und kein aktiver Produktionspfad. Repository-ZIPs und Arbeitspakete werden danach nur noch durch die kanonischen Werkzeuge dieses Verzeichnisses erzeugt.