@diviops/mcp-server 0.2.5 → 0.2.7

package/README.md

@@ -91,7 +91,7 @@ The server connects via standard WordPress REST API and works with any environme
 
 > **WP-CLI note:** `WP_PATH` keeps the existing Local by Flywheel behavior by running `wp` directly on the host filesystem. For Docker-based environments (DDEV, wp-env, DevKinsta, WordPress Studio), set `WP_CLI_CMD` to the wrapper command instead. When `WP_CLI_CMD` is set, the server executes the wrapper from `WP_PATH` if provided, otherwise from its current working directory. The MCP server still validates the requested WP-CLI subcommand against its allowlist before executing either path.
 
-## Available Tools (47)
+## Available Tools (48)
 
 ### Read (26)
 | Tool | Description |
@@ -141,16 +141,17 @@ The server connects via standard WordPress REST API and works with any environme
 | `diviops_save_to_library` | Save block markup to Divi Library |
 | `diviops_update_tb_layout` | Update a Theme Builder layout's block markup |
 | `diviops_create_tb_template` | Create Theme Builder template with header/footer and conditions |
-| `diviops_create_variable` | Create a design token variable |
+| `diviops_create_variable` | Create a design token variable. For `type=numbers` fluid tokens, pass `min`+`max` shorthand (anchors default to 320px/1920px) or explicit `targets` like `{"320px":"20px","1920px":"60px"}` — server generates arithmetically-correct `clamp()` instead of hand-written math that silently under-reaches the stated max. Px inputs only in this MVP; rem inputs should be converted to px (1rem=16px) before calling |
 | `diviops_delete_variable` | Delete a variable by ID. Returns HTTP 409 when live references exist unless `force=true` (use `diviops_variables_scan_orphans` to find reference locations). Returns HTTP 403 for Divi's customizer-bound defaults (`gcid-primary-color`, `gcid-secondary-color`, `gcid-heading-color`, `gcid-body-color`, `gcid-link-color` — managed via WP Customizer) |
 | `diviops_create_canvas` | Create a canvas page |
 | `diviops_update_canvas` | Update canvas content |
 | `diviops_delete_canvas` | Delete a canvas page |
 
-### Utility (1)
+### Utility (2)
 | Tool | Description |
 |------|-------------|
 | `diviops_wp_cli` | Run WP-CLI commands (allowlisted, requires `WP_PATH` or `WP_CLI_CMD`) |
+| `diviops_flush_static_cache` | Flush Divi's compiled CSS cache under `wp-content/et-cache/`. `wp cache flush` does NOT touch these files — the frontend can keep serving stale CSS after mutations. Delegates to Divi's native clearer (`ET_Core_PageResource::remove_static_resources`) when available — also clears Theme Builder / archive / taxonomy / home / notfound CSS, object cache, module features cache, post features cache, dynamic assets cache, Google Fonts cache, post meta caches. Falls back to a filesystem walk of numeric-named subdirs when Divi is inactive. Response includes `backend: "divi_native"` or `"fs_fallback"`. Exactly one selector required: `post_id`, `all`, or `after` (unix ts) — no default to `all` |
 
 ## WP-CLI Security
 

package/dist/compatibility.d.ts

@@ -2,7 +2,7 @@
  * Version compatibility between MCP server and WP plugin.
  */
 /** Minimum WP plugin version this server requires. */
-export declare const MIN_PLUGIN_VERSION = "1.0.0-beta.22";
+export declare const MIN_PLUGIN_VERSION = "1.0.0-beta.28";
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/compatibility.js

@@ -2,7 +2,7 @@
  * Version compatibility between MCP server and WP plugin.
  */
 /** Minimum WP plugin version this server requires. */
-export const MIN_PLUGIN_VERSION = '1.0.0-beta.22';
+export const MIN_PLUGIN_VERSION = '1.0.0-beta.28';
 /**
  * Compare two semver-like version strings (supports pre-release tags).
  *

package/dist/index.js

@@ -1285,7 +1285,7 @@ server.registerTool("diviops_list_variables", {
     };
 });
 server.registerTool("diviops_create_variable", {
-    description: 'Create a design token variable in the Divi Variable Manager. Colors (type "colors") use gcid-* IDs and hex values. Numbers/strings/etc use gvid-* IDs.',
+    description: 'Create a design token variable in the Divi Variable Manager. Colors (type "colors") use gcid-* IDs and hex values. Numbers/strings/etc use gvid-* IDs. For type="numbers" fluid tokens, pass min+max shorthand (anchors default to 320px/1920px) or explicit targets — server generates arithmetically-correct clamp() formulas. Px inputs only in this MVP; rem inputs must be converted to px (1rem=16px) before calling. Mutually exclusive with value.',
     inputSchema: {
         type: z
             .enum(["colors", "numbers", "strings", "images", "links", "fonts"])
@@ -1299,12 +1299,36 @@ server.registerTool("diviops_create_variable", {
             .describe("Human-readable label shown in the VB Variable Manager"),
         value: z
             .string()
-            .describe('Variable value: hex color for colors (e.g. "#3a7a6a"), CSS value for numbers (e.g. "clamp(30px, 8vw, 100px)")'),
+            .optional()
+            .describe('Variable value (required unless using fluid min/max/targets for type=numbers): hex color for colors (e.g. "#3a7a6a"), CSS value for numbers (e.g. "clamp(30px, 8vw, 100px)" or "2rem")'),
+        min: z
+            .string()
+            .optional()
+            .describe('Fluid minimum value in px (e.g. "20px"). Paired with max. Anchors default to 320px/1920px. type="numbers" only. Rem not supported — convert to px (1rem=16px) before calling.'),
+        max: z
+            .string()
+            .optional()
+            .describe('Fluid maximum value in px (e.g. "60px"). Paired with min.'),
+        targets: z
+            .record(z.string(), z.string())
+            .refine((m) => !m || Object.keys(m).length === 2, {
+            message: "targets must contain exactly 2 viewport entries",
+        })
+            .optional()
+            .describe('Explicit two-anchor fluid spec, px only. Example: {"320px":"20px","1920px":"60px"} → clamp(20px, 12px + 2.5vw, 60px). Exactly 2 entries required. type="numbers" only. Mutually exclusive with min/max.'),
     },
-}, async ({ type, id, label, value }) => {
-    const body = { type, label, value };
+}, async ({ type, id, label, value, min, max, targets }) => {
+    const body = { type, label };
+    if (value !== undefined)
+        body.value = value;
     if (id)
         body.id = id;
+    if (min !== undefined)
+        body.min = min;
+    if (max !== undefined)
+        body.max = max;
+    if (targets !== undefined)
+        body.targets = targets;
     const result = await wp.request("/variable/create", {
         method: "POST",
         body,
@@ -1348,6 +1372,45 @@ server.registerTool("diviops_variables_scan_orphans", {
         ],
     };
 });
+server.registerTool("diviops_flush_static_cache", {
+    description: "Flush Divi's compiled static CSS cache under wp-content/et-cache/. wp cache flush does NOT touch these files — the frontend can keep serving stale CSS after a preset/variable/module mutation until the cache is cleared. Delegates to Divi's native ET_Core_PageResource::remove_static_resources when available (response backend: \"divi_native\"), which additionally clears Theme Builder CSS scattered across other post dirs, archive/taxonomy/home/notfound CSS, the object cache, module features cache, post features cache, Google Fonts cache, dynamic assets cache, and post meta caches. Falls back to a targeted filesystem walk of numeric-named et-cache subdirs when the Divi class is absent (backend: \"fs_fallback\"). Provide exactly one selector — no site-wide default to prevent accidental full flush. Idempotent: missing cache root returns 200 with empty list.",
+    inputSchema: {
+        post_id: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Flush cache for one post. Native backend also clears matching Theme Builder CSS in other post dirs; fs_fallback only clears wp-content/et-cache/{post_id}/."),
+        all: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Flush every cached file. Native backend clears archive/taxonomy/home/notfound CSS + multi-layer WP caches; fs_fallback only clears numeric-named subdirs (siblings like .cache-cleared-at, global/, en_US/, notfound/, *.data are preserved in either mode)."),
+        after: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Unix timestamp — iterate numeric subdirs with mtime greater than this value, flushing each. Useful for flushing entries touched since a known deployment or mutation batch. Native clearer runs once per matched post."),
+    },
+}, async ({ post_id, all, after }) => {
+    const body = {};
+    if (post_id !== undefined)
+        body.post_id = post_id;
+    if (all)
+        body.all = true;
+    if (after !== undefined)
+        body.after = after;
+    const result = await wp.request("/flush-static-cache", {
+        method: "POST",
+        body,
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(result, null, 2) },
+        ],
+    };
+});
 // ── Start ────────────────────────────────────────────────────────────
 async function main() {
     // Version handshake — verify plugin compatibility before accepting tool calls.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diviops/mcp-server",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "MCP server exposing Divi 5 Visual Builder as tools for Claude",
   "type": "module",
   "main": "dist/index.js",