@diviops/mcp-server 1.2.0 → 1.4.0

package/README.md

@@ -96,7 +96,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 (65)
+## Available Tools (66)
 
 ### Read (30)
 | Tool | Description |
@@ -108,7 +108,7 @@ The server connects via standard WordPress REST API and works with any environme
 | `diviops_page_get_layout` | Get parsed block tree (layout structure) |
 | `diviops_section_get` | Get a single section's markup by admin label |
 | `diviops_schema_list_modules` | List all available Divi modules |
-| `diviops_schema_get_module` | Get attribute schema for a module (optimized by default, `raw: true` for full) |
+| `diviops_schema_get_module` | Get attribute schema for a module. Default `mode: "single"` returns one module's schema (optimized; `raw: true` for full). `mode: "dump_all"` snapshots every Divi module in one call along with a `schema_version` hash over `*PresetAttrsMap.php` and a `divi_version` field — build-time entry point for the skill regen pipeline. |
 | `diviops_schema_get_settings` | Get Divi site settings and theme options |
 | `diviops_global_color_list` | Get global color palette |
 | `diviops_global_font_list` | Get global font definitions |
@@ -132,7 +132,7 @@ The server connects via standard WordPress REST API and works with any environme
 | `diviops_scf_field_group_list` | List all SCF/ACF field groups (post_name = ACF key, post_title, post_status, post_modified). Queries the `acf-field-group` post type via `wp post list` (works on SCF 6.8.4+ and older ACF) |
 | `diviops_scf_field_group_get` | Fetch a single SCF/ACF field-group post by ACF key (`group_abc123` → post_name) or numeric WP post ID. For the parsed/structured field tree, use `diviops_scf_export --field-groups=<key> --stdout` |
 
-### Write (33)
+### Write (34)
 | Tool | Description |
 |------|-------------|
 | `diviops_page_create` | Create a new page with optional Divi content |
@@ -163,7 +163,8 @@ The server connects via standard WordPress REST API and works with any environme
 | `diviops_variable_create_fluid_system` | Batch-emit a fluid typography + spacing + radius variable set in one call. Mirrors Divi 5.4.0's Variable Generator Modal at the algorithm level (clamp() math is identical to `diviops_variable_create`'s fluid mode) but layers profile-selectable anchors over it: `divi-default` (360→1350) matches ET's defaults, `wide` (320→1920) matches the diviops convention, `custom` takes explicit anchors. Each category is independent and optional. Typography uses modular-scale chains (named ratios `major-third`/`perfect-fifth`/`golden`/etc., or raw numbers) — h1 = largest, hN = base. Spacing/radius support `linear` or `geometric` step distributions. `dry_run: true` returns the full plan without persisting; `overwrite: false` (default) skips existing IDs. Single atomic write to the registry — mid-batch failures roll back cleanly |
 | `diviops_variable_delete` | Delete a variable by ID. Returns HTTP 409 when live references exist unless `force=true` (use `diviops_variable_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_canvas_create` | Create a canvas page |
-| `diviops_canvas_update` | Update canvas content |
+| `diviops_canvas_duplicate` | Deep-copy a canvas (content + canvas-specific meta). Default copy title `<source> (Copy)` auto-suffixes on collision (Copy 2, …); explicit `title` collisions return 409. Supports `dry_run` |
+| `diviops_canvas_update` | Update canvas content and/or metadata. Pass any subset of fields — `{canvas_post_id, title}` renames without touching content |
 | `diviops_canvas_delete` | Delete a canvas page |
 | `diviops_scf_export` | Export SCF schema (field groups, post types, taxonomies, options pages) as JSON to a directory under the safe-root, or to stdout. Wraps `wp scf json export` |
 | `diviops_scf_import` | Import SCF schema from a JSON file (mutates DB; idempotent — existing items are updated). Wraps `wp scf json import <file>` |

package/dist/index.js

@@ -198,18 +198,53 @@ registerPluginTool("diviops_schema_list_modules", {
     };
 });
 registerPluginTool("diviops_schema_get_module", {
-    description: "Get the attribute schema for a Divi module. Returns optimized schema by default (~70% smaller) with content-relevant fields only. Use raw: true for the full schema including CSS selectors and VB metadata.",
+    description: "Get the attribute schema for a Divi module. Default mode 'single' returns one module's schema (optimized, ~70% smaller; pass raw: true for full). Mode 'dump_all' snapshots every Divi module in one call and includes a `schema_version` hash over the canonical *PresetAttrsMap.php files — build-time entry point for the skill regen pipeline; ignores `module_name` and `raw`.",
     inputSchema: {
+        mode: z
+            .enum(["single", "dump_all"])
+            .optional()
+            .default("single")
+            .describe("'single' (default): return one module's schema. 'dump_all': return every module keyed by name plus schema_version + divi_version."),
         module_name: z
             .string()
-            .describe('Module name, e.g. "text", "image", "accordion", or full "divi/text"'),
+            .optional()
+            .describe('Module name, e.g. "text", "image", "accordion", or full "divi/text". Required when mode="single"; ignored when mode="dump_all".'),
         raw: z
             .boolean()
             .optional()
             .default(false)
-            .describe("Return full schema including CSS selectors and VB metadata"),
+            .describe("Return full schema including CSS selectors and VB metadata. Applies to mode='single' only."),
     },
-}, async ({ module_name, raw }) => {
+}, async ({ mode, module_name, raw }) => {
+    if (mode === "dump_all") {
+        // Capability gate for the dump-all surface: handled here (rather
+        // than the wrapper's auto-derived `schema_get_module` key) so older
+        // plugins without /schema/module/dump-all surface a clean upgrade
+        // hint instead of a 404 from wp.request.
+        if (handshakeState.kind === "ok" &&
+            !handshakeState.capabilities["schema_get_module_dump_all"]) {
+            const err = new MissingCapabilityError("schema_get_module_dump_all", handshakeState.pluginVersion);
+            return {
+                content: [{ type: "text", text: err.message }],
+                isError: true,
+            };
+        }
+        const result = await wp.request("/schema/module/dump-all");
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    }
+    if (!module_name) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "module_name is required when mode='single'",
+                },
+            ],
+            isError: true,
+        };
+    }
     const result = await wp.request(`/schema/module/${encodeURIComponent(module_name)}`);
     const output = raw ? result : optimizeSchema(result);
     return {
@@ -1376,7 +1411,7 @@ registerPluginTool("diviops_canvas_get", {
     };
 });
 registerPluginTool("diviops_canvas_update", {
-    description: "Update a canvas's content and/or metadata. Content replaces the entire canvas.",
+    description: "Update a canvas's content and/or metadata. Pass any subset of fields — e.g. `{canvas_post_id, title}` to rename without touching content. `content` replaces the entire canvas when present. At least one of content/title/append_to_main/z_index is required.",
     inputSchema: {
         canvas_post_id: z.number().describe("Canvas post ID"),
         content: z
@@ -1410,6 +1445,34 @@ registerPluginTool("diviops_canvas_update", {
         ],
     };
 });
+registerPluginTool("diviops_canvas_duplicate", {
+    description: "Deep-copy a canvas (post_content + canvas-specific meta: parent page, append_to_main, z_index). Source canvas untouched. Default copy title is `<source title> (Copy)` with auto-suffix on collision (Copy 2, Copy 3, …) — use this for repeat-clone workflows. Pass an explicit `title` for a deliberate name; collisions return 409 instead of silently auto-suffixing. Pass `dry_run: true` to preview without mutating.",
+    inputSchema: {
+        canvas_post_id: z.number().describe("Source canvas post ID"),
+        title: z
+            .string()
+            .optional()
+            .describe("Optional explicit title for the duplicate. Omit to auto-derive `<source> (Copy [N])`. Explicit collisions return 409."),
+        dry_run: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("When true, return the change plan without creating the canvas."),
+    },
+}, async ({ canvas_post_id, title, dry_run }) => {
+    const body = { dry_run: dry_run ?? false };
+    if (title !== undefined)
+        body.title = title;
+    const result = await wp.request(`/canvas/duplicate/${canvas_post_id}`, {
+        method: "POST",
+        body,
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(result) },
+        ],
+    };
+});
 registerPluginTool("diviops_canvas_delete", {
     description: "Delete a canvas. This permanently removes the canvas post.",
     inputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diviops/mcp-server",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "MCP server exposing Divi 5 Visual Builder as tools for Claude",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,8 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "regen:skill": "node scripts/regen-module-formats.mjs"
   },
   "keywords": [
     "mcp",