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
This commit is contained in:
Claude Opus 5.5
@@ -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);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,99 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace LIT\MCP\Integrations\Divi\Pages;
|
||||
|
||||
use LIT\MCP\Abilities\Ability;
|
||||
use LIT\MCP\Abilities\ToolResult;
|
||||
use LIT\MCP\Integrations\Divi\BlockTree\AttrMap;
|
||||
use LIT\MCP\Integrations\Divi\BlockTree\NodeSummary;
|
||||
use WP_Error;
|
||||
|
||||
/**
|
||||
* lit/divi-duplicate-node: copies a node with everything inside right behind the original
|
||||
* (spec §5.7). The copy's admin label gets " (Kopie)"; read-only nodes (global modules,
|
||||
* foreign blocks) are copied unchanged, as a whole, byte-identical reference.
|
||||
*/
|
||||
final class DiviDuplicateNodeAbility implements Ability
|
||||
{
|
||||
public function __construct(private DiviWriter $writer)
|
||||
{
|
||||
}
|
||||
|
||||
public function name(): string
|
||||
{
|
||||
return 'lit/divi-duplicate-node';
|
||||
}
|
||||
|
||||
public function label(): string
|
||||
{
|
||||
return 'Divi-Knoten duplizieren';
|
||||
}
|
||||
|
||||
public function description(): string
|
||||
{
|
||||
return 'Dupliziert einen Divi-Knoten samt Inhalt direkt hinter das Original; das Admin-Label der Kopie endet '
|
||||
. 'auf „(Kopie)“. tree_rev aus lit-divi-outline ist Pflicht.';
|
||||
}
|
||||
|
||||
public function inputSchema(): array
|
||||
{
|
||||
return [
|
||||
'type' => 'object',
|
||||
'properties' => array_merge(DiviWriter::inputProperties(), [
|
||||
'id' => ['type' => 'string', 'description' => 'Pfad-ID des zu duplizierenden Knotens.'],
|
||||
]),
|
||||
'required' => ['post_id', 'tree_rev', 'id'],
|
||||
'additionalProperties' => false,
|
||||
];
|
||||
}
|
||||
|
||||
public function outputSchema(): ?array
|
||||
{
|
||||
return ToolResult::schema(['tree_rev' => ['type' => 'string']], ['tree_rev']);
|
||||
}
|
||||
|
||||
public function annotations(): array
|
||||
{
|
||||
return ['readonly' => false, 'destructive' => false, 'idempotent' => false];
|
||||
}
|
||||
|
||||
public function isDirect(): bool
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
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;
|
||||
}
|
||||
|
||||
$id = is_string($input['id'] ?? null) ? $input['id'] : '';
|
||||
$node = $page->index->find($id);
|
||||
if ($node === null) {
|
||||
return DiviPageLoader::unknownNode($id, $page->post);
|
||||
}
|
||||
|
||||
$copy = $this->writer->composition($page)->editor()->duplicate($page->index, $node);
|
||||
if ($copy->isDivi() && ! $copy->isOpaque()) {
|
||||
$label = NodeSummary::label($node);
|
||||
$copy->setAttrs(AttrMap::set($copy->attrs(), 'module.meta.adminLabel', [
|
||||
'desktop' => ['value' => ($label === '' ? $node->shortName() : $label) . ' (Kopie)'],
|
||||
]));
|
||||
}
|
||||
|
||||
$change = (new DiviChange(sprintf('Knoten %s dupliziert', $id)))->changed($copy, 'duplicated');
|
||||
|
||||
return $this->writer->save($this->name(), $page, $change, $input);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
<?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 WP_Error;
|
||||
|
||||
/**
|
||||
* lit/divi-move: moves a node (with everything inside) to parent / before / after – also into
|
||||
* another row or section, as long as the structure rules allow it (spec §5.7). Read-only
|
||||
* nodes (global modules, foreign blocks) move as a whole, unchanged.
|
||||
*/
|
||||
final class DiviMoveAbility implements Ability
|
||||
{
|
||||
public function __construct(private DiviWriter $writer)
|
||||
{
|
||||
}
|
||||
|
||||
public function name(): string
|
||||
{
|
||||
return 'lit/divi-move';
|
||||
}
|
||||
|
||||
public function label(): string
|
||||
{
|
||||
return 'Divi-Knoten verschieben';
|
||||
}
|
||||
|
||||
public function description(): string
|
||||
{
|
||||
return 'Verschiebt einen Divi-Knoten samt Inhalt an eine neue Stelle (parent, before oder after; auch in '
|
||||
. 'andere Zeilen oder Abschnitte). tree_rev aus lit-divi-outline ist Pflicht.';
|
||||
}
|
||||
|
||||
public function inputSchema(): array
|
||||
{
|
||||
return [
|
||||
'type' => 'object',
|
||||
'properties' => array_merge(
|
||||
DiviWriter::inputProperties(),
|
||||
['id' => ['type' => 'string', 'description' => 'Pfad-ID des zu verschiebenden Knotens.']],
|
||||
DiviWriter::positionProperties()
|
||||
),
|
||||
'required' => ['post_id', 'tree_rev', 'id'],
|
||||
'additionalProperties' => false,
|
||||
];
|
||||
}
|
||||
|
||||
public function outputSchema(): ?array
|
||||
{
|
||||
return ToolResult::schema(['tree_rev' => ['type' => 'string']], ['tree_rev']);
|
||||
}
|
||||
|
||||
public function annotations(): array
|
||||
{
|
||||
return ['readonly' => false, 'destructive' => false, '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;
|
||||
}
|
||||
|
||||
$id = is_string($input['id'] ?? null) ? $input['id'] : '';
|
||||
$node = $page->index->find($id);
|
||||
if ($node === null) {
|
||||
return DiviPageLoader::unknownNode($id, $page->post);
|
||||
}
|
||||
|
||||
$editor = $this->writer->composition($page)->editor();
|
||||
$position = $editor->position($page->index, $input);
|
||||
if (is_string($position)) {
|
||||
return Errors::invalidInput('Ungültige Position; nichts wurde gespeichert.', ['position' => $position]);
|
||||
}
|
||||
|
||||
$problem = $editor->move($page->index, $node, $position);
|
||||
if ($problem !== null) {
|
||||
return Errors::invalidInput(
|
||||
'Verschieben nicht möglich; nichts wurde gespeichert.',
|
||||
['position' => $problem]
|
||||
);
|
||||
}
|
||||
|
||||
$change = (new DiviChange(sprintf('Knoten %s verschoben', $id)))->changed($node, 'moved');
|
||||
|
||||
return $this->writer->save($this->name(), $page, $change, $input);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user