elementor-mcp-agent 1.0.0 → 1.2.0

package/README.md

@@ -71,7 +71,7 @@ The `ssh` block is **optional** but unlocks **8 additional tools** (WP-CLI escap
 
 ---
 
-## Tools (24)
+## Tools (34)
 
 ### Sites & health
 - `list_sites` — enumerate the pool
@@ -104,11 +104,54 @@ The `ssh` block is **optional** but unlocks **8 additional tools** (WP-CLI escap
 - `screenshot_page` — headless Chrome PNG of any URL
 - `compare_screenshots` — SHA-256 + byte-delta
 
+### Widgets (v1.1 — widget-level CRUD)
+- `read_widget` — fetch one widget by id (read-only)
+- `update_widget_settings` — shallow-merge settings, with backup + validate + flush
+- `delete_widget` — remove a widget from its parent container
+- `duplicate_widget` — clone as sibling with fresh id
+- `swap_widget_type` — replace widgetType + settings, preserve id + position
+- `add_widget` — append a widget into a parent container
+- `move_widget` — move a widget between containers (with position)
+
+### Bulk & fleet (v1.1)
+- `bulk_find_replace_site` — find/replace across every Elementor page of one site, per-page backup + validate + flush
+- `fleet_find_replace` — same across **every site in the pool** (sequential, dry-run mandatory)
+- `restore_from_file` — restore `_elementor_data` from a JSON file backup, with pre-restore safety backup
+
 ### Fleet
 - `check_elementor_versions` — flag outdated installs against wordpress.org latest
 
 ---
 
+## Post-write verification (v1.2)
+
+Every mutating widget tool re-reads the page from canonical WP **after the
+write** and surfaces persisted state to the model. The HTTP write API can
+lie — return 200 OK while plugin filters or REST quirks silently drop the
+payload. This contract makes that observable.
+
+Every `applied` response carries:
+
+```jsonc
+{
+  "mutated": true,                  // false = no-op OR silent drop
+  "warnings": [],                   // non-fatal issues
+  "verification": {
+    "method": "Re-read /wp/v2/pages/42 and check widget abc settings…",
+    "reread_ok": true,
+    "matches_requested": true,      // false = write API lied
+    "persisted": { /* canonical state */ },
+    "notes": "…explanation when something diverged"
+  }
+}
+```
+
+If `verification.matches_requested === false`, treat as a failure even if
+the HTTP layer said OK. The original payload survives in
+`backup_meta_key` — restore via `restore_elementor_backup`.
+
+---
+
 ## Safety guarantees
 
 Hardcoded in `src/elementor/policies.ts`:
@@ -156,15 +199,16 @@ v1.0.0 was tested in real conditions against a live WordPress install with Eleme
 
 ## Roadmap
 
-**v1.1**
-- Widget-level CRUD: `read_widget`, `update_widget_settings`, `add_widget`, `delete_widget`, `swap_widget_type`
+**v1.1** ✅ shipped
+- Widget-level CRUD: `read_widget`, `update_widget_settings`, `delete_widget`, `duplicate_widget`, `swap_widget_type`, `add_widget`, `move_widget`
 - `bulk_find_replace_site` (across all Elementor pages of one site)
-- `restore_from_file` tool
+- `fleet_find_replace` (across all sites in pool)
+- `restore_from_file`
 
 **v1.2**
-- `fleet_find_replace` (across all sites in pool)
 - Global styles read/write
 - Theme Builder template push across sites
+- Section/column-level operations
 
 **v2.0**
 - WooCommerce-aware tools