testdriverai 7.8.0-test.7 → 7.8.0-test.71

package/ai/skills/testdriver-screenshots/SKILL.md

@@ -0,0 +1,184 @@
+---
+name: testdriver:screenshots
+description: Capture and manage screenshots during test execution
+---
+<!-- Generated from screenshots.mdx. DO NOT EDIT. -->
+
+## Overview
+
+TestDriver can capture screenshots manually at any point during a test, or automatically before and after every command. Screenshots are saved to a structured directory for easy debugging.
+
+## Manual Screenshots
+
+Use `testdriver.screenshot()` to capture the current screen:
+
+```javascript
+const path = await testdriver.screenshot();
+console.log('Saved to:', path);
+// .testdriver/screenshots/my-test/screenshot-1719849312345.png
+```
+
+### Options
+
+```javascript
+await testdriver.screenshot(filename?)
+```
+
+<ParamField path="filename" type="string">
+  Custom filename for the screenshot. `.png` is appended automatically if missing. If omitted, defaults to `screenshot-<timestamp>.png`.
+</ParamField>
+
+**Returns:** `Promise<string>` — the absolute file path of the saved screenshot.
+
+```javascript
+// Default filename
+await testdriver.screenshot();
+// → .testdriver/screenshots/my-test/screenshot-1719849312345.png
+
+// Custom filename
+await testdriver.screenshot('login-page');
+// → .testdriver/screenshots/my-test/login-page.png
+
+// With .png extension
+await testdriver.screenshot('dashboard-loaded.png');
+// → .testdriver/screenshots/my-test/dashboard-loaded.png
+```
+
+## Auto Screenshots
+
+Enable automatic screenshots before and after every command:
+
+```javascript
+const testdriver = new TestDriver({
+  autoScreenshots: true,
+});
+```
+
+<ParamField path="autoScreenshots" type="boolean" default={false}>
+  When `true`, captures a screenshot before and after every SDK command (`click`, `type`, `find`, `scroll`, `hover`, `pressKeys`, `assert`, `exec`, etc.). On error, an error-phase screenshot replaces the after-phase screenshot.
+</ParamField>
+
+### Filename Format
+
+Auto-screenshots follow this naming convention:
+
+```
+<seq>-<action>-<phase>-L<line>-<description>.png
+```
+
+| Part | Description | Example |
+|---|---|---|
+| `seq` | 3-digit zero-padded sequence number | `001` |
+| `action` | Command name | `click`, `type`, `find` |
+| `phase` | `before`, `after`, or `error` | `before` |
+| `L<line>` | Source line number from your test file | `L42` |
+| `description` | Sanitized from command arguments (max 30 chars) | `submit-button` |
+
+**Examples:**
+```
+001-find-before-L15-login-button.png
+002-find-after-L15-login-button.png
+003-click-before-L16-login-button.png
+004-click-after-L16-login-button.png
+005-type-before-L18-username-field.png
+006-type-error-L18-username-field.png
+```
+
+### Phases
+
+| Phase | When | Description |
+|---|---|---|
+| `before` | Before command executes | Captures the screen state before the action |
+| `after` | After successful command | Captures the result of the action |
+| `error` | After failed command | Captures the screen at the point of failure (replaces `after`) |
+
+## Screenshot Directory
+
+Screenshots are saved to:
+
+```
+<cwd>/.testdriver/screenshots/<testFileName>/
+```
+
+Where `<testFileName>` is the test file name without its extension. For example, a test at `tests/login.test.mjs` saves screenshots to `.testdriver/screenshots/login.test/`.
+
+### Directory Cleanup
+
+The screenshot directory for each test file is **automatically cleaned** at the start of a test run. This happens once per process per test file to prevent concurrent tests from the same file from interfering with each other.
+
+## Debug Screenshots
+
+Elements have a `saveDebugScreenshot()` method for debugging element detection:
+
+```javascript
+const el = await testdriver.find('submit button');
+
+// Save the screenshot that was used to detect this element
+const debugPath = await el.saveDebugScreenshot();
+console.log('Debug screenshot:', debugPath);
+// → ./debug-screenshot-1719849312345.png
+
+// Custom path
+await el.saveDebugScreenshot('./my-debug.png');
+```
+
+This saves the screenshot that was captured during the `find()` call, which can be useful for understanding what the AI "saw" when locating the element.
+
+## Complete Example
+
+```javascript
+import { describe, it, beforeAll, afterAll } from 'vitest';
+import TestDriver from 'testdriverai';
+
+describe('Screenshot Example', () => {
+  let testdriver;
+
+  beforeAll(async () => {
+    testdriver = new TestDriver({
+      autoScreenshots: true,   // capture every step
+    });
+    await testdriver.ready();
+    await testdriver.provision.chrome({ url: 'https://example.com' });
+  });
+
+  afterAll(async () => {
+    await testdriver.disconnect();
+  });
+
+  it('captures the login flow', async () => {
+    // Auto-screenshots capture before/after each command
+
+    // Manual screenshot for a specific moment
+    await testdriver.screenshot('initial-page-load');
+
+    const username = await testdriver.find('username input');
+    await username.click();
+    await testdriver.type('testuser@example.com');
+
+    await testdriver.screenshot('after-username-entry');
+
+    const password = await testdriver.find('password input');
+    await password.click();
+    await testdriver.type('password123');
+
+    await testdriver.find('login button').click();
+
+    await testdriver.screenshot('after-login-click');
+  });
+});
+```
+
+After running, your screenshot directory will contain:
+```
+.testdriver/screenshots/login-flow.test/
+├── initial-page-load.png
+├── 001-find-before-L18-username-input.png
+├── 002-find-after-L18-username-input.png
+├── 003-click-before-L19-username-input.png
+├── 004-click-after-L19-username-input.png
+├── 005-type-before-L20-testuser-example-com.png
+├── 006-type-after-L20-testuser-example-com.png
+├── after-username-entry.png
+├── 007-find-before-L24-password-input.png
+├── ...
+```

