@noleemits/vision-builder-control-mcp 4.31.0 → 4.32.1

package/index.js

@@ -104,7 +104,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.31.0';
+const VERSION = '4.32.0';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2317,7 +2317,7 @@ function getToolDefinitions() {
         },
         {
             name: 'create_post',
-            description: 'Create a WordPress post, page, or CPT. Supports content, excerpt, taxonomies, featured image, Elementor setup, and initial RankMath SEO data.',
+            description: 'Create a WordPress post, page, or CPT. Supports content, excerpt, taxonomies, featured image, parent linking (by slug or ID), Elementor setup, and initial RankMath SEO data.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2327,8 +2327,11 @@ function getToolDefinitions() {
                     excerpt: { type: 'string', description: 'Post excerpt' },
                     status: { type: 'string', enum: ['draft', 'publish', 'private', 'pending'], description: 'Post status (default: draft)' },
                     slug: { type: 'string', description: 'URL slug (auto-generated if omitted)' },
+                    parent: { type: 'number', description: 'Parent post ID (for hierarchical types). Use this OR parent_slug.' },
+                    parent_slug: { type: 'string', description: 'Parent slug — looked up against the same post_type. Saves a follow-up update_post call.' },
                     taxonomies: { type: 'object', description: 'Object: {"category": [1,2], "post_tag": ["seo","health"]}' },
                     featured_image_id: { type: 'number', description: 'Media library attachment ID' },
+                    featured_image_basename: { type: 'string', description: 'Filename of an attachment (e.g. "boating-accidents-v2.jpg") — resolves to the matching attachment ID. Use instead of featured_image_id when you have the source filename but not the ID.' },
                     elementor: { type: 'boolean', description: 'Set up for Elementor editing' },
                     seo: { type: 'object', description: 'RankMath SEO: {title, description, focus_keyword, robots, ...}' }
                 },
@@ -2337,7 +2340,7 @@ function getToolDefinitions() {
         },
         {
             name: 'update_post',
-            description: 'Update any field on a WordPress post/page. Only provided fields are changed. Supports title, content, status, slug, excerpt, taxonomies, featured image, and RankMath SEO. Pass preserve_modified_date=true to keep the original last-modified date.',
+            description: 'Update any field on a WordPress post/page. Only provided fields are changed. Supports title, content, status, slug, excerpt, parent (ID or slug), taxonomies, featured image (ID or basename), and RankMath SEO. Pass preserve_modified_date=true to keep the original last-modified date.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2348,8 +2351,10 @@ function getToolDefinitions() {
                     status: { type: 'string', enum: ['draft', 'publish', 'private', 'pending', 'trash'] },
                     slug: { type: 'string' },
                     parent: { type: 'number', description: 'Parent post/page ID (for hierarchical types like pages). Changes URL structure.' },
+                    parent_slug: { type: 'string', description: 'Parent slug — looked up against this post\'s post_type. Use instead of parent when you don\'t know the parent ID.' },
                     taxonomies: { type: 'object', description: '{"category": [1,2]}' },
                     featured_image_id: { type: 'number', description: 'Attachment ID (omit to keep, pass null to remove)' },
+                    featured_image_basename: { type: 'string', description: 'Filename of an attachment to use as featured image. Resolved to the matching ID server-side.' },
                     seo: { type: 'object', description: 'RankMath SEO fields to update' },
                     preserve_modified_date: { type: 'boolean', description: 'If true, keep the original last-modified date instead of updating it to now. Useful for content fixes that should not change the published "updated" date.' }
                 },
@@ -2612,6 +2617,56 @@ function getToolDefinitions() {
             }
         },
 
