feat: lit/page-render-summary – rendered content as structured excerpt

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7
2026-09-26 12:21:23 +02:00
parent d27504a750
commit 2e9acd686a
8 changed files with 412 additions and 3 deletions
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LIT\MCP\Integrations\WordPress\Render;
+
+use LIT\MCP\Abilities\Ability;
+use LIT\MCP\Integrations\WordPress\PostGuard;
+use LIT\MCP\Integrations\WordPress\Schema\ContentSchema;
+use WP_Error;
+
+/**
+ * lit/page-render-summary: what a visitor sees in the content area – headings, texts, links,
+ * images with alt text and obvious problems (spec §5.7, §8.1). Works for every managed entry,
+ * Divi or not; the content is rendered in-process, header/footer/Theme Builder are not included.
+ */
+final class PageRenderSummaryAbility implements Ability
+{
+    public function __construct(private ContentSchema $schema, private PageRenderer $renderer)
+    {
+    }
+
+    public function name(): string
+    {
+        return 'lit/page-render-summary';
+    }
+
+    public function label(): string
+    {
+        return 'Gerenderte Seite (Auszug)';
+    }
+
+    public function description(): string
+    {
+        return 'Rendert den Inhaltsbereich eines Eintrags wie im Frontend und liefert einen strukturierten Auszug: '
+            . 'Überschriften, Texte, Links, Bilder mit Alt-Text und Warnungen (Hierarchie-Sprünge, fehlende '
+            . 'Alt-Texte). Header, Footer und Theme-Builder-Vorlagen sind nicht enthalten. Gut zum Prüfen nach '
+            . 'Änderungen.';
+    }
+
+    public function inputSchema(): array
+    {
+        return [
+            'type' => 'object',
+            'properties' => ['post_id' => ['type' => 'integer', 'minimum' => 1]],
+            'required' => ['post_id'],
+            'additionalProperties' => false,
+        ];
+    }
+
+    public function outputSchema(): ?array
+    {
+        return [
+            'type' => 'object',
+            'properties' => [
+                'post_id' => ['type' => 'integer'],
+                'url' => ['type' => 'string'],
+                'headings' => ['type' => 'array', 'items' => ['type' => 'object']],
+                'texts' => ['type' => 'array', 'items' => ['type' => 'string']],
+                'links' => ['type' => 'array', 'items' => ['type' => 'object']],
+                'images' => ['type' => 'array', 'items' => ['type' => 'object']],
+                'warnings' => ['type' => 'array', 'items' => ['type' => 'string']],
+                'notes' => ['type' => 'array', 'items' => ['type' => 'string']],
+            ],
+            'required' => ['post_id', 'headings', 'texts', 'links', 'images', 'warnings', 'notes'],
+        ];
+    }
+
+    public function annotations(): array
+    {
+        return ['readonly' => true, 'destructive' => false, 'idempotent' => true];
+    }
+
+    public function isDirect(): bool
+    {
+        return true;
+    }
+
+    public function permission(array $input): bool|WP_Error
+    {
+        $post = PostGuard::editable($input['post_id'] ?? null, $this->schema, 'post_id', true);
+
+        return $post instanceof WP_Error ? $post : true;
+    }
+
+    public function execute(array $input): mixed
+    {
+        $post = PostGuard::editable($input['post_id'] ?? null, $this->schema, 'post_id', true);
+        if ($post instanceof WP_Error) {
+            return $post;
+        }
+
+        $notes = ['Nur der Inhaltsbereich; Header, Footer und Theme-Builder-Vorlagen fehlen.'];
+        if ((string) $post->post_password !== '') {
+            $notes[] = 'Der Eintrag ist passwortgeschützt; Besucher sehen zuerst das Passwortformular.';
+        }
+
+        return array_merge(
+            ['post_id' => (int) $post->ID, 'url' => (string) get_permalink($post)],
+            RenderSummary::fromHtml($this->renderer->render($post)),
+            ['notes' => $notes]
+        );
+    }
+}