elementor-mcp-agent 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -123,6 +123,35 @@ The `ssh` block is **optional** but unlocks **8 additional tools** (WP-CLI escap
123
123
 
124
124
  ---
125
125
 
126
+ ## Post-write verification (v1.2)
127
+
128
+ Every mutating widget tool re-reads the page from canonical WP **after the
129
+ write** and surfaces persisted state to the model. The HTTP write API can
130
+ lie — return 200 OK while plugin filters or REST quirks silently drop the
131
+ payload. This contract makes that observable.
132
+
133
+ Every `applied` response carries:
134
+
135
+ ```jsonc
136
+ {
137
+ "mutated": true, // false = no-op OR silent drop
138
+ "warnings": [], // non-fatal issues
139
+ "verification": {
140
+ "method": "Re-read /wp/v2/pages/42 and check widget abc settings…",
141
+ "reread_ok": true,
142
+ "matches_requested": true, // false = write API lied
143
+ "persisted": { /* canonical state */ },
144
+ "notes": "…explanation when something diverged"
145
+ }
146
+ }
147
+ ```
148
+
149
+ If `verification.matches_requested === false`, treat as a failure even if
150
+ the HTTP layer said OK. The original payload survives in
151
+ `backup_meta_key` — restore via `restore_elementor_backup`.
152
+
153
+ ---
154
+
126
155
  ## Safety guarantees
127
156
 
128
157
  Hardcoded in `src/elementor/policies.ts`: