WP-LIT-MCP/docs/superpowers/notes/2026-09-27-etappe-3b-abnahme.md

Etappe 3b – Manuelle Abnahme (Theme Builder, ähnliche Abschnitte, globale Module umwandeln)

Automatisch geprüft sind bereits:

• alle Unit-Tests (composer test) und Lint (composer lint);
• tb-smoke.sh (neu) und die sechs bisherigen Integrationsskripte divi-library-smoke.sh, divi-write-smoke.sh, divi-read-smoke.sh, mcp-smoke.sh, wp-basis-smoke.sh und media-admin-smoke.sh (alle in tests/Integration/).

tb-smoke.sh prüft über den OAuth-Endpunkt, nur mit temporären Daten, die es danach wieder löscht. Die einzige Vorlage, die es aktiviert, gilt nur für eine temporäre Entwurfsseite; Besucher sehen davon nichts. Geprüft werden:

• Werkzeugliste: weiterhin 22 direkte Tools; lit/tb-list, lit/tb-create-template, lit/tb-assign, lit/tb-activate, lit/library-find-similar und lit/library-make-global indirekt und erreichbar; lit-site-status ohne Befund bei Divi;
• neue Vorlage: deaktiviert, in der Liste des Theme Builders, Inhalt-Layout über Divis eigene Funktionen mit dem Inhalt des Plugins, wird nicht angezeigt; die Divi-Werkzeuge ändern das Layout einer deaktivierten Vorlage sofort, „Inhalt posten“ (post-content) ist im Inhalt-Layout erlaubt;
• lit/tb-assign: bei einer deaktivierten Vorlage sofort gespeichert, fehlendes exclude_from lässt die Ausnahmen stehen, [] entfernt sie, eine veraltete template_rev wird abgelehnt;
• lit/tb-activate: erst Probelauf, dann Aktivieren; die Entwurfsseite zeigt die Vorlage in der Vorschau, die Startseite und Besucher sehen nichts; Änderungen am Layout (auch Löschen) und an den Bedingungen einer aktiven Vorlage erst nach Probelauf; Deaktivieren; die Standardvorlage wird abgelehnt;
• ein ungespeicherter Entwurf im Theme Builder sperrt Anlegen, Zuordnen und Aktivieren; Deaktivieren geht trotzdem, mit Warnung;
• eine Vorlage, die ein veraltetes Theme-Builder-Fenster aus der Liste entfernt hat: erscheint unter detached, Aktivieren und Zuordnen ohne reattach werden abgelehnt, mit reattach: true ist sie wieder in der Liste, deaktiviert und ohne „ungenutzt“-Markierung;
• ein Redakteur ohne Theme-Builder-Recht: lit/tb-list und Anlegen abgelehnt, Vorlagen und Layouts gelten als nicht vorhanden; Gruppe „Divi Theme Builder“ auf „nur lesen“ bzw. deaktiviert wirkt auch auf die Divi-Werkzeuge;
• Pods, mit einem eigenen temporären Pod: Divi bietet die Bedingung „Alle …“ für den neuen Inhaltstyp an; im Inhalt-Layout erzeugt das Beziehungsfeld eine Warnung, das Auswahlfeld einen Hinweis, das Textfeld nichts;
• lit/library-find-similar (gleich und nur gleich aufgebaut) und lit/library-make-global (Umwandeln, dann Ersetzen nach Probelauf; ein nur ähnlicher Abschnitt wird nicht ersetzt);
• P13 (keine Bibliotheks-IDs ohne Bibliothekszugang) und P10 (post_link_url_page nicht auf Beiträge);
• am Ende: Liste des Theme Builders und Aktiv-Zustand jeder Vorlage wie vorher, Optionen wiederhergestellt, keine Beiträge, Metadaten, Begriffe, Protokollzeilen, Pods, Konten oder Rollen des Laufs übrig.

Die folgenden Punkte brauchen den echten Theme Builder bzw. Visual Builder und einen verbundenen KI-Assistenten. Abweichungen als kurze Notiz zurückmelden; sie werden Folgeaufgaben.

Wichtig: Eine aktive Vorlage ändert sofort, was Besucher sehen. Für die Abnahme Vorlagen nur für Entwurfsseiten oder für die „[Fixture] Personen“ aktivieren und im selben Schritt wieder deaktivieren. Die „[Fixture]“- und „[Test]“-Inhalte nicht ändern.

Vorbereitung

