@noleemits/vision-builder-control-mcp 4.5.6 → 4.5.10

package/index.js

@@ -94,7 +94,8 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.5.6';
+const VERSION = '4.5.10';
+const MIN_PLUGIN_VERSION = '4.5.10'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
 // PARAMETER HELPERS
@@ -1727,6 +1728,18 @@ 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.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    post_id:   { type: 'number',  description: 'Fix only this specific post ID. Omit to scan all posts.' },
+                    post_type: { type: 'string',  description: 'Filter by post type (e.g. "page", "post", "treatment"). Omit for all public post types.' },
+                    dry_run:   { type: 'boolean', description: 'Preview changes without saving. Default: true (safe). Set false to apply.' }
+                }
+            }
+        },
         {
             name: 'fix_links',
             description: 'Auto-fix link targets across all Elementor pages. Internal links → same tab, external → new tab. Supports dry_run mode. Use include_templates to also fix library templates.',
@@ -1794,11 +1807,27 @@ function getToolDefinitions() {
         },
         {
             name: 'check_links',
-            description: 'Check all URLs on Elementor pages for broken links (404, 500, timeout). Performs HTTP HEAD requests to each unique URL. May take 30-60 seconds for sites with many links.',
+            description: 'Check all URLs on Elementor pages for broken links (404, 500, timeout). Results are cached per-URL for 24 hours — subsequent calls are instant for already-checked URLs. Use force_refresh=true to re-fetch everything.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    page_id:       { type: 'number',  description: 'Optional: check only this page.' },
+                    force_refresh: { type: 'boolean', description: 'If true, bypass cache and re-fetch all URLs. Default: false.' }
+                }
+            }
+        },
+        {
+            name: 'clear_link_cache',
+            description: 'Clear the persistent link status cache. Use when you know URLs have changed and want the next check_links call to re-fetch everything from scratch.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'warm_link_cache',
+            description: 'Pre-warm the link status cache by fetching the site\'s XML sitemap, extracting all URLs, and HEAD-checking each one. Handles staging environments automatically — sitemap URLs with a different domain are normalized to the current site URL. Run this once to make subsequent check_links calls instant. Supports sitemap index files (fetches all child sitemaps).',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    page_id: { type: 'number', description: 'Optional: check only this page. Recommended for speed.' }
+                    force_refresh: { type: 'boolean', description: 'Re-check even URLs already in cache. Default: false (skips fresh entries).' }
                 }
             }
         },
