docs(ci): define isolated UX platform diagnostics contract

2026-07-14 14:50:21 +02:00
parent 31e4df8bfd
commit d71f868cb2
1 changed files with 97 additions and 0 deletions
@@ -0,0 +1,97 @@
+# 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:
+
+```text
+.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:
+
+```text
+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:
+
+```text
+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