chrometools-mcp 1.9.1 → 2.3.2

package/utils/platform-utils.js

@@ -0,0 +1,62 @@
+/**
+ * utils/platform-utils.js
+ *
+ * Platform detection and platform-specific utilities
+ */
+
+import { readFileSync } from 'fs';
+
+/**
+ * Detect WSL environment
+ * @returns {boolean} - True if running in WSL
+ */
+export const isWSL = (() => {
+  try {
+    const proc_version = readFileSync('/proc/version', 'utf8').toLowerCase();
+    return proc_version.includes('microsoft') || proc_version.includes('wsl');
+  } catch {
+    return false;
+  }
+})();
+
+/**
+ * Detect Windows environment (including WSL)
+ * @returns {boolean} - True if running on Windows or WSL
+ */
+export const isWindows = process.platform === 'win32' || isWSL;
+
+/**
+ * Get Chrome executable path based on platform
+ * @returns {string} - Path to Chrome executable
+ */
+export function getChromePath() {
+  if (process.platform === 'win32') {
+    // Native Windows
+    return 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe';
+  } else if (isWSL) {
+    // WSL - use Windows Chrome
+    return '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe';
+  } else {
+    // Linux
+    return '/usr/bin/google-chrome';
+  }
+}
+
+/**
+ * Get temp directory based on platform
+ * @returns {string} - Path to temp directory
+ */
+export function getTempDir() {
+  if (process.platform === 'win32') {
+    return process.env.TEMP || 'C:\\Windows\\Temp';
+  } else if (isWSL) {
+    return '/mnt/c/Windows/Temp';
+  } else {
+    return process.env.TMPDIR || '/tmp';
+  }
+}
+
+/**
+ * Chrome remote debugging port
+ */
+export const CHROME_DEBUG_PORT = 9222;

package/utils/url-to-project.js

@@ -0,0 +1,141 @@
+/**
+ * utils/url-to-project.js
+ *
+ * Utilities for extracting project ID from website URLs.
+ * Used by scenario recorder to organize scenarios by domain.
+ */
+
+/**
+ * Extract project ID from URL
+ *
+ * Strategy (v3.0):
+ * - Always use main domain only (strip all subdomains)
+ * - Include ports for ALL domains (localhost and others)
+ * - file:// URLs → "local"
+ * - Invalid URLs → "unknown"
+ *
+ * Examples:
+ * - https://www.google.com → "google"
+ * - https://dev.example.com:8080 → "example-8080"
+ * - https://mail.google.com → "google"
+ * - http://localhost:3000 → "localhost-3000"
+ * - https://api.stripe.com:443 → "stripe-443"
+ * - file:///C:/test.html → "local"
+ *
+ * @param {string} url - Full URL
+ * @returns {string} - Project ID (e.g., "google", "localhost-3000", "example-8080")
+ */
+export function urlToProjectId(url) {
+  try {
+    // Handle file:// protocol
+    if (url.startsWith('file://')) {
+      return 'local';
+    }
+
+    const urlObj = new URL(url);
+    let hostname = urlObj.hostname.toLowerCase();
+    const port = urlObj.port;
+
+    // Remove www prefix
+    hostname = hostname.replace(/^www\./, '');
+
+    // Split hostname into parts
+    const parts = hostname.split('.');
+
+    // Single-level hostnames (e.g., "localhost", "example")
+    if (parts.length === 1) {
+      const projectId = sanitizeProjectId(parts[0]);
+      return port ? `${projectId}-${port}` : projectId;
+    }
+
+    // Multi-level hostnames: extract main domain (second-to-last part before TLD)
+    // Examples:
+    // - google.com → parts=['google', 'com'] → mainDomain='google'
+    // - dev.example.com → parts=['dev', 'example', 'com'] → mainDomain='example'
+    // - mail.google.co.uk → parts=['mail', 'google', 'co', 'uk'] → mainDomain='co' (not ideal, but simple)
+    const mainDomain = parts[parts.length - 2];
+    const projectId = sanitizeProjectId(mainDomain);
+
+    // Add port if present (for ALL domains, not just localhost)
+    return port ? `${projectId}-${port}` : projectId;
+
+  } catch (error) {
+    // Invalid URL, return safe fallback
+    console.error('[url-to-project] Invalid URL:', url, error);
+    return 'unknown';
+  }
+}
+
+/**
+ * Sanitize project ID
+ * - Lowercase everything
+ * - Replace non-alphanumeric characters with hyphens
+ * - Collapse multiple hyphens into one
+ * - Remove leading/trailing hyphens
+ *
+ * @param {string} id - Raw project ID
+ * @returns {string} - Sanitized ID
+ */
+function sanitizeProjectId(id) {
+  return id
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, '-')  // Replace non-alphanumeric with hyphens
+    .replace(/-+/g, '-')          // Collapse multiple hyphens
+    .replace(/^-|-$/g, '');       // Remove leading/trailing hyphens
+}
+
+/**
+ * Get browser-compatible version of urlToProjectId for injection
+ * Returns the function as a string to be injected into browser context
+ *
+ * @returns {string} - Function code as string
+ */
+export function getUrlToProjectIdForBrowser() {
+  return `
+/**
+ * Extract project ID from URL (browser version)
+ * @param {string} url - Full URL
+ * @returns {string} - Project ID
+ */
+function urlToProjectId(url) {
+  try {
+    if (url.startsWith('file://')) {
+      return 'local';
+    }
+
+    const urlObj = new URL(url);
+    let hostname = urlObj.hostname.toLowerCase();
+    const port = urlObj.port;
+
+    hostname = hostname.replace(/^www\\./, '');
+    const parts = hostname.split('.');
+
+    if (parts.length === 1) {
+      const projectId = sanitizeProjectId(parts[0]);
+      return port ? \`\${projectId}-\${port}\` : projectId;
+    }
+
+    const mainDomain = parts[parts.length - 2];
+    const projectId = sanitizeProjectId(mainDomain);
+    return port ? \`\${projectId}-\${port}\` : projectId;
+
+  } catch (error) {
+    console.error('[url-to-project] Invalid URL:', url, error);
+    return 'unknown';
+  }
+}
+
+/**
+ * Sanitize project ID (browser version)
+ * @param {string} id - Raw project ID
+ * @returns {string} - Sanitized ID
+ */
+function sanitizeProjectId(id) {
+  return id
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+`;
+}