+        // ── Patch + Migration (v4.32.0) ──
+        {
+            name: 'patch_template',
+            description: 'Apply surgical operations to an Elementor library template without re-uploading the full JSON. Op types: set_settings (merge keys into element.settings), replace_element (swap full element node), insert_element (add child at position 0/end/<int>), remove_element (delete by id), append_custom_css / set_custom_css (add or replace settings.custom_css). Returns per-op success/error so partial failures don\'t roll back the batch.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    template_id: { type: 'number', description: 'Elementor library template ID' },
+                    ops: {
+                        type: 'array',
+                        description: 'Ordered list of operations to apply.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                type:       { type: 'string', enum: ['set_settings', 'replace_element', 'insert_element', 'remove_element', 'append_custom_css', 'set_custom_css'] },
+                                id:         { type: 'string', description: 'Target element ID (required for set_settings, replace_element, remove_element, append_custom_css, set_custom_css)' },
+                                parent_id:  { type: 'string', description: 'Parent element ID (required for insert_element)' },
+                                position:   { description: 'Insert position: 0, "end", or numeric index. Default: end.' },
+                                element:    { type: 'object', description: 'Full element JSON (required for replace_element, insert_element)' },
+                                settings:   { type: 'object', description: 'Settings to merge (required for set_settings)' },
+                                css:        { type: 'string', description: 'CSS text (required for append_custom_css, set_custom_css)' }
+                            },
+                            required: ['type']
+                        }
+                    }
+                },
+                required: ['template_id', 'ops']
+            }
+        },
+        {
+            name: 'migrate_extracted_md',
+            description: 'One-shot migration: take an extract-format markdown chunk and create or update a CPT post with cleaned HTML body, featured image, parent linking, and RankMath SEO. Idempotent: re-running with the same slug+post_type updates instead of duplicating. Pass md_content (preferred) or md_path. Use hero_basename to look up the featured image by filename instead of attachment ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    md_content:        { type: 'string', description: 'Raw markdown body (preferred — no server-side path needed)' },
+                    md_path:           { type: 'string', description: 'Server-side path to MD file. Only useful if WP server can read the path.' },
+                    post_type:         { type: 'string', description: 'CPT slug (e.g. "practice-area")' },
+                    slug:              { type: 'string', description: 'Post slug — used as idempotency key' },
+                    parent_slug:       { type: 'string', description: 'Optional. Looked up against same post_type for hierarchical CPTs.' },
+                    hero_basename:     { type: 'string', description: 'Optional. Filename like "boating-accidents-v2.jpg" — resolves to the matching attachment.' },
+                    title_override:    { type: 'string', description: 'Optional. Overrides extracted H1.' },
+                    seo_focus_keyword: { type: 'string', description: 'Optional. RankMath focus keyword.' },
+                    status:            { type: 'string', enum: ['draft', 'publish', 'private', 'pending'], description: 'Default: publish' },
+                    strip_first_paragraph: { type: 'boolean', description: 'Drop the first <p> if it duplicates H1+lede (default: true)' }
+                },
+                required: ['post_type', 'slug']
+            }
+        },
+
         // ── Custom post types & taxonomies (v4.31.0) ──
         {
             name: 'register_cpt',
@@ -4156,15 +4211,10 @@ async function handleToolCall(name, args) {
 
     case 'create_post': {
         const body = { title: args.title };
-        if (args.post_type) body.post_type = args.post_type;
-        if (args.content) body.content = args.content;
-        if (args.excerpt) body.excerpt = args.excerpt;
-        if (args.status) body.status = args.status;
-        if (args.slug) body.slug = args.slug;
-        if (args.taxonomies) body.taxonomies = args.taxonomies;
-        if (args.featured_image_id) body.featured_image_id = args.featured_image_id;
-        if (args.elementor) body.elementor = args.elementor;
-        if (args.seo) body.seo = args.seo;
+        const passthrough = ['post_type', 'content', 'excerpt', 'status', 'slug',
+            'parent', 'parent_slug', 'taxonomies', 'featured_image_id',
+            'featured_image_basename', 'elementor', 'seo'];
+        for (const k of passthrough) if (args[k] !== undefined) body[k] = args[k];
         const r = await apiCall('/posts', 'POST', body);
         if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
         return ok(`Post created!\nID: ${r.id} | Type: ${r.type} | Status: ${r.status}\nTitle: ${r.title}\nSlug: ${r.slug}\nURL: ${r.url}\nEdit: ${r.edit_url}`);
@@ -4472,6 +4522,30 @@ async function handleToolCall(name, args) {
         return ok(`Assigned menu #${r.menu_id} to location "${r.location}".`);
     }
 
+    case 'patch_template': {
+        const r = await apiCall(`/templates/${args.template_id}/patch`, 'POST', { ops: args.ops });
+        const okLines = r.applied.map(a => `  ✓ #${a.index} ${a.type}`);
+        const errLines = (r.errors || []).map(e => `  ✗ #${e.index} ${e.type}: ${e.error}`);
+        return ok(
+            `Patched template ${r.template_id}: ${r.applied.length} op(s) applied${r.errors?.length ? ', ' + r.errors.length + ' failed' : ''}\n` +
+            okLines.concat(errLines).join('\n')
+        );
+    }
+
+    case 'migrate_extracted_md': {
+        const body = {};
+        ['md_content','md_path','post_type','slug','parent_slug','hero_basename','title_override','seo_focus_keyword','status','strip_first_paragraph']
+            .forEach(k => { if (args[k] !== undefined) body[k] = args[k]; });
+        const r = await apiCall('/migrate/extracted-md', 'POST', body);
+        return ok(
+            `${r.was_existing ? 'Updated' : 'Created'} ${args.post_type} #${r.post_id}\n` +
+            `  H1:    ${r.parsed.h1}\n` +
+            `  Title: ${args.title_override || r.parsed.h1}\n` +
+            `  Body:  ${r.parsed.body_length} chars\n` +
+            `  URL:   ${r.url}`
+        );
+    }
+
     case 'register_cpt': {
         const r = await apiCall('/post-types', 'POST', args);
         return ok(`${r.created ? 'Registered' : 'Updated'} CPT "${r.slug}"\n  hierarchical: ${r.def.hierarchical}\n  rewrite_slug: ${r.def.rewrite_slug || '(default)'}\n  has_archive: ${r.def.has_archive}\n  supports: ${(r.def.supports || []).join(', ')}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noleemits/vision-builder-control-mcp",
-  "version": "4.31.0",
+  "version": "4.32.1",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",