feat: govern task-local quick actions

src/govoplan_quick_access/backend/manifest.py

@@ -121,9 +121,11 @@ DOCUMENTATION = (
             "Messages combines enabled Mail, Postbox, and future chat contributions in one overlay. "
             "Personal settings can reorder or hide items that remain available under system, tenant, "
             "permission, and View policy. Every item retains a link to its complete owning page. "
-            "That launch carries a versioned, bounded reference to the current object, acting assignment, "
-            "temporal selection, View revision, and return location. The destination rechecks access, and "
-            "the breadcrumb return action restores the originating route without copying protected content."
+            "Launch-context version 2 carries only versioned, bounded references to the current object, acting assignment, "
+            "temporal selection, exact View revision, and return location. Owner modules recheck access when a tool opens and "
+            "before each effect. A tool returns either an explicit version-1 completion with a typed owner reference or an "
+            "explicit cancellation; closing the drawer does not imply success. The overlay preserves unsaved host-page work, "
+            "and the complete owning page remains the fallback for work that exceeds the compact surface."
         ),
         layer="configured",
         documentation_types=("user",),
@@ -143,8 +145,11 @@ DOCUMENTATION = (
                     "Eine Kategorie in der rechten Leiste oeffnet kompakte Werkzeuge, ohne die aktuelle Aufgabe zu verlassen. "
                     "Nachrichten fuehrt Beitraege aus Mail, Postfach und kuenftigen Chat-Modulen in einer Einblendung zusammen. "
                     "Persoenliche Einstellungen koennen alle durch System, Mandant, Berechtigungen und Ansicht zugelassenen Eintraege ordnen oder ausblenden. "
-                    "Beim Oeffnen der vollstaendigen Seite werden nur versionierte, begrenzte Verweise auf Objekt, handelnde Zuordnung, "
-                    "Zeitbezug, Ansichtsversion und Ruecksprungort uebergeben. Das Ziel prueft den Zugriff erneut."
+                    "Startkontext Version 2 uebergibt nur versionierte, begrenzte Verweise auf Objekt, handelnde Zuordnung, "
+                    "Zeitbezug, genaue Ansichtsversion und Ruecksprungort. Das besitzende Modul prueft den Zugriff beim Oeffnen "
+                    "und vor jeder Wirkung erneut. Ein Werkzeug meldet entweder einen ausdruecklichen Abschluss mit typisiertem "
+                    "Besitzerverweis oder einen ausdruecklichen Abbruch; das Schliessen gilt nicht als Erfolg. Die Einblendung "
+                    "erhaelt ungespeicherte Arbeit auf der Ausgangsseite, die vollstaendige Besitzerseite bleibt das Ausweichziel."
                 ),
             }
         },
@@ -164,7 +169,10 @@ DOCUMENTATION = (
             "The catalogue follows installed module registrations. System settings constrain tenants; "
             "tenant settings constrain users. An item may remain available, be blocked, or be forced. "
             "Views and permissions form additional ceilings and Quick Access never grants access to domain data. "
-            "Launch context version 1 rejects cross-tenant active-object references and unknown context versions fail closed."
+            "A View may recommend tools or focus the rail to a subset, but only currently enabled, context-compatible, authorized "
+            "tools participate. Workflow receives that same presentation from the exact resolved View revision. Launch-context "
+            "version 2, reference contract version 1, and result contract version 1 fail closed on unknown versions; cross-tenant "
+            "active-object and result references are rejected."
         ),
         layer="configured",
         documentation_types=("admin",),
@@ -177,7 +185,10 @@ DOCUMENTATION = (
                     "Der Katalog folgt den Registrierungen installierter Module. Systemeinstellungen begrenzen Mandanten, "
                     "Mandanteneinstellungen begrenzen Benutzer. Ein Eintrag kann verfuegbar, gesperrt oder erzwungen sein. "
                     "Ansichten und Berechtigungen bilden weitere Grenzen; Schnellzugriff erteilt selbst keinen Datenzugriff. "
-                    "Startkontext Version 1 verwirft mandantenfremde Objektverweise; unbekannte Versionen werden abgelehnt."
+                    "Eine Ansicht darf Werkzeuge empfehlen oder die Leiste auf eine Teilmenge fokussieren, jedoch nur innerhalb "
+                    "der aktivierten, kontextgeeigneten und berechtigten Werkzeuge. Workflow verwendet dieselbe Darstellung aus "
+                    "der genau aufgeloesten Ansichtsversion. Startkontext Version 2 sowie Verweis- und Ergebniskontrakt Version 1 "
+                    "lehnen unbekannte Versionen ab; mandantenfremde Objekt- und Ergebnisverweise werden verworfen."
                 ),
             }
         },