package/utils/project-detector.js

@@ -1,87 +0,0 @@
-/**
- * utils/project-detector.js
- *
- * Utilities for detecting the current project root directory.
- * Uses cascade strategy: env variables → Git root → cwd fallback
- */
-
-import { execSync } from 'child_process';
-import path from 'path';
-
-/**
- * Find Git repository root from a starting path
- * @param {string} startPath - Path to start searching from
- * @returns {string|null} - Git root path or null if not in a Git repository
- */
-function findGitRoot(startPath = process.cwd()) {
-  try {
-    const root = execSync('git rev-parse --show-toplevel', {
-      cwd: startPath,
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr
-    }).trim();
-
-    // Normalize path separators for Windows
-    return path.normalize(root);
-  } catch {
-    // Not in a Git repository or git command not available
-    return null;
-  }
-}
-
-/**
- * Detect project root directory using cascade strategy
- *
- * Priority:
- * 1. CLAUDE_PROJECT_DIR environment variable
- * 2. PROJECT_DIR environment variable (custom)
- * 3. Git repository root
- * 4. Current working directory (fallback)
- *
- * @returns {string} - Detected project root path
- */
-export function detectProjectRoot() {
-  // 1. Try CLAUDE_PROJECT_DIR (Claude Code specific)
-  if (process.env.CLAUDE_PROJECT_DIR) {
-    const claudeDir = path.normalize(process.env.CLAUDE_PROJECT_DIR);
-    console.log('[chrometools-mcp] Project root from CLAUDE_PROJECT_DIR:', claudeDir);
-    return claudeDir;
-  }
-
-  // 2. Try PROJECT_DIR (custom env variable)
-  if (process.env.PROJECT_DIR) {
-    const projectDir = path.normalize(process.env.PROJECT_DIR);
-    console.log('[chrometools-mcp] Project root from PROJECT_DIR:', projectDir);
-    return projectDir;
-  }
-
-  // 3. Try Git root
-  const gitRoot = findGitRoot();
-  if (gitRoot) {
-    console.log('[chrometools-mcp] Project root from Git:', gitRoot);
-    return gitRoot;
-  }
-
-  // 4. Fallback to current working directory
-  const cwd = process.cwd();
-  console.log('[chrometools-mcp] Project root fallback to cwd:', cwd);
-  return cwd;
-}
-
-/**
- * Get scenarios directory path from base directory
- * @param {string} baseDir - Base directory
- * @returns {string} - Path to scenarios directory
- */
-export function getScenariosDir(baseDir) {
-  return path.join(baseDir, 'scenarios');
-}
-
-/**
- * Get secrets directory path from base directory
- * @param {string} baseDir - Base directory
- * @returns {string} - Path to secrets directory
- */
-export function getSecretsDir(baseDir) {
-  return path.join(baseDir, 'secrets');
-}