package/docs/_data/examples-manifest.json

@@ -2,104 +2,104 @@
   "$schema": "./examples-manifest.schema.json",
   "examples": {
     "assert.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b6206a177a05bccd1cc",
-      "lastUpdated": "2026-03-03T00:32:25.279Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca86560e1c6d04ac340",
+      "lastUpdated": "2026-03-25T00:36:26.387Z"
     },
     "drag-and-drop.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918b",
       "lastUpdated": "2026-03-03T00:32:25.275Z"
     },
     "exec-pwsh.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42565d339e8065f180",
-      "lastUpdated": "2026-03-03T00:32:25.275Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9816690e8f8d0fd3a7",
+      "lastUpdated": "2026-03-25T00:31:30.158Z"
     },
     "match-image.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42258e8885264fc704",
-      "lastUpdated": "2026-03-03T00:32:25.275Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9a6560e1c6d04ac33c",
+      "lastUpdated": "2026-03-25T00:31:31.550Z"
     },
     "scroll-until-text.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b99dc33133fc0da9440",
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b820d4a5265e44e7d89",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9b6f1e64e218b9e1c1",
+      "lastUpdated": "2026-03-25T00:30:19.815Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42565d339e8065f17f",
-      "lastUpdated": "2026-03-03T00:32:25.275Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9e6f1e64e218b9e1c3",
+      "lastUpdated": "2026-03-25T00:31:36.152Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918c",
-      "lastUpdated": "2026-03-03T00:32:25.275Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca06560e1c6d04ac33e",
+      "lastUpdated": "2026-03-25T00:31:37.612Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b91fc0ac3cc632a91a0",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9716690e8f8d0fd3a6",
+      "lastUpdated": "2026-03-25T00:30:51.808Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b91113035da665496a6",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32c9d6560e1c6d04ac33d",
+      "lastUpdated": "2026-03-25T00:33:18.181Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b77fc0ac3cc632a9198",
-      "lastUpdated": "2026-03-03T00:32:25.279Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca16f1e64e218b9e1c5",
+      "lastUpdated": "2026-03-25T00:31:02.500Z"
     },
     "installer.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b570446888b52a4e1c9",
-      "lastUpdated": "2026-03-03T00:32:25.277Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca3b4a333234cc21a71",
+      "lastUpdated": "2026-03-25T00:30:27.405Z"
     },
     "type.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b8d49845ced0b71e2bf",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca56560e1c6d04ac33f",
+      "lastUpdated": "2026-03-25T00:31:05.803Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b800d4a5265e44e7d86",
-      "lastUpdated": "2026-03-03T00:32:25.281Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32ca6b4a333234cc21a72",
+      "lastUpdated": "2026-03-25T00:36:02.167Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b82258e8885264fc728",
-      "lastUpdated": "2026-03-03T00:32:25.281Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cab6f1e64e218b9e1c8",
+      "lastUpdated": "2026-03-25T00:31:48.884Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b83113035da665496a3",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb1ca96d9648a141714",
+      "lastUpdated": "2026-03-25T00:37:40.747Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b4549845ced0b71e2b0",
-      "lastUpdated": "2026-03-03T00:32:25.276Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cad6560e1c6d04ac342",
+      "lastUpdated": "2026-03-25T00:30:37.291Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b45b9fa9df65266123f",
-      "lastUpdated": "2026-03-03T00:32:25.276Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cae6f1e64e218b9e1c9",
+      "lastUpdated": "2026-03-25T00:31:51.753Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b4549845ced0b71e2b1",
-      "lastUpdated": "2026-03-03T00:32:25.276Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb0ca96d9648a141713",
+      "lastUpdated": "2026-03-25T00:30:40.087Z"
     },
     "captcha-api.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698f7df69e27ce1528d7d087/698f7fb0d3b320ad547d9d44",
       "lastUpdated": "2026-02-13T19:55:05.951Z"
     },
     "element-not-found.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b6f0d4a5265e44e7d7b",
