@noleemits/vision-builder-control-mcp 4.16.0 → 4.18.1

package/index.js

@@ -104,7 +104,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.16.0';
+const VERSION = '4.18.1';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -2003,7 +2003,7 @@ function getToolDefinitions() {
         },
         {
             name: 'fix_trailing_slashes',
-            description: 'Add missing trailing slashes to internal URLs across ALL post types (pages, posts, CPTs). Scans both Elementor widget data and Gutenberg/classic post_content. Skips anchors (#), query strings (?), external URLs, and file extensions (.pdf etc). ALWAYS run with dry_run=true first to preview changes.',
+            description: 'Add missing trailing slashes to internal URLs across ALL post types (pages, posts, CPTs). Scans both Elementor widget data and Gutenberg/classic post_content. Skips anchors (#), query strings (?), external URLs, and file extensions (.pdf etc). Never changes post_modified date. ALWAYS run with dry_run=true first to preview changes.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2051,7 +2051,7 @@ function getToolDefinitions() {
         },
         {
             name: 'find_replace',
-            description: 'Global find & replace across all Elementor pages. Searches heading titles, text-editor HTML, button text, image-box titles/descriptions, icon-box titles/descriptions, icon-list items, toggle titles/content, and image alt text. Supports literal text or regex. Always preview with dry_run=true first.',
+            description: 'Global find & replace across all Elementor pages. Searches heading titles, text-editor HTML, button text, image-box titles/descriptions, icon-box titles/descriptions, icon-list items, toggle titles/content, and image alt text. Supports literal text or regex. Never changes post_modified date (Elementor meta only). Always preview with dry_run=true first.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2155,7 +2155,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.',
+            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.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2168,7 +2168,8 @@ function getToolDefinitions() {
                     parent: { type: 'number', description: 'Parent post/page ID (for hierarchical types like pages). Changes URL structure.' },
                     taxonomies: { type: 'object', description: '{"category": [1,2]}' },
                     featured_image_id: { type: 'number', description: 'Attachment ID (omit to keep, pass null to remove)' },
-                    seo: { type: 'object', description: 'RankMath SEO fields to update' }
+                    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.' }
                 },
                 required: ['post_id']
             }
@@ -2230,6 +2231,16 @@ function getToolDefinitions() {
                 }
             }
         },
