vendoo/docs/engineering/ux-slice-19-ci-diagnostics.md

Vendoo 1.44.0 – Slice 19 CI-Diagnosevertrag

Zweck

Der vollständige Vendoo-Releasevertrag prüft das Release-Manifest bewusst sehr früh. Solange das Manifest nicht auf den aktuellen Branch-Head synchronisiert ist, können nachgelagerte UX-Gates in diesem Workflow nicht eindeutig ausgewertet werden.

Slice 19 führt deshalb einen unabhängigen, minimalen Plattformvertrag ein. Dieser ersetzt den vollständigen Releasevertrag nicht, sondern trennt den fachlichen Zustand von Navigation API und Safe Action Adapters vom Paket- und Manifestzustand.

Workflow

Datei:

.github/workflows/ux-platform-contract.yml

Matrix:

• ubuntu-latest
• windows-latest

Unabhängigkeit

Der Workflow verwendet bewusst:

• keine actions/checkout-Action
• keine actions/setup-node-Action
• kein npm ci
• keinen Dependency-Cache
• keine Drittanbieter-Action

Der exakte Workflow-Commit wird ausschließlich mit dem auf dem GitHub-Runner vorhandenen git ausgecheckt:

git init .
git remote add origin <Repository-URL>
git fetch --depth=1 origin <GITHUB_SHA>
git checkout --detach FETCH_HEAD

Damit hängen die beiden UX-Gates weder von NPM-Abhängigkeiten noch von Marketplace-Actions ab.

Ausgeführte Gates

Der Runner tools/run-ux-platform-gates.mjs startet mit dem vorhandenen Node-Prozess:

1. tools/verify-navigation-api-1.44.0.mjs
2. tools/verify-safe-action-adapters-1.44.0.mjs

Beide Verifier verwenden ausschließlich Node-Coremodule.

Diagnoseausgabe

Der Runner protokolliert:

• Betriebssystem
• Node-Version
• Architektur
• geprüften Commit
• Standardausgabe jedes Gates
• Fehlerausgabe jedes Gates
• Exitcode jedes Gates
• Gesamtergebnis

Die Ausgabe wird zusätzlich unter folgendem Pfad erzeugt:

artifacts/ux-platform-gates.log

Der abschließende Workflow-Step gibt vorhandene Diagnoseprotokolle unabhängig vom Gate-Ergebnis erneut in das Jobprotokoll aus.

Abgrenzung

Ein grüner UX-Plattformvertrag bestätigt ausschließlich:

• öffentliche Navigation API
• Navigation-Lifecycle
• Workspace-Grenzen
• 21 Safe Action Adapters
• bestehende Handlerdelegation
• Linux-/Windows-Kompatibilität dieser Verifier

Er bestätigt nicht automatisch:

• synchrones Release-Manifest
• vollständigen Windows-Releasevertrag
• Docker-Build
• Updater-Paket
• Deployment- oder Releasefreigabe

Releasegrenzen

• kein Merge
• kein Deployment
• kein Release
• keine Abschwächung des vollständigen Releasevertrags