@noleemits/vision-builder-control-mcp 4.5.7 → 4.5.11

package/index.js

@@ -30,7 +30,7 @@
  *
  * WordPress plugin: Noleemits Vision Builder Control (nvbc/v1 REST endpoints)
  *
- * Version: 4.4.0
+ * Version: 4.5.11
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -94,8 +94,8 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.5.7';
-const MIN_PLUGIN_VERSION = '4.5.7'; // Minimum WP plugin version required by this MCP server
+const VERSION = '4.5.11';
+const MIN_PLUGIN_VERSION = '4.5.11'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
 // PARAMETER HELPERS
@@ -1807,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. Recommended for speed.' }
+                    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: {
+                    force_refresh: { type: 'boolean', description: 'Re-check even URLs already in cache. Default: false (skips fresh entries).' }
                 }
             }
         },
@@ -3017,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!';
@@ -3040,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.7",
+  "version": "4.5.11",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",