feat: Divi hints point to the read tools; guides divi-structure/attrs/design-system; test: Divi read end-to-end

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7

docs/guides/content-types.md

@@ -23,8 +23,8 @@ Werkzeugnamen: `lit-…` sind direkt aufrufbare Tools; `lit/…` sind Abilities,
   Trefferliste. Geliefert werden nur Einträge, die der verbundene Nutzer selbst bearbeiten darf (fremde
   Entwürfe/private Inhalte ohne die passende Berechtigung erscheinen nicht).
 - `lit-content-get`: alle Daten eines Eintrags inkl. Feldern, Begriffen, Beitragsbild und `rev`.
-  Bei Divi-Seiten fehlt `content`; Divi-Werkzeuge folgen in einer späteren Version, bis dahin werden
-  Divi-Inhalte im Divi-Builder bearbeitet (Titel, Auszug, Felder und Begriffe gehen weiter über
+  Bei Divi-Seiten fehlt `content`; den Aufbau liest `lit-divi-outline` (siehe `divi-structure`), geändert
+  wird er vorerst im Divi-Builder (Titel, Auszug, Felder und Begriffe gehen weiter über
   `lit-content-update`).
 
 ## Anlegen und Ändern
@@ -59,7 +59,8 @@ Werkzeugnamen: `lit-…` sind direkt aufrufbare Tools; `lit/…` sind Abilities,
 ## Sicher überarbeiten
 
 1. `lit/post-duplicate` → Entwurfskopie; die Antwort enthält die `rev` der Kopie für `lit-content-update`.
-2. Kopie mit `lit-content-update` (Divi-Inhalte bis zu den Divi-Werkzeugen im Divi-Builder) bearbeiten und dem Nutzer die Vorschau zeigen.
+2. Kopie mit `lit-content-update` (Divi-Inhalte vorerst im Divi-Builder) bearbeiten und dem Nutzer die
+   Vorschau zeigen; `lit-page-render-summary` fasst den gerenderten Inhalt zusammen.
 3. `lit/post-replace-with-copy` übernimmt die Kopie ins Original (ID, URL, Status und Menüeinträge bleiben).
    Voraussetzungen: die Kopie muss noch Entwurf oder ausstehend sein, `rev` des Originals aus
    `lit-content-get` ist Pflicht (sie deckt Titel, Inhalt, Auszug und Status ab – Felder/Meta, die direkt am

docs/guides/divi-attrs.md

@@ -0,0 +1,32 @@
+# Divi-Einstellungen (Vollform)
+
+Jedes Divi-5-Modul speichert seine Einstellungen unter **Attributpfaden**, z. B.
+
+- `title.innerContent` – Text der Überschrift,
+- `title.decoration.font.font` – Schrift der Überschrift (Farbe, Größe, Ebene `headingLevel`),
+- `button.innerContent` – Beschriftung und Link eines Buttons (`text`, `linkUrl`, `linkTarget`),
+- `module.decoration.background` – Hintergrund, `module.decoration.spacing` – Innen-/Außenabstand,
+- `module.meta.adminLabel` – Admin-Label im Divi-Builder.
+
+Der Wert eines Pfads ist eine Zuordnung **Breakpoint → Zustand → Wert**:
+
+```json
+{ "desktop": { "value": { "color": "#1a1a1a", "headingLevel": "h2" }, "hover": { "color": "#000000" } },
+  "phone":   { "value": { "size": "28px" } } }
+```
+
+Breakpoints: `desktop`, `tablet`, `phone` (je nach Website auch `tabletWide`, `phoneWide`, `widescreen`,
+`ultraWide`); Zustände: `value`, `hover`, `sticky`.
+
+## Pfade finden
+
+- `lit-divi-catalog` mit `module` (z. B. `"heading"`) listet alle gültigen Pfade dieses Moduls auf dieser
+  Website (live aus Divi) und die Kurzform-Felder mit ihrem Pfad. `path_kinds` nennt die Feldart eines Pfads
+  (`text`, `richtext`, `code`, `url`, `image`, `color`, `enum`, `onoff`, `number`, `list`, `icon`), soweit aus
+  den Divi-Metadaten ableitbar; zusammengesetzte Pfade (mehrere mögliche Feldarten je nach Unterschlüssel)
+  gelten als unbekannt, statt eine Feldart zu raten.
+- `lit-divi-node-get` zeigt die gesetzten Werte eines vorhandenen Knotens in genau dieser Form (`attrs`).
+- Schrift-Gruppen liegen eine Ebene tiefer: `…decoration.font.font`, `…decoration.bodyFont.body.font`,
+  `…decoration.headingFont.h2.font`, `module.advanced.text.text`.
+- Werte wie `$variable({…})$` sind Verweise auf globale Farben, Variablen oder dynamische Inhalte – nicht
+  durch feste Werte ersetzen (siehe `divi-design-system`).

docs/guides/divi-design-system.md

@@ -0,0 +1,20 @@
+# Divi-Designsystem
+
+`lit-divi-design-system` liest das Designsystem der Website live aus Divi:
+
+- **Globale Farben** (`colors`): ID (`gcid-…`), Name, Wert und der Platzhalter für neue Inhalte, z. B.
+  `{{color:primary}}` für die Primärfarbe oder `{{color:Nachtblau}}` für eine eigene globale Farbe. Die fünf
+  Theme-Farben heißen `primary`, `secondary`, `heading`, `body` und `link`.
+- **Globale Variablen** (`variables`): Zahlen, Texte, Bilder, Links (`gvid-…`), Platzhalter `{{var:<Name>}}`.
+- **Theme-Schriften** (`fonts`): Überschrift und Fließtext, Platzhalter `{{font:heading}}` / `{{font:body}}`.
+- **Größen** (`sizes`): Schriftgrößen, Inhaltsbreite und Spaltenabstand aus den Theme-Optionen.
+- **Presets** (`presets`): Modul-Presets je Modul (`kind: module`, z. B. alle Button-Presets) und
+  Gruppen-Presets (`kind: group`); `default: true` markiert das Standard-Preset eines Moduls.
+
+Regeln:
+
+1. Vor dem Gestalten einer Seite das Designsystem lesen.
+2. Globale Farben, Variablen und Presets vor festen Werten verwenden; feste Farben oder Schriften nur, wenn
+   der Nutzer es ausdrücklich möchte.
+3. Gibt es für einen Zweck noch keine Farbe, Variable oder kein Preset, dem Nutzer vorschlagen, es im
+   Divi-Builder anzulegen, statt feste Werte zu verteilen.

docs/guides/divi-structure.md

@@ -0,0 +1,37 @@
+# Divi-Seiten: Aufbau lesen
+
+Divi 5 speichert eine Seite als Block-Markup: Abschnitte (`section`) enthalten Zeilen (`row`), Zeilen
+Spalten (`column`), Spalten Module (`text`, `heading`, `button`, …). Manche Module haben Kind-Module
+(`accordion` → `accordion-item`). Die Divi-Werkzeuge gibt es nur, wenn der Divi-5-Builder aktiv ist.
+
+## Seitenbaum
+
+- `lit-divi-outline` mit `post_id` liefert jeden Knoten mit **Pfad-ID**, Modultyp, Admin-Label, Textauszug,
+  Layout-Info (z. B. `Spalten 8_24+16_24`) und Preset-Namen – als kompakten Text (`outline`) und als Liste
+  (`nodes`). Mit `id` nur ein Teilbaum, mit `depth` begrenzte Tiefe.
+- Pfad-IDs: `s0` = erster Abschnitt, `s0.r1` = zweite Zeile darin, `s0.r1.c0` = erste Spalte,
+  `s0.r1.c0.m2` = drittes Modul, `…m2.m0` = erstes Kind-Modul. `g` = globales Modul, `x` = fremder Block
+  (z. B. aus dem Block-Editor). Gezählt wird je Buchstabe innerhalb des Elternknotens.
+- `lit-divi-node-get` mit `post_id` und `id` liefert alle Einstellungen eines Knotens (siehe `divi-attrs`),
+  die aktuellen Kurzform-Werte (`shortform`) und die IDs der Kinder.
+
+## Stand und Sperre
+
+- `tree_rev` ist der Stand des Seiteninhalts. Pfad-IDs gelten nur für diesen Stand – ändert jemand die Seite
+  (auch im Divi-Builder), verschieben sich die IDs. Divi-Änderungen verlangen deshalb immer die `tree_rev`
+  des letzten Lesevorgangs.
+- `rev` ist davon getrennt: der Stand des ganzen Eintrags (Titel, Auszug, Status …) für `lit-content-update`.
+
+## Was nicht bearbeitet wird
+
+- Knoten mit „nur lesbar“ (globale Module `g…`, fremde Blöcke `x…`) ändern die Divi-Werkzeuge nicht.
+- Divi-4-Inhalt (Shortcodes `[et_pb_…]`) wird nicht gelesen oder geändert: Seite einmal im Divi-Builder
+  öffnen und speichern, Divi 5 wandelt sie dabei um.
+- Ist das Markup beschädigt, lehnen die Werkzeuge ab (`unsupported`); die Seite im Divi-Builder öffnen und
+  speichern.
+
+## Ergebnis prüfen
+
+`lit-page-render-summary` rendert den Inhaltsbereich wie im Frontend und listet Überschriften, Texte, Links
+und Bilder samt Warnungen (Sprünge in der Überschriftenhierarchie, fehlende Alt-Texte, Links ohne Ziel).
+Header, Footer und Theme-Builder-Vorlagen sind nicht enthalten.

docs/guides/overview.md

@@ -33,7 +33,10 @@ Status (`lit/post-unpublish`, `lit/post-schedule`, `lit/post-trash`), Kopien (`l
 Einstellungen (`lit/wp-settings-get`, `lit/wp-settings-update`), Medien (`lit/media-get`, `lit/media-upload`,
 `lit/media-update`, `lit/media-delete`).
 
-Weitere Themen: `lit-guide` mit `topic` = `content-types`, `workflows` oder `media`.
+Die `lit-divi-…`-Werkzeuge gibt es nur, wenn der Divi-5-Builder aktiv ist.
+
+Weitere Themen: `lit-guide` mit `topic` = `content-types`, `workflows`, `media`, `divi-structure`,
+`divi-attrs` oder `divi-design-system`.
 
 ## Rückmeldungen