+        {
+            name: 'audit_faq_schema',
+            description: 'Audit all published posts/pages for FAQ schema issues: duplicate FAQPage markup (NVBC meta + RankMath block), orphaned NVBC schemas, unconverted plain FAQs, invalid JSON, empty Q&As, and encoding issues (bare u003c).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_type: { type: 'string', description: 'Optional: filter by post type (e.g., "page" or "post")' }
+                }
+            }
+        },
         {
             name: 'update_term_seo',
             description: 'Update RankMath SEO fields on a taxonomy term (category, tag, custom taxonomy). Accepts any subset: title, description, focus_keyword, canonical_url, noindex (boolean convenience flag).',
@@ -2540,7 +2551,7 @@ function getToolDefinitions() {
         },
         {
             name: 'replace_post_content',
-            description: 'Bulk find-replace in WordPress post_content (Gutenberg/classic editor). Use for migrating URLs, fixing domains, replacing shortcodes. Always dry_run=true first to preview. Works on published posts and pages.',
+            description: 'Bulk find-replace in WordPress post_content (Gutenberg/classic editor). Use for migrating URLs, fixing domains, replacing shortcodes. Always dry_run=true first to preview. Works on published posts and pages. Never changes post_modified date (uses direct DB write).',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -2579,6 +2590,18 @@ function getToolDefinitions() {
                 required: ['posts']
             }
         },
+        {
+            name: 'convert_faq_to_rankmath',
+            description: 'Scan post_content for plain Q/A FAQ sections and convert them to wp:rank-math/faq-block Gutenberg blocks. Detects H2 "FAQs" / "Frequently Asked Questions" headings followed by H3+paragraph Q/A pairs. Strips Q:/A: prefixes and   entities. Never changes post_modified date (direct DB write). ALWAYS dry_run=true first.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id: { type: 'number', description: 'Convert only this specific post ID. Omit to scan all posts.' },
+                    post_type: { type: 'string', description: 'Filter by post type: "post", "page", etc. Omit for all types.' },
+                    dry_run: { type: 'boolean', description: 'Preview extracted Q&As without saving (default: true). Set false to apply conversion.' }
+                }
+            }
+        },
         {
             name: 'get_global_styles',
             description: 'Read Elementor global colors and fonts from the active kit. Returns system colors (Primary, Secondary, Text, Accent), custom colors, system typography, and custom typography with all properties.',
@@ -3774,7 +3797,9 @@ async function handleToolCall(name, args) {
         const { post_id, ...fields } = args;
         const r = await apiCall(`/posts/${post_id}`, 'PUT', fields);
         if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
-        return ok(`Post updated!\nID: ${r.id} | Status: ${r.status}\nTitle: ${r.title}\nUpdated: ${r.updated_fields.join(', ')}\nURL: ${r.url}`);
+        let out = `Post updated!\nID: ${r.id} | Status: ${r.status}\nTitle: ${r.title}\nUpdated: ${r.updated_fields.join(', ')}\nURL: ${r.url}`;
+        if (r.modified_date_preserved) out += `\n📌 Modified date preserved: ${r.post_modified}`;
+        return ok(out);
     }
 
     case 'delete_post': {
@@ -3839,6 +3864,36 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    case 'audit_faq_schema': {
+        const params = new URLSearchParams();
+        if (args.post_type) params.set('post_type', args.post_type);
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const r = await apiCall(`/audit-faq-schema${qs}`);
+        if (!r.success) return ok(`Failed: ${r.message || 'Unknown error'}`);
+        const s = r.summary;
+        let out = `=== FAQ SCHEMA AUDIT ===\n`;
+        out += `Total published: ${s.total_posts}\n`;
+        out += `With RankMath FAQ block: ${s.has_rankmath_block}\n`;
+        out += `With NVBC plugin schema: ${s.has_nvbc_schema}\n`;
+        out += `Clean (no issues): ${s.clean}\n\n`;
+        out += `--- Issues ---\n`;
+        out += `Duplicate FAQ (both sources): ${s.duplicate_faq}\n`;
+        out += `Plain FAQ unconverted: ${s.plain_faq_unconverted}\n`;
+        out += `Invalid JSON: ${s.invalid_json}\n`;
+        out += `Empty questions: ${s.empty_questions}\n`;
+        out += `Encoding issues (bare u003c): ${s.encoding_issues}\n`;
+        if (r.issues.length) {
+            out += `\n--- POSTS WITH ISSUES (${r.issues.length}) ---\n`;
+            r.issues.forEach(p => {
+                out += `  [${p.id}] ${p.title} (${p.type}/${p.editor})`;
+                out += `\n    Issues: ${p.issues.join(', ')}\n`;
+            });
+        } else {
+            out += '\nNo issues found — all FAQ schemas are clean!';
+        }
+        return ok(out);
+    }
+
     case 'update_term_seo': {
         const { term_id, taxonomy, ...seoFields } = args;
         const body = { ...seoFields };
@@ -4481,6 +4536,33 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    case 'convert_faq_to_rankmath': {
+        const body = {};
+        if (args.post_id) body.post_id = args.post_id;
+        if (args.post_type) body.post_type = args.post_type;
+        if (args.dry_run !== undefined) body.dry_run = args.dry_run;
+        const r = await apiCall('/convert-faq-to-rankmath', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);
+        let out = r.dry_run ? `=== CONVERT FAQ TO RANKMATH (DRY RUN) ===\n` : `=== CONVERT FAQ TO RANKMATH ===\n`;
+        out += `Posts scanned: ${r.posts_scanned} | Converted: ${r.posts_converted} | Total Q&As: ${r.total_questions}\n`;
+        if (r.results?.length) {
+            r.results.forEach(p => {
+                out += `\n📄 [${p.post_id}] ${p.title} (${p.post_type}) — ${p.sections} section(s), ${p.questions} Q&A(s)${p.duplicates_removed ? ` [${p.duplicates_removed} duplicate(s) removed]` : ''}\n`;
+                if (p.preview) {
+                    p.preview.forEach(sec => {
+                        out += `  Section: "${sec.heading}"\n`;
+                        sec.qa_pairs.forEach((qa, i) => {
+                            out += `    ${i + 1}. Q: ${qa.question}\n`;
+                            out += `       A: ${qa.answer}\n`;
+                        });
+                    });
+                }
+            });
+        }
+        out += `\n${r.note}`;
+        return ok(out);
+    }
+
     case 'get_global_styles': {
         const r = await apiCall('/global-styles');
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error}`);

package/package.json

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