From de1982c0dc5a88b8ac44b952f747786b1b5fa168 Mon Sep 17 00:00:00 2001
From: Masterluke77 <163446896+Masterluke77@users.noreply.github.com>
Date: Tue, 14 Jul 2026 14:40:48 +0200
Subject: [PATCH] docs(actions): document complete safe workspace action
 expansion

---
 .../ux-slice-19-safe-action-expansion.md      | 118 ++++++++++++++++++
 1 file changed, 118 insertions(+)
 create mode 100644 docs/engineering/ux-slice-19-safe-action-expansion.md

diff --git a/docs/engineering/ux-slice-19-safe-action-expansion.md b/docs/engineering/ux-slice-19-safe-action-expansion.md
new file mode 100644
index 0000000..9714a0a
--- /dev/null
+++ b/docs/engineering/ux-slice-19-safe-action-expansion.md
@@ -0,0 +1,118 @@
+# Vendoo 1.44.0 – UX Slice 19: Safe Action Expansion
+
+## Referenz
+
+- Branch: `release/1.44.0-ux-foundation-production-update-v1`
+- Ausgangs-Head: `dd9596ef857b20c63a8773837a8853d7a657e4a9`
+- App-Ziel: Vendoo `1.44.0`
+- Updater: `3.4.0`
+
+## Ziel
+
+Slice 19 vervollständigt die erste sichere Action-Migrationsstufe. Die neun Adapter aus Slice 18 bleiben unverändert verfügbar und werden um zwölf ausschließlich darstellende oder filternde Actions ergänzt.
+
+Es entstehen keine neuen Fachaktionen. Jeder neue Eintrag delegiert weiterhin ausschließlich an einen bereits vorhandenen Vendoo-Button.
+
+## Vollständiger Action-Umfang
+
+Die Safe Action Adapter registrieren jetzt exakt 21 Actions.
+
+### Module
+
+- Module neu laden
+- alle Module anzeigen
+- aktive Module anzeigen
+- deaktivierte Module anzeigen
+- installierte externe Module anzeigen
+- Module mit Problemen anzeigen
+
+### Browser-Extensions
+
+- alle Extensions anzeigen
+- bereite Extensions anzeigen
+- verbundene Extensions anzeigen
+- Extensions mit Handlungsbedarf anzeigen
+
+### Artikel
+
+- aktuellen Artikel öffnen
+- Kartenansicht aktivieren
+- Listenansicht aktivieren
+- Artikelfilter zurücksetzen
+
+### Medien
+
+- aktuelles Bild groß öffnen
+- kompakte Galeriedichte aktivieren
+- normale Galeriedichte aktivieren
+- große Galeriedichte aktivieren
+- Rasteransicht aktivieren
+- Listenansicht aktivieren
+- Medienfilter zurücksetzen
+
+## Deklarativer Adapterkern
+
+Wiederkehrende Button-Delegationen werden jetzt über `buttonAction(...)` beschrieben. Der Helper erzeugt ausschließlich:
+
+- `enabled`, indem der vorhandene Zielbutton geprüft wird
+- `handler`, indem exakt dieser Zielbutton per `click()` ausgelöst wird
+
+Dadurch bleiben Action-Metadaten und technische Delegation zentral, einheitlich und leichter prüfbar. Artikel- und Medienkontextaktionen behalten ihre spezialisierten Handler.
+
+## Workspace-Grenzen
+
+Sichtbarkeit wird weiterhin gegen `window.VendooNavigation.currentView` und den zugehörigen DOM-Bereich geprüft:
+
+- Modulaktionen: `admin`
+- Extension-Aktionen: `extensions`
+- Artikelaktionen: `history`
+- Medienaktionen: `media-library`
+
+Actions eines inaktiven Arbeitsbereichs erscheinen nicht in der Command Palette.
+
+## Sicherheitsgrenzen
+
+Alle 21 Actions erfüllen denselben Vertrag:
+
+- ausschließlich `danger: none`
+- ausschließlich Surface `command-palette`
+- keine Veröffentlichung
+- keine Löschung
+- keine Installation oder Deinstallation
+- keine Aktivierung oder Deaktivierung eines Moduls
+- keine Status- oder Datenänderung
+- keine Speicherung
+- keine Datenbankänderung
+- keine Migration
+- kein eigener API-Aufruf
+- kein Polling
+- kein `window.confirm`
+- kein `innerHTML`
+
+## Abnahme-Gate
+
+Das vorhandene Gate `npm run verify:safe-action-adapters` wurde auf den vollständigen 21-Action-Vertrag erweitert.
+
+Es prüft jetzt zusätzlich:
+
+- exakt 21 eindeutige Action-IDs
+- zwölf neue Expansion-Actions
+- alle vier Workspace-Grenzen
+- Modulfilter für aktiv, deaktiviert und installiert
+- Extension-Filter für bereit, verbunden und Handlungsbedarf
+- Artikelfilter-Reset
+- kompakte und große Galeriedichte
+- Medien-Raster- und Listenansicht
+- Ready-Event mit
+  - `count: 21`
+  - `baselineCount: 9`
+  - `expansionCount: 12`
+
+## Releasegrenzen
+
+- keine bestehenden Handler ersetzt
+- keine bestehenden Routen, APIs, Feld-IDs oder Modul-IDs geändert
+- keine persistenten Nutzdaten verändert
+- kein Merge
+- kein Deployment
+- kein Release