-      "lastUpdated": "2026-03-03T00:32:25.279Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb5ca96d9648a141716",
+      "lastUpdated": "2026-03-25T00:31:57.845Z"
     },
     "formatted-logging.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b60258e8885264fc711",
-      "lastUpdated": "2026-03-03T00:32:25.279Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb36f1e64e218b9e1cb",
+      "lastUpdated": "2026-03-25T00:31:56.270Z"
     },
     "hover-text.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b79dc33133fc0da9439",
-      "lastUpdated": "2026-03-03T00:32:25.280Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb86f1e64e218b9e1cd",
+      "lastUpdated": "2026-03-25T00:30:48.128Z"
     },
     "no-provision.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
       "lastUpdated": "2026-03-03T00:32:25.279Z"
     },
     "ai.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b8f06a177a05bccd1dc",
-      "lastUpdated": "2026-03-03T00:32:25.282Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb6ca96d9648a141717",
+      "lastUpdated": "2026-03-25T00:38:54.978Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -134,12 +134,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7afc0ac3cc632a919b",
-      "lastUpdated": "2026-03-03T00:32:25.280Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32caa6f1e64e218b9e1c7",
+      "lastUpdated": "2026-03-25T00:31:10.542Z"
     },
     "parse.test.mjs": {
-      "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b80aa712ecd3dea731c",
-      "lastUpdated": "2026-03-03T00:32:25.281Z"
+      "url": "https://console-test.testdriver.ai/runs/69c32c95b4a333234cc21a6c/69c32cb96560e1c6d04ac34e",
+      "lastUpdated": "2026-03-25T00:32:02.419Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/_scripts/extract-example-urls.js

@@ -1,39 +1,33 @@
 #!/usr/bin/env node
 
 /**
- * Extract Example URLs from CI Logs
- * 
- * Parses vitest output to extract TESTDRIVER_EXAMPLE_URL lines
- * and updates the examples-manifest.json file.
- * 
+ * Extract Example URLs from Test Result JSON Files
+ *
+ * Reads per-test-case JSON result files written by the vitest plugin
+ * to .testdriver/results/ and updates examples-manifest.json.
+ *
  * Usage:
- *   cat ci-log.txt | node extract-example-urls.js
- *   node extract-example-urls.js < ci-log.txt
- *   node extract-example-urls.js --file=ci-log.txt
+ *   node extract-example-urls.js --results-dir=.testdriver/results
  */
 
 const fs = require("fs");
 const path = require("path");
-const readline = require("readline");
 
 const MANIFEST_PATH = path.join(__dirname, "../_data/examples-manifest.json");
 
-// Regex to match TESTDRIVER_EXAMPLE_URL::filename::url (handles optional timestamp prefix from CI logs)
-const URL_PATTERN = /TESTDRIVER_EXAMPLE_URL::([^:]+)::(.+)$/;
-
 // Parse command line arguments
 function parseArgs() {
   const args = process.argv.slice(2);
   const options = {
-    file: null,
+    resultsDir: null,
     help: false,
   };
 
   for (const arg of args) {
     if (arg === "--help" || arg === "-h") {
       options.help = true;
-    } else if (arg.startsWith("--file=")) {
-      options.file = arg.slice(7);
+    } else if (arg.startsWith("--results-dir=")) {
+      options.resultsDir = arg.slice(14);
     }
   }
 
@@ -62,40 +56,51 @@ function saveManifest(manifest) {
   fs.writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
 }
 
-// Process a single line and extract URL if present
-function processLine(line, manifest, stats) {
-  const match = line.match(URL_PATTERN);
-  if (match) {
-    const [, filename, url] = match;
-    const isNew = !manifest.examples[filename];
-    
-    manifest.examples[filename] = {
-      url: url.trim(),
-      lastUpdated: new Date().toISOString(),
-    };
-    
-    if (isNew) {
-      stats.added++;
-    } else {
-      stats.updated++;
-    }
-    
-    console.log(`${isNew ? "➕" : "🔄"} ${filename}: ${url}`);
-  }
-}
-
-// Process input stream
-async function processInput(inputStream) {
+// Process JSON result files from .testdriver/results/
+function processResultsDir(resultsDir) {
   const manifest = loadManifest();
   const stats = { added: 0, updated: 0 };
 
-  const rl = readline.createInterface({
-    input: inputStream,
-    crlfDelay: Infinity,
-  });
+  // Look for JSON files under examples/ subdirectories
+  const examplesDir = path.join(resultsDir, "examples");
+  if (!fs.existsSync(examplesDir)) {
+    console.log(`\n⚠️  No examples results found in ${examplesDir}`);
+    return stats;
+  }
 
-  for await (const line of rl) {
-    processLine(line, manifest, stats);
+  // Walk example test directories (e.g., examples/assert.test.mjs/)
+  const testDirs = fs.readdirSync(examplesDir, { withFileTypes: true });
+  for (const entry of testDirs) {
+    if (!entry.isDirectory()) continue;
+    const testDir = path.join(examplesDir, entry.name);
+    const jsonFiles = fs.readdirSync(testDir).filter(f => f.endsWith(".json"));
+
+    for (const jsonFile of jsonFiles) {
+      try {
+        const content = fs.readFileSync(path.join(testDir, jsonFile), "utf-8");
+        const result = JSON.parse(content);
+        const testFileName = path.basename(result.test?.file || result.testFile || entry.name);
+        const url = result.urls?.testRun || result.testRunLink;
+
+        if (!url) continue;
+
+        const isNew = !manifest.examples[testFileName];
+        manifest.examples[testFileName] = {
+          url: url,
+          lastUpdated: result.date || new Date().toISOString(),
+        };
+
+        if (isNew) {
+          stats.added++;
+        } else {
+          stats.updated++;
+        }
+
+        console.log(`${isNew ? "➕" : "🔄"} ${testFileName}: ${url}`);
+      } catch (err) {
+        console.warn(`⚠️  Failed to read ${jsonFile}: ${err.message}`);
+      }
+    }
   }
 
   if (stats.added > 0 || stats.updated > 0) {
@@ -103,7 +108,7 @@ async function processInput(inputStream) {
     console.log(`\n✨ Manifest updated: ${stats.added} added, ${stats.updated} updated`);
     console.log(`📂 Written to: ${MANIFEST_PATH}`);
   } else {
-    console.log("\n⚠️  No TESTDRIVER_EXAMPLE_URL entries found in input");
+    console.log("\n⚠️  No example URLs found in result files");
   }
 
   return stats;
@@ -112,28 +117,24 @@ async function processInput(inputStream) {
 // Show help
 function showHelp() {
   console.log(`
-Extract Example URLs from CI Logs
+Extract Example URLs from Test Result JSON Files
 
 Usage:
-  cat ci-log.txt | node extract-example-urls.js
-  node extract-example-urls.js < ci-log.txt
-  node extract-example-urls.js --file=ci-log.txt
+  node extract-example-urls.js --results-dir=.testdriver/results
 
 Options:
-  --file=<path>   Read from file instead of stdin
-  --help, -h      Show this help message
+  --results-dir=<path>  Path to .testdriver/results directory (required)
+  --help, -h            Show this help message
 
 Description:
-  Parses CI log output looking for lines matching:
-    TESTDRIVER_EXAMPLE_URL::<filename>::<url>
-  
-  Updates docs/_data/examples-manifest.json with the extracted URLs.
+  Reads per-test-case JSON result files from .testdriver/results/examples/
+  and updates docs/_data/examples-manifest.json with the extracted URLs.
   Existing entries are updated, new entries are added.
 `);
 }
 
 // Main function
-async function main() {
+function main() {
   const options = parseArgs();
 
   if (options.help) {
@@ -141,25 +142,19 @@ async function main() {
     process.exit(0);
   }
 
-  console.log("🔍 Extracting example URLs from input...\n");
-
-  let inputStream;
-  if (options.file) {
-    if (!fs.existsSync(options.file)) {
-      console.error(`❌ File not found: ${options.file}`);
-      process.exit(1);
-    }
-    inputStream = fs.createReadStream(options.file);
-  } else {
-    inputStream = process.stdin;
+  if (!options.resultsDir) {
+    console.error("❌ --results-dir is required. Example: --results-dir=.testdriver/results");
+    process.exit(1);
   }
 
-  try {
-    await processInput(inputStream);
-  } catch (error) {
-    console.error(`❌ Error: ${error.message}`);
+  console.log("🔍 Reading example URLs from JSON result files...\n");
+
+  if (!fs.existsSync(options.resultsDir)) {
+    console.error(`❌ Results directory not found: ${options.resultsDir}`);
     process.exit(1);
   }
+
+  processResultsDir(options.resultsDir);
 }
 
 main();