feat: lit/divi-outline and lit/divi-node-get with tree_rev

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7
2026-09-26 12:14:38 +02:00
parent a54a337e0b
commit d27504a750
9 changed files with 677 additions and 1 deletions
@@ -0,0 +1,144 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LIT\MCP\Integrations\Divi\Pages;
+
+use LIT\MCP\Abilities\Ability;
+use LIT\MCP\Abilities\Errors;
+use LIT\MCP\Abilities\JsonMap;
+use LIT\MCP\Integrations\Divi\BlockTree\AttrMap;
+use LIT\MCP\Integrations\Divi\BlockTree\NodeIndex;
+use LIT\MCP\Integrations\Divi\BlockTree\NodeSummary;
+use LIT\MCP\Integrations\Divi\Design\DesignSystemReader;
+use LIT\MCP\Integrations\Divi\Schema\ShortformMap;
+use WP_Error;
+
+/**
+ * lit/divi-node-get: all attributes of one node in the full form (spec §5.4, §5.7) –
+ * attribute path => breakpoint map – plus the current short-form values.
+ */
+final class DiviNodeGetAbility implements Ability
+{
+    public function __construct(private DiviPageLoader $loader, private DesignSystemReader $design)
+    {
+    }
+
+    public function name(): string
+    {
+        return 'lit/divi-node-get';
+    }
+
+    public function label(): string
+    {
+        return 'Divi-Knoten lesen';
+    }
+
+    public function description(): string
+    {
+        return 'Liest einen Knoten der Divi-Seite vollständig: attrs als Attributpfad → Werte je Breakpoint '
+            . '(Vollform, z. B. "title.decoration.font.font": {"desktop": {"value": {…}}}), die Kurzform-Werte, '
+            . 'Presets und die IDs der Kinder. Pfad-IDs aus lit-divi-outline.';
+    }
+
+    public function inputSchema(): array
+    {
+        return [
+            'type' => 'object',
+            'properties' => [
+                'post_id' => ['type' => 'integer', 'minimum' => 1],
+                'id' => ['type' => 'string', 'description' => 'Pfad-ID aus lit-divi-outline, z. B. "s0.r0.c1.m2".'],
+            ],
+            'required' => ['post_id', 'id'],
+            'additionalProperties' => false,
+        ];
+    }
+
+    public function outputSchema(): ?array
+    {
+        return [
+            'type' => 'object',
+            'properties' => [
+                'post_id' => ['type' => 'integer'],
+                'tree_rev' => ['type' => 'string'],
+                'id' => ['type' => 'string'],
+                'parent' => ['type' => ['string', 'null']],
+                'type' => ['type' => 'string'],
+                'label' => ['type' => 'string'],
+                'editable' => ['type' => 'boolean'],
+                'attrs' => ['type' => 'object'],
+                'shortform' => ['type' => 'object'],
+                'presets' => [
+                    'type' => 'array',
+                    'items' => [
+                        'type' => 'object',
+                        'properties' => ['id' => ['type' => 'string'], 'name' => ['type' => 'string']],
+                        'required' => ['id', 'name'],
+                    ],
+                ],
+                'builder_version' => ['type' => ['string', 'null']],
+                'children' => ['type' => 'array', 'items' => ['type' => 'string']],
+            ],
+            'required' => ['post_id', 'tree_rev', 'id', 'type', 'editable', 'attrs', 'shortform', 'children'],
+        ];
+    }
+
+    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
+    {
+        $page = $this->loader->load($input['post_id'] ?? null, false);
+
+        return $page instanceof WP_Error ? $page : true;
+    }
+
+    public function execute(array $input): mixed
+    {
+        $page = $this->loader->load($input['post_id'] ?? null, false);
+        if ($page instanceof WP_Error) {
+            return $page;
+        }
+
+        $id = is_string($input['id'] ?? null) ? $input['id'] : '';
+        if (preg_match(NodeIndex::ID_PATTERN, $id) !== 1) {
+            return Errors::invalidInput('id ist keine Pfad-ID.', ['id' => 'z. B. "s0.r1.c0.m2"']);
+        }
+
+        $block = $page->index->find($id);
+        if ($block === null) {
+            return DiviPageLoader::unknownNode($id, $page->post);
+        }
+
+        $names = $this->design->read()->presetNames();
+        $editable = $block->isDivi() && ! $block->isOpaque();
+        $version = $block->attrs()['builderVersion'] ?? null;
+
+        return [
+            'post_id' => (int) $page->post->ID,
+            'tree_rev' => $page->treeRev(),
+            'id' => $id,
+            'parent' => $page->index->parentId($block),
+            'type' => $block->name(),
+            'label' => NodeSummary::label($block),
+            'editable' => $editable,
+            'attrs' => JsonMap::of(AttrMap::flatten($block->attrs())),
+            'shortform' => JsonMap::of(ShortformMap::values($block->shortName(), $block->attrs())),
+            'presets' => array_map(
+                static fn (string $presetId): array => ['id' => $presetId, 'name' => $names[$presetId] ?? ''],
+                NodeSummary::presetIds($block)
+            ),
+            'builder_version' => is_string($version) ? $version : null,
+            'children' => $editable
+                ? array_values(array_filter(array_map([$page->index, 'idOf'], $block->children())))
+                : [],
+        ];
+    }
+}