Netzwerksolution Documentation Report

RUNTIME-GAP-WORK-PACKAGE-001

GAP-Arbeitspaket#

Die kanonische Erzeugungs- und Validierungslogik liegt in . Runtime hält ausschließlich lokale Pfade, Repository-Auswahl und Ausgabeort.

Normaler Bedienweg#

Im Normalbetrieb ist keine sprintbezogene work-package.json mehr nötig. Der Runtime-Adapter liest aus dem aktiven GAP:

Die dauerhaft lokale Pfadzuordnung liegt in . Repository-ZIPs werden intern über und damit die kanonische ZIP-Implementierung in engineering-tools erzeugt.

python3 bin/prepare-work-package.py

Jeder Lauf erhält automatisch ein neues Ziel unter ~/netzwerksolution/workspace/out/chatgpt-upload/<WORK-ITEM>-<ZEITSTEMPEL>/. Vorhandene Läufe werden niemals überschrieben. Nach Erfolg liegen sources.zip, targets.zip, package-manifest.json und SHA256SUMS.txt direkt in diesem Verzeichnis; interne Repository-ZIPs und temporäre Konfigurationen werden entfernt.

Konfigurierter Diagnoseweg#

  1. nach kopieren.
  2. Den aktiven semantic-gap.zip unter gap eintragen.
  3. Unveränderliche Referenz-ZIPs unter sources eintragen.
  4. Nur Repository-Arbeitskopien unter targets eintragen, die das aktive Work Item erlaubt.
  5. Die versionierte Filterkonfiguration unter filterConfig eintragen.
  6. Das Ausgabeverzeichnis unter outputDirectory festlegen.

Diagnoseaufruf#

python3 bin/create-work-package.py --config config/work-package.json

Die Runtime-Orchestrierung delegiert an engineering-tools. NS_GAP_WORK_PACKAGE_TOOL darf den Werkzeugpfad lokal überschreiben.

Ergebnis#

Das Ergebnis ist eine deterministische Zwei-Archiv-Arbeitspaketausgabe mit:

Die versionierte Regel aus Engineering Tools entfernt generierte Runtime- und Engineering-Tools-Inhalte ausschließlich aus den temporären Uploadkopien: unter anderem runtime/reports/**, runtime/web/**, Runtime-Umgebungen und gleichnamige rekursive Repository-Wurzeln. Die lokalen Originale bleiben unverändert; die Filter gelten für sources.zip und targets.zip. package-manifest.json protokolliert Regelversion, Begründung, wirksame Muster und ausgeschlossene Pfade.

package-manifest.json protokolliert außerdem Repositoryrollen, Identitäten und Allowed Target Scope. SHA256SUMS.txt deckt beide Containerarchive, alle enthaltenen Repository- und GAP-Archive sowie die Steuerdateien ab.

outputDirectory muss vor dem Lauf fehlen. Die kanonische Implementierung erzeugt und validiert das Paket in einem benachbarten Staging-Verzeichnis und veröffentlicht es anschließend durch atomisches Umbenennen. Ein vorhandenes Ziel wird nicht überschrieben; bei Fehlern bleibt kein Teilpaket zurück.

Validierung#

python3 ~/engineering/engineering-tools/60-packaging/gap_work_package.py validate \
                  outbox/gap-work-package

Beziehungen#