browsertrack 0.0.1 → 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+# BrowserTrack 🔍
+
+> **Local browser diagnostics shared with coding agents through MCP.**
+
+BrowserTrack is a lightweight, framework-agnostic local development daemon and Model Context Protocol (MCP) bridge. It automatically collects browser-side runtime errors, unhandled rejections, console logs, network failures, user breadcrumbs, and DOM snapshots—making them instantly accessible to AI coding assistants (Antigravity, Cursor, Claude Code) for rapid debugging and closed-loop verification.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Start the Local Daemon
+
+```bash
+npm install -g browsertrack
+browsertrack start
+```
+
+This starts the local diagnostics server at `http://127.0.0.1:7331` (WebSocket at `ws://127.0.0.1:7331`).
+
+### 2. Connect Your Web Project
+
+#### Option A: Zero-install script tag (Plain HTML / Vite / Next.js)
+
+```html
+<script src="http://127.0.0.1:7331/client.js"></script>
+```
+
+#### Option B: NPM package (React / Vue / Svelte / Astro)
+
+```bash
+npm install -D browsertrack
+```
+
+In your main application entry point (e.g. `main.ts` or `index.tsx`):
+
+```typescript
+import 'browsertrack/client';
+```
+
+---
+
+## 🤖 Coding Agent (MCP) Setup
+
+Add BrowserTrack to your MCP client configuration:
+
+### Cursor (`~/.cursor/mcp.json`) & Claude Code
+```json
+{
+  "mcpServers": {
+    "browsertrack": {
+      "command": "npx",
+      "args": ["browsertrack", "mcp"]
+    }
+  }
+}
+```
+
+### Antigravity (`~/.gemini/antigravity-ide/mcp_config.json`)
+```json
+{
+  "mcpServers": {
+    "browsertrack": {
+      "command": "browsertrack",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+---
+
+## 🛠️ MCP Tools Exposed to AI Agents
+
+| MCP Tool | Description |
+| :--- | :--- |
+| `list_projects` | Lists registered local development projects and mapped filesystem paths. |
+| `list_sessions` | Lists active browser tabs connected over WebSocket. |
+| `list_incidents` | Lists grouped error incidents with occurrences, severity, and status. |
+| `get_incident` | Retrieves concise, high-signal context (stack trace, breadcrumbs, network failures, last interacted element, error screenshot). |
+| `get_console` | Retrieves recent console errors/warnings. |
+| `get_network_failures` | Retrieves recent 4xx/5xx HTTP failures and aborted requests. |
+| `get_breadcrumbs` | Returns user interaction timeline leading up to an error. |
+| `get_page_state` | Queries live DOM/URL state from the active browser tab. |
+| `capture_element` | Captures an on-demand screenshot of a specific element or full page. |
+| `verify_incident` | Runs closed-loop verification: reloads browser, checks if error reoccurs, executes probes, captures after-screenshot, and returns verdict (`VERIFIED`, `FAILED`, `INCONCLUSIVE`). |
+| `get_verification` | Returns latest verification result and before/after screenshot artifacts. |
+
+---
+
+## 💻 CLI Commands
+
+```bash
+browsertrack start             # Start local daemon
+browsertrack start --verbose   # Verbose logging mode
+browsertrack stop              # Stop background daemon
+browsertrack status            # Check status & connected sessions
+
+browsertrack projects          # List tracked projects
+browsertrack project add myapp --origin http://localhost:5173 --path ~/projects/myapp
+
+browsertrack errors            # List open runtime errors
+browsertrack errors --project myapp
+
+browsertrack clear             # Clear stored logs & incidents
+browsertrack mcp               # Run MCP server over stdio
+```
+
+---
+
+## 🛡️ Security & Privacy
+
+- **Localhost Only**: Daemon strictly binds to `127.0.0.1`.
+- **Sensitive Key Redaction**: `Authorization`, `Cookie`, `Set-Cookie`, passwords, API tokens, and secret parameters are automatically sanitized.
+- **No Form Values**: Form inputs (`<input>`, `<textarea>`) are never inspected or collected.
+- **Zero Request/Response Body**: Payload bodies are disabled by default.
+
+---
+
+## 🏗️ Architecture
+
+```text
+Browser Client (Vanilla / React / Vue / Vite)
+      ↕ WebSocket (ws://127.0.0.1:7331)
+Local Daemon (SQLite Persistence + Verification Engine)
+      ↕ MCP (stdio)
+Coding Agents (Antigravity / Cursor / Claude Code)
+```
+
+---
+
+## 🧪 Testing
+
+Run the automated test suite:
+
+```bash
+npm test
+```
+
+Start the interactive fixture app for manual and end-to-end verification:
+
+```bash
+npx serve examples/test-app
+```

package/dist/chunk-6A7FFDIB.js

@@ -0,0 +1,221 @@
+// packages/core/src/fingerprint.ts
+function normalizeErrorMessage(message) {
+  if (!message) return "unknown_error";
+  return message.trim().replace(/0x[0-9a-fA-F]+/g, "0x<HEX>").replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g, "<UUID>").replace(/\?[tv]=[\w.-]+/g, "").replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z?/g, "<TIMESTAMP>").replace(/#\d+/g, "#<ID>").replace(/\s+/g, " ");
+}
+function normalizeSourceFile(filename) {
+  if (!filename) return "unknown_source";
+  let cleaned = filename.trim();
+  try {
+    if (cleaned.startsWith("http://") || cleaned.startsWith("https://")) {
+      const url = new URL(cleaned);
+      cleaned = url.pathname;
+    }
+  } catch {
+    cleaned = cleaned.replace(/^https?:\/\/[^/]+/, "");
+  }
+  cleaned = cleaned.split("?")[0].split("#")[0];
+  cleaned = cleaned.replace(/\\/g, "/");
+  return cleaned || "unknown_source";
+}
+function extractSourceFromStack(stack) {
+  if (!stack) return null;
+  const lines = stack.split("\n");
+  for (const line of lines) {
+    const match = line.match(/(?:at\s+(?:.*?\s+\()?)?(https?:\/\/[^\s)]+|file:\/\/[^\s)]+|\/[^\s)]+):(\d+):(\d+)\)?/);
+    if (match) {
+      return {
+        file: normalizeSourceFile(match[1]),
+        line: parseInt(match[2], 10),
+        column: parseInt(match[3], 10)
+      };
+    }
+  }
+  return null;
+}
+function djb2Hash(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = hash * 33 ^ str.charCodeAt(i);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function computeFingerprint(input) {
+  const normType = (input.type || "Error").trim().toLowerCase();
+  const normMsg = normalizeErrorMessage(input.message);
+  let sourceFile = normalizeSourceFile(input.sourceFile);
+  let line = input.line || 0;
+  if ((sourceFile === "unknown_source" || line === 0) && input.stack) {
+    const extracted = extractSourceFromStack(input.stack);
+    if (extracted) {
+      sourceFile = extracted.file;
+      line = extracted.line;
+    }
+  }
+  const rawKey = `${normType}::${normMsg}::${sourceFile}::${line}`;
+  const hash = djb2Hash(rawKey);
+  return `fp_${hash}`;
+}
+
+// packages/core/src/redaction.ts
+var SENSITIVE_KEY_PATTERNS = [
+  /^authorization$/i,
+  /^cookie$/i,
+  /^set-cookie$/i,
+  /password/i,
+  /token/i,
+  /secret/i,
+  /api[-_]?key/i,
+  /access[-_]?token/i,
+  /refresh[-_]?token/i,
+  /credentials/i,
+  /private[-_]?key/i,
+  /ssn/i,
+  /credit[-_]?card/i,
+  /cvv/i
+];
+var SENSITIVE_QUERY_PARAMS = [
+  "token",
+  "auth",
+  "key",
+  "apikey",
+  "api_key",
+  "secret",
+  "password",
+  "access_token",
+  "refresh_token",
+  "code",
+  "signature"
+];
+var REDACTED_PLACEHOLDER = "[REDACTED]";
+function isSensitiveKey(key) {
+  if (!key) return false;
+  const cleaned = key.replace(/[-_]/g, "");
+  return SENSITIVE_KEY_PATTERNS.some((pattern) => pattern.test(key) || pattern.test(cleaned));
+}
+function redactUrl(rawUrl) {
+  if (!rawUrl) return rawUrl;
+  try {
+    const isRelative = !rawUrl.startsWith("http://") && !rawUrl.startsWith("https://") && !rawUrl.startsWith("ws://") && !rawUrl.startsWith("wss://");
+    const base = "http://localhost";
+    const parsed = new URL(rawUrl, base);
+    let changed = false;
+    for (const param of SENSITIVE_QUERY_PARAMS) {
+      if (parsed.searchParams.has(param)) {
+        parsed.searchParams.set(param, REDACTED_PLACEHOLDER);
+        changed = true;
+      }
+    }
+    for (const key of Array.from(parsed.searchParams.keys())) {
+      if (isSensitiveKey(key)) {
+        parsed.searchParams.set(key, REDACTED_PLACEHOLDER);
+        changed = true;
+      }
+    }
+    if (!changed) return rawUrl;
+    let result = isRelative ? parsed.pathname + parsed.search + parsed.hash : parsed.toString();
+    result = result.replace(/%5BREDACTED%5D/g, REDACTED_PLACEHOLDER);
+    return result;
+  } catch {
+    let safe = rawUrl;
+    for (const param of SENSITIVE_QUERY_PARAMS) {
+      const reg = new RegExp(`([?&]${param}=)[^&#]+`, "gi");
+      safe = safe.replace(reg, `$1${REDACTED_PLACEHOLDER}`);
+    }
+    return safe;
+  }
+}
+function redactHeaders(headers) {
+  if (!headers || typeof headers !== "object") return {};
+  const safe = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (isSensitiveKey(key)) {
+      safe[key] = REDACTED_PLACEHOLDER;
+    } else {
+      safe[key] = value;
+    }
+  }
+  return safe;
+}
+function redactSensitiveData(data, maxDepth = 6, currentDepth = 0) {
+  if (data === null || data === void 0) return data;
+  if (typeof data !== "object") return data;
+  if (currentDepth > maxDepth) return "[DEPTH_EXCEEDED]";
+  if (Array.isArray(data)) {
+    return data.map((item) => redactSensitiveData(item, maxDepth, currentDepth + 1));
+  }
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (typeof value === "object" && value !== null) {
+      result[key] = redactSensitiveData(value, maxDepth, currentDepth + 1);
+    } else if (isSensitiveKey(key)) {
+      result[key] = REDACTED_PLACEHOLDER;
+    } else if (typeof value === "string") {
+      if (value.startsWith("http://") || value.startsWith("https://") || value.includes("?")) {
+        result[key] = redactUrl(value);
+      } else {
+        result[key] = value;
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
+// packages/core/src/selector.ts
+function getSemanticSelector(element, options = {}) {
+  if (!element || !element.tagName) return "unknown";
+  const maxClasses = options.maxClasses ?? 2;
+  const testId = element.getAttribute("data-testid") || element.getAttribute("data-test") || element.getAttribute("data-cy") || element.getAttribute("data-qa");
+  if (testId) {
+    return `[data-testid="${testId}"]`;
+  }
+  const id = element.id;
+  if (id && !/^[0-9]+$/.test(id) && !/[0-9a-f]{8}-[0-9a-f]{4}/i.test(id)) {
+    return `#${id}`;
+  }
+  const ariaLabel = element.getAttribute("aria-label");
+  if (ariaLabel && ariaLabel.length < 30) {
+    return `${element.tagName.toLowerCase()}[aria-label="${ariaLabel}"]`;
+  }
+  const nameAttr = element.getAttribute("name");
+  if (nameAttr) {
+    return `${element.tagName.toLowerCase()}[name="${nameAttr}"]`;
+  }
+  const tag = element.tagName.toLowerCase();
+  const classList = Array.from(element.classList || []).filter((c) => !c.startsWith("css-") && !c.startsWith("_") && !/^[a-z0-9]{5,}$/i.test(c)).slice(0, maxClasses);
+  if (classList.length > 0) {
+    const classStr = classList.map((c) => `.${c}`).join("");
+    return `${tag}${classStr}`;
+  }
+  if (element.parentElement && element.parentElement !== document.body && element.parentElement !== document.documentElement) {
+    const parentSelector = getSemanticSelector(element.parentElement, { maxClasses: 1 });
+    if (parentSelector && parentSelector !== "unknown" && !parentSelector.includes(">")) {
+      return `${parentSelector} > ${tag}`;
+    }
+  }
+  return tag;
+}
+function truncate(str, maxLength = 200) {
+  if (!str) return "";
+  if (str.length <= maxLength) return str;
+  return str.slice(0, maxLength) + "...";
+}
+
+export {
+  normalizeErrorMessage,
+  normalizeSourceFile,
+  extractSourceFromStack,
+  computeFingerprint,
+  SENSITIVE_KEY_PATTERNS,
+  SENSITIVE_QUERY_PARAMS,
+  REDACTED_PLACEHOLDER,
+  isSensitiveKey,
+  redactUrl,
+  redactHeaders,
+  redactSensitiveData,
+  getSemanticSelector,
+  truncate
+};
+//# sourceMappingURL=chunk-6A7FFDIB.js.map

package/dist/chunk-6A7FFDIB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/core/src/fingerprint.ts","../packages/core/src/redaction.ts","../packages/core/src/selector.ts"],"sourcesContent":["/**\n * Error fingerprinting and normalization utilities\n */\n\nexport interface FingerprintInput {\n  type: string;\n  message: string;\n  sourceFile?: string;\n  line?: number;\n  column?: number;\n  stack?: string;\n}\n\n/**\n * Normalizes error messages by stripping dynamic content like UUIDs, timestamps,\n * hex addresses, and file timestamps.\n */\nexport function normalizeErrorMessage(message: string): string {\n  if (!message) return 'unknown_error';\n\n  return message\n    // Normalize string representation\n    .trim()\n    // Replace hex addresses (e.g. 0x7ffee4b2a8)\n    .replace(/0x[0-9a-fA-F]+/g, '0x<HEX>')\n    // Replace UUIDs\n    .replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g, '<UUID>')\n    // Replace timestamp query params like ?t=1719283748 or ?v=1.2.3\n    .replace(/\\?[tv]=[\\w.-]+/g, '')\n    // Replace ISO timestamps\n    .replace(/\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z?/g, '<TIMESTAMP>')\n    // Replace numbers in quotes/brackets if likely IDs (e.g., user \"12345\")\n    .replace(/#\\d+/g, '#<ID>')\n    // Normalize whitespaces\n    .replace(/\\s+/g, ' ');\n}\n\n/**\n * Normalizes source filenames by removing origin and cache-busting query strings.\n */\nexport function normalizeSourceFile(filename?: string): string {\n  if (!filename) return 'unknown_source';\n\n  let cleaned = filename.trim();\n  // Strip protocol and origin if present (e.g. http://localhost:5173/src/App.tsx?t=123)\n  try {\n    if (cleaned.startsWith('http://') || cleaned.startsWith('https://')) {\n      const url = new URL(cleaned);\n      cleaned = url.pathname;\n    }\n  } catch {\n    // fallback string manipulation\n    cleaned = cleaned.replace(/^https?:\\/\\/[^/]+/, '');\n  }\n\n  // Remove query parameters\n  cleaned = cleaned.split('?')[0].split('#')[0];\n\n  // Normalize windows path separators\n  cleaned = cleaned.replace(/\\\\/g, '/');\n\n  return cleaned || 'unknown_source';\n}\n\n/**\n * Extracts source location from stack if not explicitly provided\n */\nexport function extractSourceFromStack(stack?: string): { file: string; line: number; column?: number } | null {\n  if (!stack) return null;\n\n  const lines = stack.split('\\n');\n  for (const line of lines) {\n    // Match standard stack line: at functionName (http://localhost:5173/src/main.tsx:15:3) or at http://...:15:3\n    const match = line.match(/(?:at\\s+(?:.*?\\s+\\()?)?(https?:\\/\\/[^\\s)]+|file:\\/\\/[^\\s)]+|\\/[^\\s)]+):(\\d+):(\\d+)\\)?/);\n    if (match) {\n      return {\n        file: normalizeSourceFile(match[1]),\n        line: parseInt(match[2], 10),\n        column: parseInt(match[3], 10),\n      };\n    }\n  }\n  return null;\n}\n\n/**\n * Fast synchronous djb2-based hash for universal client/server runtime\n */\nfunction djb2Hash(str: string): string {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = (hash * 33) ^ str.charCodeAt(i);\n  }\n  // Convert to unsigned 32-bit hex string\n  return (hash >>> 0).toString(16).padStart(8, '0');\n}\n\n/**\n * Computes a deterministic fingerprint for an error\n */\nexport function computeFingerprint(input: FingerprintInput): string {\n  const normType = (input.type || 'Error').trim().toLowerCase();\n  const normMsg = normalizeErrorMessage(input.message);\n\n  let sourceFile = normalizeSourceFile(input.sourceFile);\n  let line = input.line || 0;\n\n  if ((sourceFile === 'unknown_source' || line === 0) && input.stack) {\n    const extracted = extractSourceFromStack(input.stack);\n    if (extracted) {\n      sourceFile = extracted.file;\n      line = extracted.line;\n    }\n  }\n\n  const rawKey = `${normType}::${normMsg}::${sourceFile}::${line}`;\n  const hash = djb2Hash(rawKey);\n\n  return `fp_${hash}`;\n}\n","/**\n * Security and Redaction Utilities\n */\n\nexport const SENSITIVE_KEY_PATTERNS = [\n  /^authorization$/i,\n  /^cookie$/i,\n  /^set-cookie$/i,\n  /password/i,\n  /token/i,\n  /secret/i,\n  /api[-_]?key/i,\n  /access[-_]?token/i,\n  /refresh[-_]?token/i,\n  /credentials/i,\n  /private[-_]?key/i,\n  /ssn/i,\n  /credit[-_]?card/i,\n  /cvv/i,\n];\n\nexport const SENSITIVE_QUERY_PARAMS = [\n  'token',\n  'auth',\n  'key',\n  'apikey',\n  'api_key',\n  'secret',\n  'password',\n  'access_token',\n  'refresh_token',\n  'code',\n  'signature',\n];\n\nexport const REDACTED_PLACEHOLDER = '[REDACTED]';\n\n/**\n * Checks if a property name matches any sensitive pattern\n */\nexport function isSensitiveKey(key: string): boolean {\n  if (!key) return false;\n  const cleaned = key.replace(/[-_]/g, '');\n  return SENSITIVE_KEY_PATTERNS.some((pattern) => pattern.test(key) || pattern.test(cleaned));\n}\n\n/**\n * Redacts sensitive query parameters from a URL string\n */\nexport function redactUrl(rawUrl: string): string {\n  if (!rawUrl) return rawUrl;\n\n  try {\n    const isRelative = !rawUrl.startsWith('http://') && !rawUrl.startsWith('https://') && !rawUrl.startsWith('ws://') && !rawUrl.startsWith('wss://');\n    const base = 'http://localhost';\n    const parsed = new URL(rawUrl, base);\n\n    let changed = false;\n    for (const param of SENSITIVE_QUERY_PARAMS) {\n      if (parsed.searchParams.has(param)) {\n        parsed.searchParams.set(param, REDACTED_PLACEHOLDER);\n        changed = true;\n      }\n    }\n\n    // Also check all query params against isSensitiveKey\n    for (const key of Array.from(parsed.searchParams.keys())) {\n      if (isSensitiveKey(key)) {\n        parsed.searchParams.set(key, REDACTED_PLACEHOLDER);\n        changed = true;\n      }\n    }\n\n    if (!changed) return rawUrl;\n\n    let result = isRelative ? parsed.pathname + parsed.search + parsed.hash : parsed.toString();\n    // Normalize URL-encoded brackets %5BREDACTED%5D back to [REDACTED]\n    result = result.replace(/%5BREDACTED%5D/g, REDACTED_PLACEHOLDER);\n    return result;\n  } catch {\n    // If URL parsing fails, perform regex replace\n    let safe = rawUrl;\n    for (const param of SENSITIVE_QUERY_PARAMS) {\n      const reg = new RegExp(`([?&]${param}=)[^&#]+`, 'gi');\n      safe = safe.replace(reg, `$1${REDACTED_PLACEHOLDER}`);\n    }\n    return safe;\n  }\n}\n\n/**\n * Redacts sensitive HTTP headers\n */\nexport function redactHeaders(headers: Record<string, string>): Record<string, string> {\n  if (!headers || typeof headers !== 'object') return {};\n\n  const safe: Record<string, string> = {};\n  for (const [key, value] of Object.entries(headers)) {\n    if (isSensitiveKey(key)) {\n      safe[key] = REDACTED_PLACEHOLDER;\n    } else {\n      safe[key] = value;\n    }\n  }\n  return safe;\n}\n\n/**\n * Deeply redacts sensitive keys from an object or array\n */\nexport function redactSensitiveData<T = any>(data: T, maxDepth = 6, currentDepth = 0): T {\n  if (data === null || data === undefined) return data;\n  if (typeof data !== 'object') return data;\n  if (currentDepth > maxDepth) return '[DEPTH_EXCEEDED]' as any;\n\n  if (Array.isArray(data)) {\n    return data.map((item) => redactSensitiveData(item, maxDepth, currentDepth + 1)) as any;\n  }\n\n  const result: Record<string, any> = {};\n  for (const [key, value] of Object.entries(data as Record<string, any>)) {\n    if (typeof value === 'object' && value !== null) {\n      result[key] = redactSensitiveData(value, maxDepth, currentDepth + 1);\n    } else if (isSensitiveKey(key)) {\n      result[key] = REDACTED_PLACEHOLDER;\n    } else if (typeof value === 'string') {\n      // Check if value is a URL containing secrets\n      if (value.startsWith('http://') || value.startsWith('https://') || value.includes('?')) {\n        result[key] = redactUrl(value);\n      } else {\n        result[key] = value;\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result as T;\n}\n","/**\n * Semantic element selector generation and inspection\n */\n\nexport interface SelectorOptions {\n  maxClasses?: number;\n  maxOuterHTMLLength?: number;\n  maxInnerTextLength?: number;\n}\n\n/**\n * Builds a clean, human-readable semantic selector for a DOM element.\n * Prioritizes data-testid/data-test, id, semantic tag + specific class, or concise parent path.\n */\nexport function getSemanticSelector(element: HTMLElement | Element, options: SelectorOptions = {}): string {\n  if (!element || !element.tagName) return 'unknown';\n\n  const maxClasses = options.maxClasses ?? 2;\n\n  // 1. Check for standard test attributes\n  const testId =\n    element.getAttribute('data-testid') ||\n    element.getAttribute('data-test') ||\n    element.getAttribute('data-cy') ||\n    element.getAttribute('data-qa');\n\n  if (testId) {\n    return `[data-testid=\"${testId}\"]`;\n  }\n\n  // 2. Check for meaningful ID (skip dynamic UUID/numeric IDs)\n  const id = element.id;\n  if (id && !/^[0-9]+$/.test(id) && !/[0-9a-f]{8}-[0-9a-f]{4}/i.test(id)) {\n    return `#${id}`;\n  }\n\n  // 3. Check for aria-label or name on buttons/inputs\n  const ariaLabel = element.getAttribute('aria-label');\n  if (ariaLabel && ariaLabel.length < 30) {\n    return `${element.tagName.toLowerCase()}[aria-label=\"${ariaLabel}\"]`;\n  }\n\n  const nameAttr = element.getAttribute('name');\n  if (nameAttr) {\n    return `${element.tagName.toLowerCase()}[name=\"${nameAttr}\"]`;\n  }\n\n  // 4. Tag + curated classes\n  const tag = element.tagName.toLowerCase();\n  const classList = Array.from(element.classList || [])\n    .filter((c) => !c.startsWith('css-') && !c.startsWith('_') && !/^[a-z0-9]{5,}$/i.test(c)) // filter hashed utility classes\n    .slice(0, maxClasses);\n\n  if (classList.length > 0) {\n    const classStr = classList.map((c) => `.${c}`).join('');\n    return `${tag}${classStr}`;\n  }\n\n  // 5. If generic element (div, span, p) without attributes, try parent context\n  if (element.parentElement && element.parentElement !== document.body && element.parentElement !== document.documentElement) {\n    const parentSelector = getSemanticSelector(element.parentElement, { maxClasses: 1 });\n    if (parentSelector && parentSelector !== 'unknown' && !parentSelector.includes('>')) {\n      return `${parentSelector} > ${tag}`;\n    }\n  }\n\n  return tag;\n}\n\n/**\n * Truncates string to specified max length with ellipsis\n */\nexport function truncate(str: string | undefined | null, maxLength = 200): string {\n  if (!str) return '';\n  if (str.length <= maxLength) return str;\n  return str.slice(0, maxLength) + '...';\n}\n"],"mappings":"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","names":[]}