• DDEV läuft, Divi 5.2.1 ist aktiv, Pods ist aktiv, LIT MCP zeigt Version 0.5.0 (Plugins-Seite).
• Divi → Theme Builder öffnen und den Stand notieren: welche Vorlagen es gibt und welche aktiv sind (Schalter in der Vorlage). Ist dort etwas ungespeichert, speichern oder verwerfen. Danach das Fenster schließen – ein offenes Theme-Builder-Fenster kann beim späteren Speichern Vorlagen des Plugins wieder entfernen.
• Unter Einstellungen → LIT MCP → Tools stehen die Gruppen „Divi“, „Divi-Bibliothek“ und „Divi Theme Builder“ auf ihrem Standard (nicht „nur lesen“, nicht deaktiviert); in der Gruppe „Divi Theme Builder“ stehen lit/tb-list, lit/tb-create-template, lit/tb-assign und lit/tb-activate.
• Nach einem Lauf von tb-smoke.sh ist nichts übrig: unter Seiten, Divi → Divi-Bibliothek und Divi → Theme Builder nach „LIT Smoke“ suchen – keine Treffer; unter Pods Admin → Pods verwalten kein Pod „lit_smk_…“.
• Den KI-Assistenten neu verbinden, damit er die neuen Tools und Hinweise lädt. In einer neuen Unterhaltung nennt der Hinweis des Servers den Theme Builder.
• Eine Entwurfsseite „Abnahme 3b – Vorlage“ anlegen (nicht veröffentlichen). Sie ist das Ziel der Seiten-Vorlage unten.

1. Vom Plugin angelegte Vorlage im Theme Builder und Visual Builder

• Den KI-Assistenten bitten: „Lege im Theme Builder eine Vorlage ‚Abnahme 3b – Seite‘ für die Seite ‚Abnahme 3b – Vorlage‘ an: globale Kopfzeile, im Inhalt eine Überschrift mit dem Seitentitel, ein Text und der Seiteninhalt, Fußzeile ausgeblendet.“ Erwartet: er nimmt lit/tb-create-template und sagt, dass die Vorlage deaktiviert ist und erst mit lit/tb-activate wirkt.
• Divi → Theme Builder öffnen: die Vorlage steht in der Liste, deaktiviert, Bedingung „Seiten: Abnahme 3b – Vorlage“ (bzw. die Seiten-ID), Kopfzeile = globale Kopfzeile, Fußzeile ausgeblendet.
• Das Inhalt-Layout im Visual Builder öffnen: Überschrift mit dynamischem Inhalt „Titel“, Text und das Modul „Inhalt posten“ sind vorhanden und bearbeitbar; der Builder meldet keine Fehler. Ohne Speichern schließen.
• Im Theme Builder eine harmlose Änderung an einer anderen, deaktivierten Vorlage machen (z. B. Titel) und „Änderungen speichern“: die neue Vorlage bleibt in der Liste. Die Änderung danach zurücknehmen.
• Den Assistenten bitten, die Vorlage aufzulisten: lit/tb-list zeigt sie deaktiviert, mit Layout-IDs und template_rev.

2. Aktivieren mit Probelauf

• Den Assistenten bitten, die Vorlage zu aktivieren. Erwartet: er zeigt zuerst den Probelauf (Bedingungen, Layouts, Überschneidungen mit anderen aktiven Vorlagen) und fragt nach, bevor er etwas speichert.
• Nach der Nachfrage ablehnen: im Theme Builder ist die Vorlage weiter deaktiviert.
• Erneut bitten und zustimmen: im Theme Builder ist sie aktiv. Die Vorschau der Entwurfsseite zeigt die Vorlage (Überschrift mit dem Seitentitel, Text, Seiteninhalt, keine Fußzeile). Die Startseite und andere Seiten sehen aus wie vorher.
• Den Assistenten bitten, im Inhalt-Layout den Text zu ändern: er meldet, dass die Vorlage aktiv ist, zeigt den Probelauf und fragt nach. Nach Zustimmung zeigt die Vorschau den neuen Text; unter „Revisionen“ des Layouts steht der alte Stand.
• Den Assistenten bitten, die Bedingungen der aktiven Vorlage zu ändern (z. B. eine Ausnahme hinzufügen): Probelauf mit vorher/nachher, erst nach Zustimmung gespeichert.
• Den Assistenten bitten, die Vorlage wieder zu deaktivieren (Probelauf, Zustimmung): im Theme Builder ist sie deaktiviert, die Vorschau der Entwurfsseite zeigt wieder das normale Seitenlayout.
• Unter Einstellungen → LIT MCP → Protokoll stehen Anlegen, Aktivieren, Layout-Änderung, Bedingungen und Deaktivieren.

