ET-PKG-LEGACY-EQUIVALENCE-CONTRACT-001

Legacy-Paketgleichwertigkeitsvertrag#

Ziel und Nicht-Ziele#

vergleicht ein vor SE-0012 erzeugtes oder archiviertes Legacy-Uploadset mit einem validierten neuen GAP-Arbeitspaket aus identischen Repository-Eingaben. Der Vergleich belegt historische Migration, nicht Bytegleichheit der Container. Der aktive Workspace bietet nach SE-0012 keinen Legacy-Erzeugungspfad mehr an.

Nicht verglichen werden ZIP-Zeitstempel, Kompressionsmetadaten und das laufbezogene exportTimestamp des Legacy-Manifests. Der Validator führt weder Import, Deployment, noch Stilllegung der alten Prozesskette aus.

Eingaben#

ein bestehendes Legacy-Ausgabeverzeichnis mit und Repository-ZIPs,
ein bestehendes neues GAP-Arbeitspaket mit package-manifest.json, SHA256SUMS.txt, sources.zip und targets.zip,
die unveränderte ursprüngliche GAP-ZIP,
jede ursprüngliche Target-ZIP als NAME=PFAD,
ein noch nicht vorhandener Pfad für den JSON-Migrationsnachweis.

Das Legacy-Manifest muss artifactType: chatgpt-upload-set und version: 2.0 deklarieren. Das neue Paket muss seinen vollständigen SE-0008-Vertrag bestehen.

Inhaltliche Gleichwertigkeit#

Die Repositorymenge des Legacy-Sets muss exakt der Source-Repositorymenge des neuen Paketmanifests entsprechen. Jedes Repository-ZIP wird vollständig und sicher gelesen.

Pro Repository gelten folgende Regeln:

Gemeinsame Pfade müssen byteidentische Inhalte besitzen.
Im neuen Source-ZIP zusätzliche Pfade sind unzulässig.
Nur im Legacy-ZIP vorhandene Pfade sind ausschließlich dann zulässig, wenn sie exakt den im neuen Paketmanifest protokollierten excludedPaths eines Uploadfilters entsprechen.
Jeder deklarierte Filterpfad muss im Legacy-ZIP vorhanden und im neuen Source-ZIP abwesend sein.
Nicht durch Filter-Evidence erklärte Unterschiede führen zu FAILED.

Die vollständigen Repository-ZIPs in targets.zip und gap.zip müssen zu den explizit angegebenen ursprünglichen Target- beziehungsweise GAP-Archiven byteidentisch sein.

Bewusste Strukturunterschiede#

Der Nachweis klassifiziert ausschließlich folgende bekannte Unterschiede als bewusst:

Legacy: einzelne Repository-ZIPs plus laufbezogenes .
Neu: sources.zip und targets.zip mit getrennten unveränderlichen und veränderbaren Rollen.
Neu: erzeugtes PROMPT.md und kontrolliertes gap.zip.
Neu: Repositoryrollen, Identitäten und Allowed Target Scope im Paketmanifest.
Neu: SHA256SUMS.txt, Sicherheitsvalidierung und atomare Veröffentlichung.
Neu: ausschließlich manifestbelegte Filterung der temporären Runtime-Source-Kopie.

Andere Abweichungen dürfen nicht stillschweigend akzeptiert werden.

Ausgabe und Fehlerverhalten#

Der JSON-Bericht enthält Status, Eingabeidentitäten, Repositoryergebnisse, bewusste Unterschiede und die Liste ungeklärter Differenzen. Er wird erst nach vollständiger Prüfung atomisch veröffentlicht.

0: PASSED, keine ungeklärte Differenz.
2: ungültige Eingabe, Sicherheitsfehler oder ungeklärte Differenz; kein Erfolgsbericht wird veröffentlicht.

Traceability#

GAP SE-0009 — Gleichwertigkeit mit der alten Prozesskette validieren
GAP SE-0012 — Legacy-Erzeugungspfad stilllegen und historisieren
GAP_ARBEITSPAKET_VERTRAG.md
workspace:documentation/engineering-management/roundtrip-process-inventory-se-0001.md
workspace:documentation/operation/create-chatgpt-upload-zips-engineering.md