@@ -2428,13 +2457,31 @@ async function handleToolCall(name, args) {
     case 'health_check': {
         try {
             const r = await apiCall('/health');
+
+            // Compare plugin version against minimum required
+            const versionOk = (pluginVer, minVer) => {
+                const p = pluginVer.split('.').map(Number);
+                const m = minVer.split('.').map(Number);
+                for (let i = 0; i < 3; i++) {
+                    if ((p[i] || 0) > (m[i] || 0)) return true;
+                    if ((p[i] || 0) < (m[i] || 0)) return false;
+                }
+                return true; // equal is fine
+            };
+
+            const compatible = versionOk(r.version, MIN_PLUGIN_VERSION);
+            const compatLine = compatible
+                ? `Compatibility: OK`
+                : `⚠️  Compatibility: Plugin v${r.version} is below required v${MIN_PLUGIN_VERSION}.\n   Some tools may fail. Please update the WordPress plugin.`;
+
             return ok(
                 `Vision Builder Control: ACTIVE\n` +
                 `Plugin: v${r.version}\n` +
                 `Elementor: ${r.elementor ? 'Active' : 'NOT ACTIVE'}\n` +
                 `Components: ${r.components}\n` +
                 `Shortcodes: ${r.shortcodes ? 'Enabled' : 'Disabled'}\n` +
-                `MCP Server: v${VERSION} (${httpMode ? 'HTTP/SSE' : 'stdio'})`
+                `MCP Server: v${VERSION} (${httpMode ? 'HTTP/SSE' : 'stdio'})\n` +
+                compatLine
             );
         } catch (e) {
             return ok(`Vision Builder Control: NOT RESPONDING\nError: ${e.message}\n\nMake sure:\n1. Noleemits Vision Builder Control plugin is activated\n2. Elementor is installed and activated\n3. WP_URL, WP_USER, WP_APP_PASSWORD are correct`);
@@ -2803,6 +2850,35 @@ async function handleToolCall(name, args) {
         return ok(msg);
     }
 
+    case 'fix_trailing_slashes': {
+        const body = { dry_run: args.dry_run !== false };
+        if (args.post_id)   body.post_id   = args.post_id;
+        if (args.post_type) body.post_type = args.post_type;
+        const r = await apiCall('/fix-trailing-slashes', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+
+        const mode = r.dry_run ? 'DRY RUN — no changes saved' : 'APPLIED';
+        let msg = `=== TRAILING SLASH FIX (${mode}) ===\nPosts scanned: ${r.posts_scanned}\nPosts with changes: ${r.posts_fixed}\nTotal URLs to fix: ${r.total_changes}\n`;
+
+        if (r.total_changes === 0) {
+            msg += '\nAll internal URLs already have trailing slashes.';
+        } else {
+            r.results.forEach(p => {
+                msg += `\n--- ${p.title} [${p.post_type}] (ID: ${p.post_id}) — ${p.count} change(s) ---\n`;
+                p.changes.forEach(c => {
+                    const loc = c.source === 'elementor'
+                        ? `[${c.widget}] ${c.field}`
+                        : c.source === 'elementor_html'
+                        ? `[${c.widget}] HTML`
+                        : '[post_content]';
+                    msg += `  ${loc}: ${c.old}  →  ${c.new}\n`;
+                });
+            });
+            if (r.dry_run) msg += '\n(Dry run — run again with dry_run=false to apply changes.)';
+        }
+        return ok(msg);
+    }
+
     case 'fix_links': {
         const body = {};
         if (args.page_id) body.page_id = args.page_id;
@@ -2957,13 +3033,19 @@ async function handleToolCall(name, args) {
 
     case 'check_links': {
         const params = new URLSearchParams();
-        if (args.page_id) params.set('page_id', args.page_id);
+        if (args.page_id)       params.set('page_id', args.page_id);
+        if (args.force_refresh) params.set('force_refresh', '1');
         const qs = params.toString() ? `?${params.toString()}` : '';
         const r = await apiCall(`/check-links${qs}`);
         if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
 
+        const cacheNote = r.from_cache > 0
+            ? `${r.from_cache} from cache (${r.cache_ttl_hours}h TTL), ${r.freshly_fetched} freshly fetched`
+            : `${r.freshly_fetched} freshly fetched (cache empty)`;
+
         let msg = `=== BROKEN LINK CHECK ===\n`;
-        msg += `URLs checked: ${r.urls_checked} | Broken: ${r.broken_count} | Pages scanned: ${r.pages_scanned}\n`;
+        msg += `Pages scanned: ${r.pages_scanned} | URLs checked: ${r.urls_checked} | Broken: ${r.broken_count}\n`;
+        msg += `Cache: ${cacheNote}\n`;
 
         if (r.broken_count === 0) {
             msg += '\nAll links are working!';
@@ -2980,6 +3062,35 @@ async function handleToolCall(name, args) {
         return ok(msg);
     }
 
+    case 'clear_link_cache': {
+        const r = await apiCall('/link-cache', 'DELETE');
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        return ok(r.message);
+    }
+
+    case 'warm_link_cache': {
+        const body = {};
+        if (args.force_refresh) body.force_refresh = true;
+        const r = await apiCall('/warm-link-cache', 'POST', body);
+        if (r.code || r.error) return ok(`Failed: ${r.message || r.error || 'Unknown error'}`);
+        if (!r.success) return ok(`Could not warm cache: ${r.message}`);
+
+        let msg = `=== LINK CACHE WARMED ===\n`;
+        msg += `Sitemap: ${r.sitemap_url}\n`;
+        msg += `URLs in sitemap: ${r.urls_in_sitemap}\n`;
+        msg += `Freshly checked: ${r.warmed}\n`;
+        msg += `Skipped (already cached): ${r.skipped_cached}\n`;
+        msg += `Cache TTL: ${r.cache_ttl_hours}h\n`;
+        if (r.broken_found > 0) {
+            msg += `\n⚠️  ${r.broken_found} broken/unreachable URLs found:\n`;
+            r.broken_urls.forEach(u => { msg += `  ${u}\n`; });
+        } else {
+            msg += `\nAll URLs returned 2xx/3xx — no broken links detected.`;
+        }
+        msg += `\nNext check_links call will use this cache and return instantly.`;
+        return ok(msg);
+    }
+
     // ── Posts CRUD ──
 
     case 'list_posts': {

package/package.json

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