feat: lit/divi-move, lit/divi-delete, lit/divi-duplicate-node

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

src/Integrations/Divi/Pages/DiviDeleteAbility.php

@@ -0,0 +1,145 @@
+<?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\ToolResult;
+use LIT\MCP\Integrations\Divi\BlockTree\Block;
+use LIT\MCP\Integrations\Divi\BlockTree\NodeSummary;
+use WP_Error;
+
+/**
+ * lit/divi-delete: removes nodes with everything inside (spec §5.7, destructive). Needs
+ * confirm: true after asking the user; without it the answer lists what would be removed –
+ * nodes inside another node that is deleted anyway do not count twice. The revision in the
+ * result allows undoing it (lit/revision-restore).
+ */
+final class DiviDeleteAbility implements Ability
+{
+    public function __construct(private DiviWriter $writer)
+    {
+    }
+
+    public function name(): string
+    {
+        return 'lit/divi-delete';
+    }
+
+    public function label(): string
+    {
+        return 'Divi-Knoten löschen';
+    }
+
+    public function description(): string
+    {
+        return 'Entfernt Divi-Knoten samt Inhalt. Erst nach Rückfrage beim Nutzer mit confirm: true; ohne confirm '
+            . 'nennt die Antwort, was entfernt würde. Rückgängig über die Revision in revision_id. tree_rev ist '
+            . 'Pflicht.';
+    }
+
+    public function inputSchema(): array
+    {
+        return [
+            'type' => 'object',
+            'properties' => array_merge(DiviWriter::inputProperties(), [
+                'ids' => [
+                    'type' => 'array',
+                    'minItems' => 1,
+                    'maxItems' => 20,
+                    'items' => ['type' => 'string'],
+                    'description' => 'Pfad-IDs der zu löschenden Knoten (aus lit-divi-outline).',
+                ],
+                'confirm' => ['type' => 'boolean', 'description' => 'true erst nach Rückfrage beim Nutzer.'],
+            ]),
+            'required' => ['post_id', 'tree_rev', 'ids'],
+            'additionalProperties' => false,
+        ];
+    }
+
+    public function outputSchema(): ?array
+    {
+        return ToolResult::schema(['tree_rev' => ['type' => 'string']], ['tree_rev']);
+    }
+
+    public function annotations(): array
+    {
+        return ['readonly' => false, 'destructive' => true, 'idempotent' => false];
+    }
+
+    public function isDirect(): bool
+    {
+        return true;
+    }
+
+    public function permission(array $input): bool|WP_Error
+    {
+        $page = $this->writer->page($input);
+
+        return $page instanceof WP_Error ? $page : true;
+    }
+
+    public function execute(array $input): mixed
+    {
+        $page = $this->writer->page($input);
+        if ($page instanceof WP_Error) {
+            return $page;
+        }
+
+        /** @var array<string, Block> $nodes */
+        $nodes = [];
+        foreach (is_array($input['ids'] ?? null) ? $input['ids'] : [] as $id) {
+            $node = is_string($id) ? $page->index->find($id) : null;
+            if ($node === null) {
+                return DiviPageLoader::unknownNode((string) $id, $page->post);
+            }
+            $nodes[$id] = $node;
+        }
+
+        // A node inside another node that is deleted anyway needs no own removal.
+        $nodes = array_filter(
+            $nodes,
+            static fn (Block $node, string $id): bool => array_filter(
+                array_keys($nodes),
+                static fn (string $other): bool => $other !== $id && str_starts_with($id, $other . '.')
+            ) === [],
+            ARRAY_FILTER_USE_BOTH
+        );
+
+        if (($input['confirm'] ?? false) !== true) {
+            return Errors::confirmRequired(
+                sprintf('%d Divi-Knoten würden samt Inhalt entfernt: %s.', count($nodes), $this->describe($nodes)),
+                ['nodes' => array_keys($nodes)]
+            );
+        }
+
+        $editor = $this->writer->composition($page)->editor();
+        $change = new DiviChange(sprintf('%d Divi-Knoten gelöscht', count($nodes)));
+        foreach ($nodes as $id => $node) {
+            $change->removed((string) $id, $node);
+            $editor->remove($page->index, $node);
+        }
+
+        return $this->writer->save($this->name(), $page, $change, $input);
+    }
+
+    /** @param array<string, Block> $nodes */
+    private function describe(array $nodes): string
+    {
+        $parts = [];
+        foreach ($nodes as $id => $node) {
+            $label = NodeSummary::label($node);
+            $parts[] = sprintf(
+                '%s %s%s (%d Kind-Knoten)',
+                $id,
+                $node->shortName(),
+                $label === '' ? '' : ' "' . $label . '"',
+                count($node->children())
+            );
+        }
+
+        return implode(', ', $parts);
+    }
+}