@dynamicu/chromedebug-mcp 2.7.6 → 2.7.7

package/README.md

@@ -126,17 +126,35 @@ Add to `~/.claude/config.json`:
 </details>
 
 <details>
-<summary><strong>PRO Installation</strong></summary>
+<summary><strong>Troubleshooting</strong></summary>
 
-After purchasing, run:
+### Running the Server Manually
+
+If the MCP server isn't starting automatically, you can run it directly:
 
 ```bash
-chromedebug-mcp install-pro \
-  --license YOUR_LICENSE_KEY \
-  --extension-path ~/Downloads/chromedebug-extension-pro.zip
+# Start the MCP server
+chromedebug-mcp
+
+# With verbose logging (shows connection details)
+chromedebug-mcp --verbose
+
+# View all options
+chromedebug-mcp --help
 ```
 
-[Watch PRO Installation Video](https://youtu.be/TBjj5FA8DRg)
+### Common Issues
+
+**Server not connecting?**
+1. Ensure Chrome is closed before launching
+2. Run `chromedebug-mcp --verbose` to see detailed logs
+3. Check that port 3001 (or configured port) is available
+
+**Extension not communicating?**
+1. Check the extension popup shows "Connected" status
+2. Reload the extension in `chrome://extensions/`
+3. Restart Chrome with a fresh profile
+
 </details>
 
 ---
@@ -154,8 +172,6 @@ chromedebug-mcp install-pro \
 - 📺 [Demo Video](https://youtu.be/2Y9nIsvEjks)
 - 🌐 [Chrome Extension](https://chromewebstore.google.com/detail/chromedebug-mcp-assistant/lemgbmdnephoaniipapgeciebfeakffn)
 - 💎 [Get PRO](https://chromedebug.com/checkout/buy/996773cb-682b-430f-b9e3-9ce2130bd967)
-- 🐛 [Report Issues](https://github.com/dynamicupgrade/ChromeDebug/issues)
-- 💬 [Discussions](https://github.com/dynamicupgrade/ChromeDebug/discussions)
 
 ---
 

package/chrome-extension/background.js

@@ -10,6 +10,7 @@ importScripts('upload-manager.js');
 importScripts('chrome-session-manager.js');
 importScripts('console-interception-library.js'); // Shared console interception library
 importScripts('browser-recording-manager.js');
+importScripts('plugin-registry.js'); // Plugin system for extensible site-specific features
 
 const CONFIG_PORTS = CHROMEDEBUG_CONFIG.ports;
 const DISCOVERY_TIMEOUT = CHROMEDEBUG_CONFIG.discoveryTimeout;
@@ -769,6 +770,7 @@ let logStreamer = null;
 let logBuffer = null;
 let browserRecordingManager = null;
 let serverMode = 'unknown'; // 'server', 'browser-only', or 'unknown'
+let pluginRegistry = null; // Plugin system registry for site-specific features
 
 // Error handling state and configuration
 // IMPORTANT: These must be declared before initializeServices()
@@ -891,6 +893,16 @@ async function initializeServices() {
       browserRecordingManager = null;
     }
 
+    // Initialize plugin registry for site-specific features
+    try {
+      pluginRegistry = new PluginRegistry();
+      await pluginRegistry.initialize();
+      console.log('[Background] Plugin registry initialized with', pluginRegistry.getAllPlugins().length, 'plugins');
+    } catch (pluginErr) {
+      console.error('[Background] Failed to initialize plugin registry:', pluginErr);
+      pluginRegistry = null;
+    }
+
     // Initialize session manager with recovery
     try {
       if (!sessionManager) {
@@ -1390,6 +1402,214 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
       });
       return true; // Async response
 
+    // ============================================================
+    // Plugin System Message Handlers
+    // ============================================================
+
+    case 'GET_PLUGINS_FOR_URL':
+      // Get plugins that match the current page URL
+      if (pluginRegistry && message.url) {
+        const matchingPlugins = pluginRegistry.getPluginsForUrl(message.url);
+        sendResponse({
+          success: true,
+          plugins: matchingPlugins.map(p => ({
+            pluginId: p.pluginId,
+            name: p.manifest.name,
+            version: p.manifest.version,
+            menuItems: p.manifest.menuItems || [],
+            site: p.site
+          }))
+        });
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized or URL missing' });
+      }
+      break;
+
+    case 'REGISTER_PLUGIN':
+      // Register a new plugin from its manifest
+      if (pluginRegistry && message.manifest) {
+        pluginRegistry.registerPlugin(message.manifest).then(result => {
+          sendResponse(result);
+        }).catch(error => {
+          console.error('[Background] Failed to register plugin:', error);
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized or manifest missing' });
+      }
+      break;
+
+    case 'UNREGISTER_PLUGIN':
+      // Unregister a plugin by ID
+      if (pluginRegistry && message.pluginId) {
+        pluginRegistry.unregisterPlugin(message.pluginId).then(result => {
+          sendResponse(result);
+        }).catch(error => {
+          console.error('[Background] Failed to unregister plugin:', error);
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized or pluginId missing' });
+      }
+      break;
+
+    case 'GET_ALL_PLUGINS':
+    case 'GET_REGISTERED_PLUGINS':
+      // Get all registered plugins
+      if (pluginRegistry) {
+        const allPlugins = pluginRegistry.getAllPlugins();
+        sendResponse({
+          success: true,
+          plugins: allPlugins.map(p => ({
+            pluginId: p.pluginId,
+            name: p.name,
+            version: p.version,
+            status: p.status || 'enabled',
+            sitePatterns: p.sitePatterns,
+            menuItems: p.menuItems,
+            serverLoaded: p.serverLoaded,
+            registeredAt: p.registeredAt
+          })),
+          registryState: pluginRegistry.exportState()
+        });
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized' });
+      }
+      break;
+
+    case 'ENABLE_PLUGIN':
+      // Enable a plugin by ID
+      if (pluginRegistry && message.pluginId) {
+        pluginRegistry.enablePlugin(message.pluginId).then(result => {
+          sendResponse(result);
+        }).catch(error => {
+          console.error('[Background] Failed to enable plugin:', error);
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized or pluginId missing' });
+      }
+      break;
+
+    case 'DISABLE_PLUGIN':
+      // Disable a plugin by ID
+      if (pluginRegistry && message.pluginId) {
+        pluginRegistry.disablePlugin(message.pluginId).then(result => {
+          sendResponse(result);
+        }).catch(error => {
+          console.error('[Background] Failed to disable plugin:', error);
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized or pluginId missing' });
+      }
+      break;
+
+    case 'SYNC_PLUGINS_WITH_SERVER':
+      // Sync plugins with Chrome Debug MCP server
+      if (pluginRegistry) {
+        const port = message.port || CONFIG_PORTS[0];
+        pluginRegistry.syncWithServer(port).then(result => {
+          sendResponse(result);
+        }).catch(error => {
+          console.error('[Background] Failed to sync plugins with server:', error);
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized' });
+      }
+      break;
+
+    case 'EXECUTE_PLUGIN_ACTION':
+      // Execute a plugin menu action (routes to server)
+      if (message.pluginId && message.actionId) {
+        // Find the active server port and route the action
+        discoverActiveServerPort().then(async (serverPort) => {
+          if (!serverPort) {
+            sendResponse({ success: false, error: 'Chrome Debug server not available' });
+            return;
+          }
+
+          try {
+            const response = await fetch(`http://localhost:${serverPort}/chromedebug/plugins/${message.pluginId}/execute`, {
+              method: 'POST',
+              headers: { 'Content-Type': 'application/json' },
+              body: JSON.stringify({
+                actionId: message.actionId,
+                context: message.context || {},
+                tabId: sender.tab?.id
+              })
+            });
+
+            const result = await response.json();
+            sendResponse(result);
+          } catch (error) {
+            console.error('[Background] Failed to execute plugin action:', error);
+            sendResponse({ success: false, error: error.message });
+          }
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Missing pluginId or actionId' });
+      }
+      break;
+
+    case 'IMPORT_PLUGIN_FROM_FILE':
+      // Import plugin manifest from a file (via popup)
+      // Accepts either: manifest (object) or manifestJson (string)
+      {
+        let manifest = null;
+        if (message.manifest && typeof message.manifest === 'object') {
+          manifest = message.manifest;
+        } else if (message.manifestJson) {
+          try {
+            manifest = JSON.parse(message.manifestJson);
+          } catch (parseError) {
+            sendResponse({ success: false, error: 'Invalid JSON: ' + parseError.message });
+            break;
+          }
+        }
+
+        if (!manifest) {
+          sendResponse({ success: false, error: 'No manifest provided' });
+          break;
+        }
+
+        if (pluginRegistry) {
+          pluginRegistry.registerPlugin(manifest).then(result => {
+            if (result.success) {
+              console.log('[Background] Plugin imported:', result.pluginId);
+            }
+            sendResponse(result);
+          }).catch(error => {
+            sendResponse({ success: false, error: error.message });
+          });
+          return true; // Async response
+        } else {
+          sendResponse({ success: false, error: 'Plugin registry not initialized' });
+        }
+      }
+      break;
+
+    case 'CLEAR_ALL_PLUGINS':
+      // Clear all plugins (for testing/reset)
+      if (pluginRegistry) {
+        pluginRegistry.clearAll().then(() => {
+          sendResponse({ success: true, message: 'All plugins cleared' });
+        }).catch(error => {
+          sendResponse({ success: false, error: error.message });
+        });
+        return true; // Async response
+      } else {
+        sendResponse({ success: false, error: 'Plugin registry not initialized' });
+      }
+      break;
+
     default:
       // Don't warn or respond for messages that should be handled by other listener (v2.0.6)
       // This prevents intercepting workflow recording messages

package/chrome-extension/popup.html

@@ -240,6 +240,41 @@
         </div>
   </div>
 
+  <!-- Plugins Section -->
+  <div id="plugins-section" style="padding: 8px; border: 1px solid #ccc; background: #f9f9f9; border-radius: 4px; margin-bottom: 15px;">
+    <details id="plugins-details">
+      <summary style="cursor: pointer; font-size: 12px; font-weight: bold; color: #333; display: flex; align-items: center; gap: 8px;">
+        <span>🔌 Plugins</span>
+        <span id="plugins-count-badge" style="background: #e0e0e0; color: #666; font-size: 10px; padding: 2px 6px; border-radius: 10px; font-weight: normal;">0</span>
+        <span style="flex: 1;"></span>
+        <button id="sync-plugins-btn" style="font-size: 9px; padding: 2px 6px; background: #2196F3; color: white; border: none; border-radius: 3px; cursor: pointer;" title="Sync with server">🔄 Sync</button>
+      </summary>
+
+      <div style="margin-top: 8px;">
+        <!-- Import Plugin Button -->
+        <div style="display: flex; gap: 6px; margin-bottom: 8px;">
+          <button id="import-plugin-btn" style="flex: 1; padding: 6px; font-size: 10px; background: linear-gradient(135deg, #4285f4 0%, #34a853 100%); color: white; border: none; border-radius: 4px; cursor: pointer;">
+            📥 Import Plugin
+          </button>
+          <input type="file" id="plugin-file-input" accept=".json" style="display: none;">
+        </div>
+
+        <!-- Plugins List -->
+        <div id="plugins-list" style="max-height: 200px; overflow-y: auto;">
+          <div id="no-plugins-message" style="text-align: center; padding: 12px; color: #888; font-size: 11px;">
+            No plugins installed. Import a plugin manifest to get started.
+          </div>
+          <div id="plugins-container"></div>
+        </div>
+
+        <!-- Sync Status -->
+        <div id="plugins-sync-status" style="font-size: 9px; color: #888; margin-top: 6px; text-align: center; display: none;">
+          Last synced: <span id="plugins-last-sync">Never</span>
+        </div>
+      </div>
+    </details>
+  </div>
+
   <!-- 2-Column Layout for Recordings -->
   <div style="display: grid; grid-template-columns: 50% 50%; gap: 6px; box-sizing: border-box; overflow: hidden; max-width: 100%; margin-bottom: 60px;">
 

package/chrome-extension/popup.js

@@ -2933,8 +2933,267 @@ document.addEventListener('DOMContentLoaded', () => {
       clearTimeout(screenshotQualityDebounceTimer);
     }
   });
+
+  // ========================================
+  // Plugin Management UI Initialization
+  // ========================================
+  initializePluginUI();
 });
 
+// ========================================
+// Plugin Management Functions
+// ========================================
+
+/**
+ * Initialize plugin UI event handlers and load plugins
+ */
+function initializePluginUI() {
+  const importBtn = document.getElementById('import-plugin-btn');
+  const fileInput = document.getElementById('plugin-file-input');
+  const syncBtn = document.getElementById('sync-plugins-btn');
+
+  // Import button -> trigger file input
+  if (importBtn && fileInput) {
+    importBtn.addEventListener('click', () => {
+      fileInput.click();
+    });
+
+    // Handle file selection
+    fileInput.addEventListener('change', async (e) => {
+      const file = e.target.files[0];
+      if (!file) return;
+
+      try {
+        const text = await file.text();
+        const manifest = JSON.parse(text);
+
+        // Validate required fields
+        if (!manifest.pluginId || !manifest.name) {
+          showToast('Invalid plugin manifest: missing pluginId or name', 3000, 'error');
+          return;
+        }
+
+        // Send to background for registration
+        const response = await chrome.runtime.sendMessage({
+          action: 'IMPORT_PLUGIN_FROM_FILE',
+          manifest: manifest
+        });
+
+        if (response && response.success) {
+          showToast('Plugin "' + manifest.name + '" imported successfully!', 3000, 'success');
+          loadPluginsList();
+        } else {
+          showToast(response?.error || 'Failed to import plugin', 3000, 'error');
+        }
+      } catch (err) {
+        console.error('Error importing plugin:', err);
+        showToast('Invalid JSON file', 3000, 'error');
+      }
+
+      // Reset file input for next import
+      fileInput.value = '';
+    });
+  }
+
+  // Sync button -> sync with server
+  if (syncBtn) {
+    syncBtn.addEventListener('click', async () => {
+      syncBtn.disabled = true;
+      syncBtn.textContent = '\u231B';
+
+      try {
+        const response = await chrome.runtime.sendMessage({
+          action: 'SYNC_PLUGINS_WITH_SERVER'
+        });
+
+        if (response && response.success) {
+          const syncStatus = document.getElementById('plugins-sync-status');
+          const lastSync = document.getElementById('plugins-last-sync');
+          if (syncStatus && lastSync) {
+            syncStatus.style.display = 'block';
+            lastSync.textContent = new Date().toLocaleTimeString();
+          }
+          showToast('Synced ' + (response.count || 0) + ' plugins', 2000, 'success');
+          loadPluginsList();
+        } else {
+          showToast(response?.error || 'Sync failed', 3000, 'error');
+        }
+      } catch (err) {
+        console.error('Error syncing plugins:', err);
+        showToast('Failed to connect to server', 3000, 'error');
+      }
+
+      syncBtn.disabled = false;
+      syncBtn.textContent = '\uD83D\uDD04 Sync';
+    });
+  }
+
+  // Load plugins on startup
+  loadPluginsList();
+}
+
+/**
+ * Load and display registered plugins
+ */
+async function loadPluginsList() {
+  const pluginsContainer = document.getElementById('plugins-container');
+  const noPluginsMessage = document.getElementById('no-plugins-message');
+  const pluginsCountBadge = document.getElementById('plugins-count-badge');
+
+  if (!pluginsContainer) return;
+
+  try {
+    const response = await chrome.runtime.sendMessage({
+      action: 'GET_REGISTERED_PLUGINS'
+    });
+
+    const plugins = response?.plugins || [];
+
+    // Update count badge
+    if (pluginsCountBadge) {
+      pluginsCountBadge.textContent = plugins.length.toString();
+      pluginsCountBadge.style.background = plugins.length > 0 ? '#4CAF50' : '#e0e0e0';
+      pluginsCountBadge.style.color = plugins.length > 0 ? 'white' : '#666';
+    }
+
+    // Show/hide no plugins message
+    if (noPluginsMessage) {
+      noPluginsMessage.style.display = plugins.length === 0 ? 'block' : 'none';
+    }
+
+    // Clear container safely
+    while (pluginsContainer.firstChild) {
+      pluginsContainer.removeChild(pluginsContainer.firstChild);
+    }
+
+    plugins.forEach(plugin => {
+      const pluginEl = createPluginElement(plugin);
+      pluginsContainer.appendChild(pluginEl);
+    });
+  } catch (err) {
+    console.error('Error loading plugins:', err);
+  }
+}
+
+/**
+ * Create DOM element for a plugin using safe DOM methods
+ */
+function createPluginElement(plugin) {
+  const el = document.createElement('div');
+  el.style.cssText = 'padding: 8px; border: 1px solid #ddd; border-radius: 4px; margin-bottom: 6px; background: white;';
+
+  const isEnabled = plugin.status !== 'disabled';
+  const statusColor = isEnabled ? '#4CAF50' : '#999';
+
+  // Main row container
+  const mainRow = document.createElement('div');
+  mainRow.style.cssText = 'display: flex; justify-content: space-between; align-items: center;';
+
+  // Left side: name and version
+  const infoDiv = document.createElement('div');
+
+  const nameSpan = document.createElement('span');
+  nameSpan.style.cssText = 'font-weight: bold; font-size: 11px;';
+  nameSpan.textContent = plugin.name || plugin.pluginId;
+
+  const versionSpan = document.createElement('span');
+  versionSpan.style.cssText = 'font-size: 9px; color: #888; margin-left: 4px;';
+  versionSpan.textContent = 'v' + (plugin.version || '1.0.0');
+
+  infoDiv.appendChild(nameSpan);
+  infoDiv.appendChild(versionSpan);
+
+  // Right side: status and buttons
+  const buttonsDiv = document.createElement('div');
+  buttonsDiv.style.cssText = 'display: flex; gap: 4px; align-items: center;';
+
+  // Status indicator
+  const statusDot = document.createElement('span');
+  statusDot.style.cssText = 'width: 8px; height: 8px; border-radius: 50%; background: ' + statusColor + ';';
+
+  // Toggle button
+  const toggleBtn = document.createElement('button');
+  toggleBtn.className = 'plugin-toggle-btn';
+  toggleBtn.dataset.pluginId = plugin.pluginId;
+  toggleBtn.dataset.enabled = isEnabled.toString();
+  toggleBtn.style.cssText = 'font-size: 9px; padding: 2px 6px; background: ' + (isEnabled ? '#ff9800' : '#4CAF50') + '; color: white; border: none; border-radius: 3px; cursor: pointer;';
+  toggleBtn.textContent = isEnabled ? 'Disable' : 'Enable';
+
+  // Remove button
+  const removeBtn = document.createElement('button');
+  removeBtn.className = 'plugin-remove-btn';
+  removeBtn.dataset.pluginId = plugin.pluginId;
+  removeBtn.style.cssText = 'font-size: 9px; padding: 2px 6px; background: #f44336; color: white; border: none; border-radius: 3px; cursor: pointer;';
+  removeBtn.textContent = '\u2715';
+
+  buttonsDiv.appendChild(statusDot);
+  buttonsDiv.appendChild(toggleBtn);
+  buttonsDiv.appendChild(removeBtn);
+
+  mainRow.appendChild(infoDiv);
+  mainRow.appendChild(buttonsDiv);
+  el.appendChild(mainRow);
+
+  // Site patterns info (if any)
+  if (plugin.sitePatterns && plugin.sitePatterns.length > 0) {
+    const sitesDiv = document.createElement('div');
+    sitesDiv.style.cssText = 'font-size: 9px; color: #666; margin-top: 4px;';
+    const sitesText = plugin.sitePatterns.slice(0, 2).join(', ');
+    sitesDiv.textContent = 'Sites: ' + sitesText + (plugin.sitePatterns.length > 2 ? '...' : '');
+    el.appendChild(sitesDiv);
+  }
+
+  // Toggle button handler
+  toggleBtn.addEventListener('click', async () => {
+    const pluginId = toggleBtn.dataset.pluginId;
+    const currentlyEnabled = toggleBtn.dataset.enabled === 'true';
+
+    try {
+      const response = await chrome.runtime.sendMessage({
+        action: currentlyEnabled ? 'DISABLE_PLUGIN' : 'ENABLE_PLUGIN',
+        pluginId: pluginId
+      });
+
+      if (response && response.success) {
+        loadPluginsList();
+        showToast('Plugin ' + (currentlyEnabled ? 'disabled' : 'enabled'), 2000, 'success');
+      } else {
+        showToast(response?.error || 'Operation failed', 3000, 'error');
+      }
+    } catch (err) {
+      console.error('Error toggling plugin:', err);
+    }
+  });
+
+  // Remove button handler
+  removeBtn.addEventListener('click', async () => {
+    const pluginId = removeBtn.dataset.pluginId;
+    const pluginName = plugin.name || pluginId;
+
+    if (!confirm('Remove plugin "' + pluginName + '"?')) {
+      return;
+    }
+
+    try {
+      const response = await chrome.runtime.sendMessage({
+        action: 'UNREGISTER_PLUGIN',
+        pluginId: pluginId
+      });
+
+      if (response && response.success) {
+        loadPluginsList();
+        showToast('Plugin removed', 2000, 'success');
+      } else {
+        showToast(response?.error || 'Failed to remove plugin', 3000, 'error');
+      }
+    } catch (err) {
+      console.error('Error removing plugin:', err);
+    }
+  });
+
+  return el;
+}
+
 // Function to load and display workflow recordings
 async function loadWorkflowRecordings(autoShow = false) {
   const workflowRecordingsList = document.getElementById('workflowRecordingsList');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "ChromeDebug MCP - MCP server that provides full control over a Chrome browser instance for debugging and automation with AI assistants like Claude Code",
   "main": "src/index.js",
   "type": "module",
@@ -11,14 +11,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dynamicupgrade/ChromeDebug.git"
-  },
-  "bugs": {
-    "url": "https://github.com/dynamicupgrade/ChromeDebug/issues"
-  },
-  "homepage": "https://github.com/dynamicupgrade/ChromeDebug#readme",
+  "homepage": "https://chromedebug.com",
   "scripts": {
     "cleanup": "node scripts/cleanup-processes.js",
     "cleanup-force": "node scripts/cleanup-processes.js --force",

package/scripts/diagnose-windows.js

@@ -45,8 +45,8 @@ if (process.platform === 'win32' && !process.env.WSL_DISTRO_NAME) {
 }
 console.error('');
 
-console.error('For more information:');
-console.error('  https://github.com/dynamicupgrade/ChromeDebug#windows-setup');
+console.error('For more information, see the npm package documentation:');
+console.error('  https://www.npmjs.com/package/@dynamicu/chromedebug-mcp');
 console.error('');
 
 // Exit successfully

package/scripts/postinstall.js

@@ -48,4 +48,4 @@ console.log('   Claude Code automatically starts both servers when it runs chrom
 console.log('💎 Want unlimited recordings?');
 console.log('   Upgrade to Pro: https://chromedebug.com/checkout/buy/996773cb-682b-430f-b9e3-9ce2130bd967\n');
 
-console.log('📚 Full documentation: https://github.com/dynamicupgrade/ChromeDebug#readme\n');
+console.log('📚 Full documentation: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp\n');

package/src/cli.js

@@ -68,7 +68,7 @@ Windows users have two options:
    • Then run: chromedebug-mcp
    • Note: MCP stdio communication may fail due to cmd.exe limitations
 
-For details: https://github.com/dynamicupgrade/ChromeDebug#windows-setup
+For details, see the npm package documentation at: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     process.exit(1);
   }

package/src/commands/install-pro.js

@@ -101,7 +101,7 @@ Expected formats:
 Your key: ${maskLicenseKey(key)}
 
 Please check your purchase confirmation email for the correct license key.
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
+For help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     return false;
   }
@@ -134,7 +134,7 @@ Possible causes:
 2. Disk full - check: df -h ~
 3. Home directory not writable
 
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
+For help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     return false;
   }
@@ -197,7 +197,7 @@ Please check:
 2. File exists at the specified location
 3. You have read permission
 
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
+For help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     throw err;
   }
@@ -226,7 +226,7 @@ Possible causes:
 
 Error details: ${err.message}
 
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
+For help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     throw err;
   }
@@ -254,7 +254,7 @@ Expected manifest.json with ChromeDebug name.
 
 Please verify you downloaded the correct PRO extension ZIP.
 
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
+For help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp
 `);
     throw err;
   }
@@ -561,12 +561,12 @@ This will overwrite the existing installation.`;
     console.error(`  (should output: ${EXTENSION_DIR})\n`);
 
     console.error('Installation log: ' + INSTALL_LOG);
-    console.error('\nNeed help? https://github.com/dynamicupgrade/ChromeDebug/issues\n');
+    console.error('\nFor help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp\n');
   } catch (err) {
     await logInstall(`Installation failed: ${err.message}`, true);
     console.error('\n Installation failed\n');
     console.error('Check the installation log for details: ' + INSTALL_LOG);
-    console.error('\nNeed help? https://github.com/dynamicupgrade/ChromeDebug/issues\n');
+    console.error('\nFor help, see: https://www.npmjs.com/package/@dynamicu/chromedebug-mcp\n');
     process.exit(1);
   }
 }

package/src/commands/install-pro.js.bak

@@ -1,542 +0,0 @@
-/**
- * ChromeDebug PRO License Installer
- *
- * Handles installation of PRO extension after purchase:
- * - Validates license key format
- * - Extracts PRO extension ZIP to ~/.chromedebug-pro/extension/
- * - Saves license information to ~/.chromedebug-pro/license.json
- * - Configures shell environment for CHROMEDEBUG_EXTENSION_PATH
- */
-
-import fs from 'fs/promises';
-import fsSync from 'fs';
-import path from 'path';
-import os from 'os';
-import { execSync } from 'child_process';
-import AdmZip from 'adm-zip';
-
-// Constants
-const CHROMEDEBUG_DIR = path.join(os.homedir(), '.chromedebug-pro');
-const EXTENSION_DIR = path.join(CHROMEDEBUG_DIR, 'extension');
-const LICENSE_FILE = path.join(CHROMEDEBUG_DIR, 'license.json');
-const INSTALL_LOG = path.join(CHROMEDEBUG_DIR, 'install.log');
-const ENV_VAR_NAME = 'CHROMEDEBUG_EXTENSION_PATH';
-
-// License key format: LICENSEID-HASH (e.g., ABC12345-0123456789ABCDEF)
-const LICENSE_KEY_REGEX = /^[A-Z0-9]{8,}-[A-Z0-9]{16,}$/i;
-
-/**
- * Log installation activity
- */
-async function logInstall(message, isError = false) {
-  const timestamp = new Date().toISOString();
-  const logMessage = `[${timestamp}] ${isError ? 'ERROR: ' : ''}${message}\n`;
-
-  try {
-    await fs.appendFile(INSTALL_LOG, logMessage);
-  } catch (err) {
-    // Ignore log errors - don't let logging break installation
-  }
-
-  if (isError) {
-    console.error(message);
-  } else {
-    console.log(message);
-  }
-}
-
-/**
- * Validate command-line arguments
- */
-function validateArguments(args) {
-  const licenseIndex = args.indexOf('--license');
-  const pathIndex = args.indexOf('--extension-path');
-
-  if (licenseIndex === -1 || pathIndex === -1) {
-    console.error(`
-ChromeDebug PRO License Installer
-
-Usage:
-  chromedebug-mcp install-pro --license YOUR_LICENSE_KEY --extension-path /path/to/chromedebug-pro-extension.zip
-
-Required Arguments:
-  --license          Your PRO license key (received after purchase)
-  --extension-path   Path to the PRO extension ZIP file
-
-Example:
-  chromedebug-mcp install-pro \\
-    --license ABC12345-0123456789ABCDEF \\
-    --extension-path ~/Downloads/chromedebug-pro-extension.zip
-
-Get PRO: https://chromedebug.com/pro
-`);
-    return null;
-  }
-
-  const license = args[licenseIndex + 1];
-  const extensionPath = args[pathIndex + 1];
-
-  if (!license || !extensionPath) {
-    console.error('Error: Missing values for --license or --extension-path');
-    return null;
-  }
-
-  return { license, extensionPath };
-}
-
-/**
- * Validate license key format
- */
-function validateLicenseKey(key) {
-  if (!LICENSE_KEY_REGEX.test(key)) {
-    console.error(`
-Error: Invalid license key format
-
-Expected format: LICENSEID-HASH
-Example: ABC12345-0123456789ABCDEF
-
-Your key: ${maskLicenseKey(key)}
-
-Please check your purchase confirmation email for the correct license key.
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
-`);
-    return false;
-  }
-  return true;
-}
-
-/**
- * Mask license key for display (show first 6 and last 3 chars)
- */
-function maskLicenseKey(key) {
-  if (key.length <= 9) return '***';
-  return `${key.substring(0, 6)}...${key.substring(key.length - 3)}`;
-}
-
-/**
- * Check pre-flight conditions
- */
-async function preflightChecks() {
-  // Check write permission to home directory
-  try {
-    const testFile = path.join(os.homedir(), '.chromedebug-test');
-    await fs.writeFile(testFile, 'test');
-    await fs.unlink(testFile);
-  } catch (err) {
-    console.error(`
-Error: Cannot write to home directory
-
-Possible causes:
-1. Permission denied - check: ls -ld ~
-2. Disk full - check: df -h ~
-3. Home directory not writable
-
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
-`);
-    return false;
-  }
-
-  return true;
-}
-
-/**
- * Check for existing installation
- */
-async function checkExistingInstallation() {
-  try {
-    const stats = await fs.stat(LICENSE_FILE);
-    if (stats.isFile()) {
-      const licenseData = JSON.parse(await fs.readFile(LICENSE_FILE, 'utf-8'));
-      return {
-        exists: true,
-        installed_at: licenseData.installed_at,
-        extension_version: licenseData.extension_version,
-        license_key: licenseData.license_key
-      };
-    }
-  } catch (err) {
-    // No existing installation
-  }
-  return { exists: false };
-}
-
-/**
- * Prompt for confirmation (synchronous for CLI)
- */
-function promptConfirmation(message) {
-  // For now, we'll auto-continue with a warning
-  // In future, could add readline for interactive prompts
-  console.log(`\n${message}`);
-  console.log('Continuing with installation...\n');
-  return true;
-}
-
-/**
- * Extract and validate ZIP file
- */
-async function extractExtension(zipPath, targetPath) {
-  // Resolve path (handle ~ and relative paths)
-  const resolvedZipPath = zipPath.startsWith('~')
-    ? path.join(os.homedir(), zipPath.slice(1))
-    : path.resolve(zipPath);
-
-  // Check if ZIP exists
-  try {
-    await fs.access(resolvedZipPath);
-  } catch (err) {
-    console.error(`
-Error: Extension ZIP file not found
-
-Path: ${resolvedZipPath}
-
-Please check:
-1. File path is correct
-2. File exists at the specified location
-3. You have read permission
-
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
-`);
-    throw err;
-  }
-
-  // Create target directory (clean if exists)
-  try {
-    await fs.rm(targetPath, { recursive: true, force: true });
-  } catch (err) {
-    // Ignore - directory might not exist
-  }
-
-  await fs.mkdir(targetPath, { recursive: true });
-
-  // Extract ZIP
-  try {
-    const zip = new AdmZip(resolvedZipPath);
-    zip.extractAllTo(targetPath, true);
-  } catch (err) {
-    console.error(`
-Error: Failed to extract ZIP file
-
-Possible causes:
-1. ZIP file is corrupted - try re-downloading
-2. Not a valid ZIP file
-3. Disk space full
-
-Error details: ${err.message}
-
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
-`);
-    throw err;
-  }
-
-  // Validate extracted contents
-  const manifestPath = path.join(targetPath, 'manifest.json');
-  try {
-    const manifestContent = await fs.readFile(manifestPath, 'utf-8');
-    const manifest = JSON.parse(manifestContent);
-
-    if (!manifest.name || !manifest.name.toLowerCase().includes('chromedebug')) {
-      throw new Error('Extension does not appear to be ChromeDebug');
-    }
-
-    return {
-      version: manifest.version,
-      name: manifest.name
-    };
-  } catch (err) {
-    console.error(`
-Error: Invalid extension package
-
-The extracted files do not appear to be a valid ChromeDebug extension.
-Expected manifest.json with ChromeDebug name.
-
-Please verify you downloaded the correct PRO extension ZIP.
-
-Need help? https://github.com/dynamicupgrade/ChromeDebug/issues
-`);
-    throw err;
-  }
-}
-
-/**
- * Save license information
- */
-async function saveLicenseInfo(license, extensionVersion) {
-  const licenseData = {
-    license_key: license,
-    installed_at: new Date().toISOString(),
-    extension_version: extensionVersion,
-    extension_path: EXTENSION_DIR
-  };
-
-  await fs.writeFile(LICENSE_FILE, JSON.stringify(licenseData, null, 2), 'utf-8');
-
-  // Set restrictive permissions (owner read/write only)
-  await fs.chmod(LICENSE_FILE, 0o600);
-}
-
-/**
- * Detect user's shell
- */
-function detectShell() {
-  try {
-    const shell = process.env.SHELL || '';
-
-    if (shell.includes('zsh')) return 'zsh';
-    if (shell.includes('bash')) return 'bash';
-    if (shell.includes('fish')) return 'fish';
-
-    // Default to bash
-    return 'bash';
-  } catch (err) {
-    return 'bash';
-  }
-}
-
-/**
- * Get shell configuration file path
- */
-function getShellConfigFile(shell) {
-  const home = os.homedir();
-
-  switch (shell) {
-    case 'zsh':
-      return path.join(home, '.zshrc');
-    case 'bash':
-      // Prefer .bashrc on Linux, .bash_profile on macOS
-      if (process.platform === 'darwin') {
-        return path.join(home, '.bash_profile');
-      }
-      return path.join(home, '.bashrc');
-    case 'fish':
-      return path.join(home, '.config', 'fish', 'config.fish');
-    default:
-      return path.join(home, '.bashrc');
-  }
-}
-
-/**
- * Check if environment variable is already configured
- */
-async function checkIfAlreadyConfigured(configFile) {
-  try {
-    const content = await fs.readFile(configFile, 'utf-8');
-    const envVarLine = `export ${ENV_VAR_NAME}=`;
-
-    if (content.includes(envVarLine)) {
-      // Check if it's the correct path
-      const regex = new RegExp(`export ${ENV_VAR_NAME}=["']?([^"'\\n]+)["']?`);
-      const match = content.match(regex);
-
-      if (match && match[1]) {
-        const currentPath = match[1].replace(/^~/, os.homedir());
-        const targetPath = EXTENSION_DIR;
-
-        if (path.resolve(currentPath) === path.resolve(targetPath)) {
-          return { configured: true, needsUpdate: false, currentPath };
-        } else {
-          return { configured: true, needsUpdate: true, currentPath };
-        }
-      }
-    }
-  } catch (err) {
-    // File doesn't exist or can't be read
-  }
-
-  return { configured: false, needsUpdate: false };
-}
-
-/**
- * Update shell configuration
- */
-async function updateShellConfig(configFile, envVarValue) {
-  // Create backup
-  const backupFile = `${configFile}.chromedebug-backup`;
-  try {
-    await fs.copyFile(configFile, backupFile);
-  } catch (err) {
-    // Config file might not exist yet
-  }
-
-  // Read existing content
-  let content = '';
-  try {
-    content = await fs.readFile(configFile, 'utf-8');
-  } catch (err) {
-    // File doesn't exist, create new
-    if (configFile.includes('.bash')) {
-      content = '#!/bin/bash\n\n';
-    } else if (configFile.includes('.zsh')) {
-      content = '#!/bin/zsh\n\n';
-    }
-  }
-
-  // Check if already configured
-  const status = await checkIfAlreadyConfigured(configFile);
-
-  if (status.configured && !status.needsUpdate) {
-    return { updated: false, reason: 'already_configured' };
-  }
-
-  // Add or update environment variable
-  const envVarLine = `export ${ENV_VAR_NAME}="${envVarValue}"`;
-  const commentLine = '# ChromeDebug PRO extension path';
-
-  if (status.configured && status.needsUpdate) {
-    // Update existing line
-    const regex = new RegExp(`export ${ENV_VAR_NAME}=["']?[^"'\\n]+["']?`, 'g');
-    content = content.replace(regex, envVarLine);
-  } else {
-    // Add new lines
-    if (!content.endsWith('\n')) {
-      content += '\n';
-    }
-    content += `\n${commentLine}\n${envVarLine}\n`;
-  }
-
-  // Write updated content
-  await fs.writeFile(configFile, content, 'utf-8');
-
-  // Ensure proper permissions
-  await fs.chmod(configFile, 0o644);
-
-  return { updated: true, reason: status.needsUpdate ? 'updated' : 'added' };
-}
-
-/**
- * Configure shell environment
- */
-async function configureShell() {
-  const shell = detectShell();
-  const configFile = getShellConfigFile(shell);
-
-  await logInstall(`Detected shell: ${shell}`);
-  await logInstall(`Config file: ${configFile}`);
-
-  // Ensure config directory exists (for fish)
-  const configDir = path.dirname(configFile);
-  await fs.mkdir(configDir, { recursive: true });
-
-  // Update configuration
-  const result = await updateShellConfig(configFile, EXTENSION_DIR);
-
-  return { shell, configFile, ...result };
-}
-
-/**
- * Main installation flow
- */
-export async function installPro(args) {
-  console.log('\nChromeDebug PRO License Installer\n');
-
-  try {
-    // Create ChromeDebug directory
-    await fs.mkdir(CHROMEDEBUG_DIR, { recursive: true });
-
-    // Start logging
-    await logInstall('=== Installation Started ===');
-
-    // 1. Validate arguments
-    const parsedArgs = validateArguments(args);
-    if (!parsedArgs) {
-      return process.exit(1);
-    }
-
-    const { license, extensionPath } = parsedArgs;
-
-    // 2. Validate license key
-    console.log('Validating license key...');
-    if (!validateLicenseKey(license)) {
-      await logInstall(`Invalid license key: ${maskLicenseKey(license)}`, true);
-      return process.exit(1);
-    }
-    await logInstall(`License key validated: ${maskLicenseKey(license)}`);
-    console.log(` License key validated: ${maskLicenseKey(license)}\n`);
-
-    // 3. Pre-flight checks
-    if (!(await preflightChecks())) {
-      await logInstall('Pre-flight checks failed', true);
-      return process.exit(1);
-    }
-
-    // 4. Check for existing installation
-    const existing = await checkExistingInstallation();
-    if (existing.exists) {
-      const message = `
-Existing PRO installation found:
-- Installed: ${new Date(existing.installed_at).toLocaleDateString()}
-- Version: ${existing.extension_version}
-- License: ${maskLicenseKey(existing.license_key)}
-
-This will overwrite the existing installation.`;
-
-      promptConfirmation(message);
-      await logInstall('Overwriting existing installation');
-    }
-
-    // 5. Extract extension
-    console.log('Extracting PRO extension...');
-    const extensionInfo = await extractExtension(extensionPath, EXTENSION_DIR);
-    await logInstall(`Extension extracted: ${extensionInfo.name} v${extensionInfo.version}`);
-    console.log(` PRO extension extracted to ${EXTENSION_DIR}`);
-    console.log(`  Version: ${extensionInfo.version}\n`);
-
-    // Set extension directory permissions
-    await fs.chmod(EXTENSION_DIR, 0o755);
-
-    // 6. Save license information
-    console.log('Saving license information...');
-    await saveLicenseInfo(license, extensionInfo.version);
-    await logInstall(`License saved: ${maskLicenseKey(license)}`);
-    console.log(` License saved to ${LICENSE_FILE}\n`);
-
-    // 7. Configure shell environment
-    console.log('Configuring shell environment...');
-    let shellResult;
-    let shellConfigFailed = false;
-
-    try {
-      shellResult = await configureShell();
-      await logInstall(`Shell configured: ${shellResult.shell} (${shellResult.configFile})`);
-
-      if (shellResult.updated) {
-        console.log(` Shell configured: export ${ENV_VAR_NAME}="${EXTENSION_DIR}"`);
-        console.log(`  Config file: ${shellResult.configFile}`);
-        console.log(`  Backup saved: ${shellResult.configFile}.chromedebug-backup\n`);
-      } else {
-        console.log(` Shell already configured correctly\n`);
-      }
-    } catch (shellErr) {
-      shellConfigFailed = true;
-      await logInstall(`Shell configuration failed: ${shellErr.message}`, false);
-      console.log(`⚠ Could not automatically configure shell environment`);
-      console.log(`  Error: ${shellErr.message}\n`);
-    }
-
-    // 8. Success!
-    await logInstall('=== Installation Completed Successfully ===');
-
-    console.log('

















































');
-    console.log('PRO features are now active!');
-    console.log('

















































\n');
-
-    console.log('Next steps:');
-    console.log(`1. Restart your terminal or run: source ${shellResult.configFile}`);
-    console.log('2. Close any running Chrome instances');
-    console.log('3. Launch ChromeDebug MCP: chromedebug-mcp');
-    console.log('4. The PRO extension will be loaded automatically\n');
-
-    console.log('Verify installation:');
-    console.log(`  echo $${ENV_VAR_NAME}`);
-    console.log(`  (should output: ${EXTENSION_DIR})\n`);
-
-    console.log('Installation log: ' + INSTALL_LOG);
-    console.log('\nNeed help? https://github.com/dynamicupgrade/ChromeDebug/issues\n');
-
-  } catch (err) {
-    await logInstall(`Installation failed: ${err.message}`, true);
-    console.error('\n Installation failed\n');
-    console.error('Check the installation log for details: ' + INSTALL_LOG);
-    console.error('\nNeed help? https://github.com/dynamicupgrade/ChromeDebug/issues\n');
-    process.exit(1);
-  }
-}