3. Bedingungen für einen Pods-Inhaltstyp

• Den KI-Assistenten bitten: „Lege eine Vorlage für alle [Fixture] Personen an: globale Kopfzeile, im Inhalt Name, Funktion, Stufe und Mentor, Fußzeile wie bisher.“ Erwartet: er liest vorher die Felder (lit/divi-dynamic-sources für lit_fixture_person), legt die Vorlage deaktiviert an und weist darauf hin, dass Divi beim Mentor nur die ID zeigt und bei der Stufe den gespeicherten Wert statt der Beschriftung.
• Divi → Theme Builder: die Vorlage hat die Bedingung „Alle [Fixture] Personen“ und ist deaktiviert.
• Das Inhalt-Layout im Visual Builder öffnen: die Module zeigen dynamischen Inhalt „Benutzerdefiniertes Feld“ mit „role“, „level“ und „mentor“ und lassen sich im Dialog bearbeiten. Ohne Speichern schließen.
• Den Assistenten bitten, die Bedingung auf genau eine Person zu ändern (Erika Muster), dann zu aktivieren (Probelauf, Zustimmung): die Seite dieser Person zeigt Name und Funktion („Geschäftsführung“), die Stufe als „senior“; die Seite von Max Beispiel sieht aus wie vorher. Danach sofort wieder deaktivieren lassen.

4. Ähnliche Abschnitte zu globalen Modulen machen

• Zwei Entwurfsseiten „Abnahme 3b – A“ und „Abnahme 3b – B“ mit demselben Abschnitt bauen (im Visual Builder den Abschnitt von A kopieren und in B einfügen), dazu eine Seite „Abnahme 3b – C“ mit demselben Abschnitt, aber einem geänderten Text.
• Den Assistenten bitten, wiederkehrende Abschnitte zu finden und zu globalen Modulen zu machen. Erwartet: lit/library-find-similar nennt B als gleich und C als nur gleich aufgebaut; er schlägt vor, den Abschnitt von A umzuwandeln, und fragt nach.
• Nach Zustimmung: lit/library-make-global legt einen globalen Eintrag an und setzt ihn auf Seite A als Instanz ein; für Seite B zeigt er zuerst den Probelauf und ersetzt erst nach Zustimmung. Seite C bleibt unverändert.
• Divi → Divi-Bibliothek: der Eintrag ist ein globaler Abschnitt.
• Seiten A und B im Visual Builder öffnen: der Abschnitt ist als globales Modul gekennzeichnet; eine Änderung daran im Builder erscheint nach dem Speichern auf beiden Seiten. Unter „Revisionen“ von B steht der Stand vor dem Ersetzen.
• Den Assistenten bitten, in eine andere Entwurfsseite einen neuen Abschnitt einzufügen, der wie der Bibliotheksabschnitt aufgebaut ist: die Antwort weist auf den Bibliothekseintrag hin.

5. Rechte

• Optional mit einem Redakteurs-Konto (Rolle unter Einstellungen → LIT MCP → Zugriff freigeben, den Assistenten in einem privaten Browserfenster mit diesem Konto verbinden): der Assistent sieht keine Vorlagen und erklärt, dass die Berechtigung für den Theme Builder fehlt. Danach die Freigabe zurücknehmen und wieder als Administrator verbinden.
• Gruppe „Divi Theme Builder“ auf „nur lesen“: lit/tb-list geht, Anlegen und Aktivieren fehlen, Änderungen an Theme-Builder-Layouts mit den Divi-Werkzeugen werden abgelehnt. Danach auf den Standard zurückstellen.

Aufräumen

• Divi → Theme Builder: die Vorlagen „Abnahme 3b …“ und die Personen-Vorlage löschen und „Änderungen speichern“. Danach dieselben Vorlagen aktiv wie in der Vorbereitung notiert.
• Die Seiten „Abnahme 3b …“ und den globalen Eintrag in der Divi-Bibliothek löschen (auch aus dem Papierkorb).
• Optional: die Einträge der Abnahme im Protokoll-Tab über „Protokoll leeren“ entfernen.
• Ob Pods wieder deaktiviert werden soll, entscheidet der Benutzer; die Fixture-Daten („[Fixture] Personen“) bleiben stehen, bis ihr Aufräumen laut tests/Fixtures/divi/stage3b/README.md gewünscht ist.