RUNTIME-ROUNDTRIP-IMPORT-001

Changed-only-Roundtrip-Import#

Die wiederverwendbare Importmechanik liegt in engineering-tools/20-roundtrip/changed_only_import.py. Runtime besitzt ausschließlich lokale Pfade, Zustand, Archive und Laufberichte.

Vorbereitung#

nach kopieren.
Nur Repositorys eintragen, die lokal importiert werden dürfen. Die

Freigabeliste muss bereits vor dem ersten Gesamtpaket alle darin möglichen Repositorys enthalten; ein Gesamtpaket wird vollständig vorgeprüft, bevor es sein erstes Teil-ZIP importiert.

Die gelieferten Einzel-ZIPs und optional das separate Semantic-GAP-ZIP in ein Eingabeverzeichnis legen. Alternativ genau ein manifestiertes Gesamtpaket (roundtrip-import-package) allein in das Eingabeverzeichnis legen.

Einmaliger Bootstrap für neue Repositorys#

Wird ein Repository erstmals in den Gesamtprozess aufgenommen, wird zuerst ein separates runtime.zip importiert, das dessen lokalen Zielpfad in freigibt. Erst danach darf ein Gesamtpaket das neue Repository enthalten. Der Bootstrap selbst ist kein Gesamtpaket und enthält keine fachlichen Repository-Änderungen.

Aufruf#

bin/import-roundtrip.py --input-dir ~/netzwerksolution/workspace/downloads/roundtrip

Vorprüfung ohne Änderungen:

bin/import-roundtrip.py --input-dir <verzeichnis> --dry-run

NS_CHANGED_ONLY_IMPORT_TOOL kann den Pfad zur kanonischen Implementierung überschreiben.

Verhalten#

Nur tatsächlich gelieferte Repository-ZIPs werden importiert.
Nicht gelieferte Repositorys bleiben unverändert.
Repository-Identität und Installierbarkeit werden vor Änderungen geprüft.
Vorstände werden unter archiveRoot archiviert. Dieser Pfad ist lokaler

Runtime-Zustand außerhalb aller importierbaren Repositorys; die mitgelieferte Konfiguration verwendet ~/.local/state/netzwerksolution/roundtrip-imports.

Das Semantic GAP wird separat nach semanticGapTarget übernommen.
Ein Gesamtpaket wird vollständig inklusive Prüfsummen und inneren Archiven

vor der ersten Änderung geprüft; die Repositorys werden ausschließlich in dessen repositoryOrder eingelesen.

Die Vorprüfung akzeptiert ausschließlich Repositorys, die in der bereits

installierten lokalen Konfiguration freigegeben sind.

Bei einem Fehler wird der Gesamtprozess beendet. Der vorhandene JSON-

Laufbericht weist bereits importierte Schritte und NOT_EXECUTED für alle nachfolgenden Schritte aus und ist der Fehlerbericht für den nächsten Chat.

Der JSON-Laufbericht liegt standardmäßig unter reports/roundtrip-import-report.json.