@dynamicu/chromedebug-mcp 2.5.5 → 2.5.7

package/README.md

@@ -17,6 +17,8 @@ npm install -g @dynamicu/chromedebug-mcp
 npm install @dynamicu/chromedebug-mcp
 ```
 
+> **Want unlimited recordings and advanced features?** See [Installing PRO Version](#installing-pro-version) below for automated PRO installation.
+
 ### Development Installation
 
 ```bash
@@ -26,6 +28,83 @@ cd ChromeDebug
 npm install
 ```
 
+## Installing PRO Version
+
+ChromeDebug PRO adds advanced features including:
+- **Function call tracking** - Record and replay function execution traces
+- **Advanced debugging** - Enhanced breakpoint and inspection capabilities
+- **Unlimited recordings** - No daily recording limits
+- Priority support and updates
+
+### Installation Steps
+
+After purchasing ChromeDebug PRO from [LemonSqueezy](https://chromedebug.com/buy/996773cb-682b-430f-b9e3-9ce2130bd967):
+
+1. **Download your PRO extension** from the purchase confirmation email (you'll receive a ZIP file named `chromedebug-pro-extension.zip`)
+2. **Run the installer**:
+   ```bash
+   chromedebug-mcp install-pro \
+     --license YOUR_LICENSE_KEY \
+     --extension-path ~/Downloads/chromedebug-pro-extension.zip
+   ```
+3. **Restart your terminal** to load the new environment variable
+4. **Launch Chrome** - PRO features are now active!
+
+### What the Installer Does
+
+The `install-pro` command:
+- ✓ Validates your license key format
+- ✓ Extracts the PRO extension to `~/.chromedebug-pro/extension`
+- ✓ Saves your license information securely to `~/.chromedebug-pro/license.json`
+- ✓ Configures your shell environment automatically (exports `CHROMEDEBUG_EXTENSION_PATH`)
+- ✓ Creates an installation log at `~/.chromedebug-pro/install.log` for troubleshooting
+
+The environment variable `CHROMEDEBUG_EXTENSION_PATH` is automatically detected by Chrome Controller when launching Chrome, allowing it to load the PRO extension instead of the bundled FREE version.
+
+### Verifying PRO Installation
+
+Check that PRO is correctly installed:
+
+```bash
+# Verify environment variable is set
+echo $CHROMEDEBUG_EXTENSION_PATH
+# Should output: /Users/YOUR_USERNAME/.chromedebug-pro/extension
+
+# Check license file
+cat ~/.chromedebug-pro/license.json
+```
+
+When you launch Chrome with `chromedebug-mcp`, you should see:
+- "ChromeDebug MCP Assistant PRO" in `chrome://extensions/` (with function tracking features enabled)
+
+### Troubleshooting PRO Installation
+
+**Environment variable not set after installation:**
+- Restart your terminal or run: `source ~/.zshrc` (or `~/.bashrc` for Bash users)
+- If still not set, manually add to your shell config:
+  ```bash
+  export CHROMEDEBUG_EXTENSION_PATH="$HOME/.chromedebug-pro/extension"
+  ```
+
+**Chrome still loading FREE version:**
+- Verify the environment variable is set: `echo $CHROMEDEBUG_EXTENSION_PATH`
+- Close ALL Chrome windows and restart ChromeDebug MCP
+- Check installation log: `cat ~/.chromedebug-pro/install.log`
+
+**License validation errors:**
+- Verify you copied the full license key from your purchase email
+- License format should be: `LICENSEID-HASH` (e.g., `ABC12345-0123456789ABCDEF`)
+- Check for extra spaces or line breaks when copying
+
+**Extension ZIP file not found:**
+- Verify the path to your downloaded ZIP file is correct
+- Use `~` for home directory: `~/Downloads/chromedebug-pro-extension.zip`
+- Check file permissions: `ls -la ~/Downloads/chromedebug-pro-extension.zip`
+
+**Need help?**
+- Check installation log: `~/.chromedebug-pro/install.log`
+- Open an issue: [GitHub Issues](https://github.com/dynamicupgrade/ChromeDebug/issues)
+
 ## Usage
 
 ### As MCP Server
@@ -195,7 +274,7 @@ Install the FREE version directly from the Chrome Web Store:
 2. Enable "Developer mode"
 3. Click "Load unpacked" and select the `chrome-extension` directory
 
-#### Option 3: PRO Version (Unlimited)
+#### Option 3: PRO Version (Unlimited) - Automated Installation
 
 For unlimited recordings and advanced features, purchase the PRO version:
 
@@ -206,6 +285,8 @@ For unlimited recordings and advanced features, purchase the PRO version:
 - ✅ Enhanced capture features
 - ✅ Priority support
 
+**Installation:** PRO extension is automatically installed via the `chromedebug-mcp install-pro` command. See the [Installing PRO Version](#installing-pro-version) section above for detailed instructions.
+
 ### Using the Extension
 
 1. **Element Selection**

package/chrome-extension/manifest.free.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": 3,
-  "name": "ChromeDebug MCP Assistant FREE v2.4.0",
-  "version": "2.4.0",
-  "description": "ChromeDebug MCP visual element selector [FREE Edition] [Build: 2025-01-20-v2.4.0]",
+  "name": "ChromeDebug MCP Assistant FREE v2.4.1",
+  "version": "2.4.1",
+  "description": "ChromeDebug MCP visual element selector [FREE Edition] [Build: 2025-01-20-v2.4.1]",
   "permissions": [
     "activeTab",
     "scripting",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.5.5",
+  "version": "2.5.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",
@@ -55,8 +55,10 @@
     "run-migration": "node scripts/migrate-dual-ids.js",
     "test:mcp": "NODE_OPTIONS='--experimental-vm-modules' jest tests/mcp-server.test.js",
     "tbv:microtest": "cd chrome-extension && npm run tbv:microtest",
-    "build:free": "webpack --config scripts/webpack.config.free.cjs",
-    "build:pro": "webpack --config scripts/webpack.config.pro.cjs",
+    "validate:free": "node scripts/validate-manifest.js free",
+    "validate:pro": "node scripts/validate-manifest.js pro",
+    "build:free": "npm run validate:free && webpack --config scripts/webpack.config.free.cjs",
+    "build:pro": "npm run validate:pro && webpack --config scripts/webpack.config.pro.cjs",
     "build:both": "npm run build:free && npm run build:pro",
     "package-pro": "node scripts/package-pro-extension.js",
     "package-webstore": "node scripts/package-webstore-extension.js"
@@ -90,7 +92,6 @@
     "chrome-extension/*.css",
     "chrome-extension/*.html",
     "chrome-extension/*.png",
-    "chrome-extension/manifest.json",
     "chrome-extension/manifest.free.json",
     "chrome-extension/README.md",
     "config/",
@@ -104,6 +105,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
+    "adm-zip": "^0.5.16",
     "bcrypt": "^6.0.0",
     "better-sqlite3": "^12.2.0",
     "cors": "^2.8.5",

package/scripts/validate-manifest.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * Validate Chrome extension manifest file references
+ * Ensures all files referenced in manifest actually exist
+ *
+ * Usage: node scripts/validate-manifest.js <free|pro>
+ */
+
+import { promises as fs } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, '..');
+const extensionDir = join(rootDir, 'chrome-extension');
+
+async function validateManifest(tier) {
+  if (!['free', 'pro'].includes(tier)) {
+    console.error('Usage: node scripts/validate-manifest.js <free|pro>');
+    process.exit(1);
+  }
+
+  console.log(`\n🔍 Validating ${tier.toUpperCase()} manifest...`);
+
+  // Read manifest file
+  const manifestPath = join(extensionDir, `manifest.${tier}.json`);
+  let manifest;
+
+  try {
+    const manifestContent = await fs.readFile(manifestPath, 'utf8');
+    manifest = JSON.parse(manifestContent);
+  } catch (error) {
+    console.error(`❌ Failed to read ${manifestPath}`);
+    console.error(error.message);
+    process.exit(1);
+  }
+
+  const missingFiles = [];
+  const foundFiles = [];
+
+  /**
+   * Check if a file exists in the extension directory
+   */
+  async function checkFile(filePath, description) {
+    const fullPath = join(extensionDir, filePath);
+    try {
+      await fs.access(fullPath);
+      foundFiles.push(`   ✓ ${filePath} (${description})`);
+      return true;
+    } catch {
+      missingFiles.push(`   ✗ ${filePath} (${description})`);
+      return false;
+    }
+  }
+
+  // Validate content_scripts
+  if (manifest.content_scripts) {
+    for (const [index, script] of manifest.content_scripts.entries()) {
+      if (script.js) {
+        for (const jsFile of script.js) {
+          await checkFile(jsFile, `content script #${index + 1}`);
+        }
+      }
+      if (script.css) {
+        for (const cssFile of script.css) {
+          await checkFile(cssFile, `content CSS #${index + 1}`);
+        }
+      }
+    }
+  }
+
+  // Validate background service worker
+  if (manifest.background?.service_worker) {
+    await checkFile(manifest.background.service_worker, 'background service worker');
+  }
+
+  // Validate action popup
+  if (manifest.action?.default_popup) {
+    await checkFile(manifest.action.default_popup, 'action popup');
+  }
+
+  // Validate action icons
+  if (manifest.action?.default_icon) {
+    const icons = manifest.action.default_icon;
+    for (const [size, iconPath] of Object.entries(icons)) {
+      await checkFile(iconPath, `action icon ${size}px`);
+    }
+  }
+
+  // Validate manifest icons
+  if (manifest.icons) {
+    for (const [size, iconPath] of Object.entries(manifest.icons)) {
+      await checkFile(iconPath, `manifest icon ${size}px`);
+    }
+  }
+
+  // Validate options page
+  if (manifest.options_page) {
+    await checkFile(manifest.options_page, 'options page');
+  }
+
+  // Validate web_accessible_resources
+  if (manifest.web_accessible_resources) {
+    for (const resource of manifest.web_accessible_resources) {
+      if (resource.resources) {
+        for (const resPath of resource.resources) {
+          // Skip wildcard patterns
+          if (!resPath.includes('*')) {
+            await checkFile(resPath, 'web accessible resource');
+          }
+        }
+      }
+    }
+  }
+
+  // Report results
+  console.log(`\n📊 Validation Results:`);
+  console.log(`   Files found: ${foundFiles.length}`);
+  console.log(`   Files missing: ${missingFiles.length}`);
+
+  if (foundFiles.length > 0) {
+    console.log(`\n✅ Found files:`);
+    foundFiles.forEach(f => console.log(f));
+  }
+
+  if (missingFiles.length > 0) {
+    console.log(`\n❌ Missing files:`);
+    missingFiles.forEach(f => console.log(f));
+    console.log(`\n❌ Manifest validation FAILED for ${tier.toUpperCase()}`);
+    console.log(`   Please ensure all referenced files exist in chrome-extension/`);
+    process.exit(1);
+  }
+
+  console.log(`\n✅ Manifest validation PASSED for ${tier.toUpperCase()}`);
+  console.log(`   All ${foundFiles.length} referenced files exist\n`);
+  process.exit(0);
+}
+
+// Get tier from command line argument
+const tier = process.argv[2];
+validateManifest(tier);

package/src/cli.js

@@ -18,11 +18,17 @@ import {
   findActiveSessions
 } from './services/unified-session-manager.js';
 import logger from './utils/logger.js';
+import { installPro } from './commands/install-pro.js';
 
 /**
  * Main CLI entry point
  */
 async function main() {
+  // Check for install-pro command
+  if (process.argv.includes('install-pro')) {
+    await installPro(process.argv.slice(2));
+    return;
+  }
   const app = new ChromePilotApp();
 
   // Parse arguments first to get session settings