@romanmatena/browsermonitor 2.0.0 → 2.1.0

package/src/templates/section-heading.mjs

@@ -5,7 +5,7 @@
 
 import boxen from 'boxen';
 import { C } from '../utils/colors.mjs';
-import { createTable, printTable } from './table-helper.mjs';
+import { createTable, formatTable, printTable } from './table-helper.mjs';
 
 /** Shared boxen options – single border, dim gray, no padding, left margin for alignment with other blocks. */
 export const BOXEN_OPTS = {
@@ -73,18 +73,21 @@ function wrapPlainText(text, maxLen) {
  */
 const MAX_LINE_WIDTH = 71; // wrap long lines at this (prefix excluded)
 
-export function printBulletBox(lines, indent = '  ') {
+export function printBulletBox(lines, indent = '  ', opts = {}) {
   if (lines.length === 0) return;
+  const dim = opts.dim || false;
   const bullet = ' • ';
+  const bulletColor = dim ? C.dim : C.cyan;
   const contentWidth = MAX_LINE_WIDTH;
   const contentLines = [];
   for (const line of lines) {
     const plain = stripAnsi(line);
     const wrapped = plain.length <= contentWidth ? [line] : wrapPlainText(plain, contentWidth);
     for (let i = 0; i < wrapped.length; i++) {
-      const prefix = i === 0 ? `${C.cyan}${bullet}${C.reset}` : '   ';
+      const prefix = i === 0 ? `${bulletColor}${bullet}${C.reset}` : '   ';
       const chunk = wrapped[i];
-      const display = i === 0 && wrapped.length === 1 ? line : chunk;
+      let display = i === 0 && wrapped.length === 1 ? line : chunk;
+      if (dim) display = `${C.dim}${stripAnsi(display)}${C.reset}`;
       contentLines.push(`${prefix}${display}`);
     }
   }
@@ -94,7 +97,9 @@ export function printBulletBox(lines, indent = '  ') {
     tableOpts: { wordWrap: true, maxWidth: 80 },
   });
   table.push([content]);
-  printTable(table, indent);
+  let output = formatTable(table, indent);
+  if (dim) output = `${C.dim}${output}${C.reset}`;
+  console.log(output);
 }
 
 /**
@@ -110,17 +115,6 @@ export function printModeHeading(mode, indent = '  ') {
   console.log(renderBox(content, indent));
 }
 
-/**
- * Print Interactive menu block – title with blue background filling full width.
- * Options are printed outside the box by the caller.
- * @param {string} titleLine - e.g. "  Interactive   Chrome not started – choose action"
- * @param {string} [indent='  ']
- */
-export function printInteractiveMenuBlock(titleLine, indent = '  ') {
-  const content = `${C.bgCyan}${C.bold}${C.white}${titleLine}${C.reset}`;
-  console.log(renderBox(content, indent));
-}
-
 /**
  * Print Join connected block – WSL title (blue bg) + monitored URL. Shown when join succeeds.
  * Single-cell table.

package/src/utils/ask.mjs

@@ -1,49 +1,115 @@
 /**
- * CLI prompt helpers (yes/no, port, etc.).
+ * CLI prompt helpers.
+ * All prompts use stdin.once('data') to keep stdin open for keypress listeners.
  */
 
 import readline from 'readline';
 import { C } from './colors.mjs';
 
 /**
- * Ask user a yes/no question.
- * @param {string} prompt
- * @returns {Promise<boolean>} true for y/yes, false otherwise
+ * Read one line from stdin without closing it.
+ * Handles raw mode save/restore for interactive mode compatibility.
  */
-export function askYesNo(prompt) {
+function readLine(prompt) {
   return new Promise((resolve) => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(`${prompt} [y/N]: `, (answer) => {
-      rl.close();
-      const normalized = (answer || '').trim().toLowerCase();
-      resolve(normalized === 'y' || normalized === 'yes');
+    const wasRaw = process.stdin.isTTY && process.stdin.isRaw;
+    if (wasRaw) process.stdin.setRawMode(false);
+
+    process.stdout.write(prompt);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    process.stdin.once('data', (chunk) => {
+      process.stdin.pause();
+      if (wasRaw && process.stdin.isTTY) process.stdin.setRawMode(true);
+      resolve(chunk.toString().trim().split('\n')[0].trim());
     });
   });
 }
 
-const DEFAULT_HTTP_PORT = 60001;
+/**
+ * Ask user for default URL.
+ * @param {string} [defaultValue='https://localhost:4000/']
+ * @returns {Promise<string>}
+ */
+async function askDefaultUrl(defaultValue = 'https://localhost:4000/') {
+  const answer = await readLine(`  ${C.cyan}Default URL${C.reset} [${C.dim}${defaultValue}${C.reset}]: `);
+  return answer || defaultValue;
+}
+
+/**
+ * Return currentValue if set, otherwise ask the user for default URL.
+ * @param {string|null|undefined} currentValue - From CLI args or config
+ * @param {string} [defaultUrl='about:blank']
+ * @returns {Promise<string>}
+ */
+export async function resolveDefaultUrl(currentValue, defaultUrl = 'about:blank') {
+  if (currentValue != null) return currentValue;
+  return askDefaultUrl(defaultUrl);
+}
+
+/**
+ * Ask user for HTTP API port.
+ * @param {number} [defaultPort=60001]
+ * @returns {Promise<number>}
+ */
+async function askHttpPort(defaultPort = 60001) {
+  const answer = await readLine(`  ${C.cyan}HTTP API port${C.reset} [${C.dim}${defaultPort}${C.reset}]: `);
+  if (!answer) return defaultPort;
+  const num = parseInt(answer, 10);
+  return !Number.isNaN(num) && num >= 1 && num <= 65535 ? num : defaultPort;
+}
 
 /**
- * Ask user for HTTP API port; default 60001.
+ * Return currentValue if set, otherwise ask the user for HTTP port.
+ * @param {number|null|undefined} currentValue - From CLI args or config
  * @param {number} [defaultPort=60001]
- * @returns {Promise<number>} port 1–65535
+ * @returns {Promise<number>}
  */
-export function askHttpPort(defaultPort = DEFAULT_HTTP_PORT) {
+export async function resolveHttpPort(currentValue, defaultPort = 60001) {
+  if (currentValue != null) return currentValue;
+  return askHttpPort(defaultPort);
+}
+
+/**
+ * Ask user a yes/no question.
+ * @param {string} prompt
+ * @returns {Promise<boolean>}
+ */
+export async function askYesNo(prompt) {
+  const answer = await readLine(`${prompt} [y/N]: `);
+  const normalized = answer.toLowerCase();
+  return normalized === 'y' || normalized === 'yes';
+}
+
+/**
+ * Ask user to choose action: open, join, or quit.
+ * Single keypress – no Enter needed.
+ * @returns {Promise<'o'|'j'|'q'>}
+ */
+export function askMode() {
+  console.log('');
+  console.log(`    ${C.green}o${C.reset} = open Chrome`);
+  console.log(`    ${C.green}j${C.reset} = join running Chrome`);
+  console.log(`    ${C.green}q${C.reset} = quit`);
+  console.log('');
+  process.stdout.write(`  ${C.cyan}Action${C.reset} [o/j/q]: `);
+
+  readline.emitKeypressEvents(process.stdin);
+  if (process.stdin.isTTY && !process.stdin.isRaw) {
+    process.stdin.setRawMode(true);
+  }
+  process.stdin.resume();
+
   return new Promise((resolve) => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(`  ${C.cyan}HTTP API port${C.reset} (${C.green}Enter${C.reset} = ${defaultPort}): `, (answer) => {
-      rl.close();
-      const trimmed = (answer || '').trim();
-      if (trimmed === '') {
-        resolve(defaultPort);
-        return;
-      }
-      const num = parseInt(trimmed, 10);
-      if (Number.isNaN(num) || num < 1 || num > 65535) {
-        resolve(defaultPort);
-        return;
+    const handleKey = (str, key) => {
+      if (!key) return;
+      const char = (key.name || str || '').toLowerCase();
+      if (char === 'o' || char === 'j' || char === 'q') {
+        process.stdin.removeListener('keypress', handleKey);
+        process.stdout.write(char + '\n');
+        resolve(char);
       }
-      resolve(num);
-    });
+    };
+    process.stdin.on('keypress', handleKey);
   });
 }

package/src/utils/chrome-instances.mjs

@@ -0,0 +1,81 @@
+/**
+ * Chrome instance discovery and selection utilities.
+ * Used by join mode and interactive mode to find running Chrome instances.
+ */
+
+import { C, log } from './colors.mjs';
+import { writeStatusLine, clearStatusLine } from './status-line.mjs';
+import { isWsl, scanChromeInstances } from '../os/wsl/index.mjs';
+import { ensureKeypressEvents } from '../monitor/tab-selection.mjs';
+
+/**
+ * Collect Chrome instances with remote debugging.
+ * @returns {Promise<Array<{ port: number, label: string }>>}
+ */
+export async function getChromeInstances() {
+  writeStatusLine(`${C.dim}Scanning for Chrome...${C.reset}`);
+  try {
+    if (isWsl()) {
+      const { instances } = scanChromeInstances();
+      return instances.map((i) => ({ port: i.port, label: `${i.port} – ${i.profile}` }));
+    }
+    const list = [];
+    const host = '127.0.0.1';
+    for (let port = 9222; port <= 9229; port++) {
+      try {
+        const res = await fetch(`http://${host}:${port}/json/version`, { signal: AbortSignal.timeout(800) });
+        if (res.ok) {
+          const info = await res.json();
+          const label = info.Browser ? `${port} – ${info.Browser}` : String(port);
+          list.push({ port, label });
+        }
+      } catch {
+        // Port not reachable
+      }
+    }
+    return list;
+  } finally {
+    clearStatusLine();
+  }
+}
+
+/**
+ * Let user pick one Chrome instance from list.
+ * @param {Array<{ port: number, label: string }>} items
+ * @returns {Promise<number|null>}
+ */
+export function askUserToSelectChromeInstance(items) {
+  if (items.length === 0) return Promise.resolve(null);
+  if (items.length === 1) {
+    return Promise.resolve(items[0].port);
+  }
+  console.log('');
+  items.forEach((item, index) => {
+    console.log(`  ${C.brightGreen}${index + 1}${C.reset}. ${C.cyan}${item.label}${C.reset}`);
+  });
+  console.log('');
+  console.log(`  ${C.red}q${C.reset}. Cancel`);
+  console.log('');
+  ensureKeypressEvents();
+  return new Promise((resolve) => {
+    process.stdout.write(`${C.cyan}Select Chrome instance${C.reset} (${C.green}1-${items.length}${C.reset}, ${C.red}q${C.reset}=cancel): `);
+    const handleKey = (str, key) => {
+      if (!key) return;
+      process.stdin.removeListener('keypress', handleKey);
+      const char = (key.name || str).toLowerCase();
+      process.stdout.write(char + '\n');
+      if (char === 'q') {
+        resolve(null);
+      } else {
+        const num = parseInt(char, 10);
+        if (num >= 1 && num <= items.length) {
+          resolve(items[num - 1].port);
+        } else {
+          log.warn('Invalid selection');
+          resolve(null);
+        }
+      }
+    };
+    process.stdin.once('keypress', handleKey);
+  });
+}

package/src/utils/chrome-profile-path.mjs

@@ -1,21 +1,26 @@
 /**
- * Where the Chrome profile is stored for open mode.
- * Depends on platform: native Linux/Mac = project dir; WSL = Windows path (same drive or LOCALAPPDATA).
+ * Where the Chrome profile is stored.
+ * Depends on platform:
+ *   - native Linux/Mac = .browsermonitor/.chrome-profile (matches getPaths().chromeProfileDir)
+ *   - WSL /mnt/ = same dir converted to Windows drive letter
+ *   - WSL (project on WSL fs) = Windows LOCALAPPDATA\browsermonitor\{profileId}
  */
 
 import path from 'path';
 import { isWsl } from './env.mjs';
 import { getWindowsProfilePath } from '../os/wsl/chrome.mjs';
+import { BROWSERMONITOR_DIR, CHROME_PROFILE_DIR } from '../settings.mjs';
 
 /**
  * Get Chrome profile path and a short description for the current platform.
+ * Non-WSL path matches getPaths().chromeProfileDir from settings.mjs.
  * @param {string} projectDir - Project root (outputDir)
  * @returns {{ path: string, where: string }}
  */
 export function getChromeProfileLocation(projectDir) {
   if (!isWsl()) {
     return {
-      path: path.join(projectDir, '.browsermonitor-profile'),
+      path: path.join(projectDir, BROWSERMONITOR_DIR, CHROME_PROFILE_DIR),
       where: 'Project directory',
     };
   }
@@ -25,7 +30,7 @@ export function getChromeProfileLocation(projectDir) {
       .replace(/^\/mnt\/([a-z])\//, (_, d) => `${d.toUpperCase()}:\\`)
       .replace(/\//g, '\\');
     return {
-      path: `${winPath}\\.browsermonitor-profile`,
+      path: `${winPath}\\${BROWSERMONITOR_DIR}\\${CHROME_PROFILE_DIR}`,
       where: 'Windows (same drive as project)',
     };
   }

package/src/utils/status-line.mjs

@@ -37,11 +37,3 @@ export function clearStatusLine(ensureNewline = false) {
   lastLength = 0;
 }
 
-/**
- * Finish status line with newline (keeps the message visible).
- */
-export function finishStatusLine() {
-  if (!process.stdout.isTTY || lastLength === 0) return;
-  process.stdout.write('\n');
-  lastLength = 0;
-}

package/src/monitor/index.mjs

@@ -1,18 +0,0 @@
-/**
- * Monitor submodule – re-exports and shared pieces.
- * Public API (runJoinMode, runOpenMode, runInteractiveMode) lives in ../monitor.mjs
- * to avoid circular deps. This index documents the monitor/ layout:
- *
- * - page-monitoring.mjs    – shared console/network listeners for a page
- * - tab-selection.mjs      – askUserToSelectPage, ensureKeypressEvents
- * - interactive-mode.mjs   – runInteractiveMode(options, deps), getChromeInstances, askProjectDirForOpen
- */
-
-export { setupPageMonitoring } from './page-monitoring.mjs';
-export { askUserToSelectPage, ensureKeypressEvents } from './tab-selection.mjs';
-export {
-  runInteractiveMode,
-  getChromeInstances,
-  askProjectDirForOpen,
-  askUserToSelectChromeInstance,
-} from './interactive-mode.mjs';

package/src/monitor/interactive-mode.mjs

@@ -1,275 +0,0 @@
-/**
- * Interactive mode: no Chrome started; user chooses open (o) or join (j).
- * Exports runInteractiveMode(options, deps) where deps = { runOpenMode, runJoinMode }
- * to avoid circular dependency with monitor.mjs.
- */
-
-import fs from 'fs';
-import path from 'path';
-import readline from 'readline';
-import { C, log } from '../utils/colors.mjs';
-import { getChromeProfileLocation } from '../utils/chrome-profile-path.mjs';
-import { getLastCmdStderrAndClear, isWsl, scanChromeInstances } from '../os/wsl/index.mjs';
-import { printBulletBox, printInteractiveMenuBlock, printModeHeading } from '../templates/section-heading.mjs';
-import { createTable, printTable } from '../templates/table-helper.mjs';
-import { buildWaitForChromeContent } from '../templates/wait-for-chrome.mjs';
-import { writeStatusLine, clearStatusLine } from '../utils/status-line.mjs';
-import { getPaths, ensureDirectories } from '../settings.mjs';
-
-/**
- * Collect Chrome instances with remote debugging (for interactive "join").
- * @returns {Promise<Array<{ port: number, label: string }>>}
- */
-export async function getChromeInstances() {
-  writeStatusLine(`${C.dim}Scanning for Chrome...${C.reset}`);
-  try {
-    if (isWsl()) {
-      const { instances } = scanChromeInstances();
-      return instances.map((i) => ({ port: i.port, label: `${i.port} – ${i.profile}` }));
-    }
-    const list = [];
-    const host = '127.0.0.1';
-    for (let port = 9222; port <= 9229; port++) {
-      try {
-        const res = await fetch(`http://${host}:${port}/json/version`, { signal: AbortSignal.timeout(800) });
-        if (res.ok) {
-          const info = await res.json();
-          const label = info.Browser ? `${port} – ${info.Browser}` : String(port);
-          list.push({ port, label });
-        }
-      } catch {
-        // Port not reachable
-      }
-    }
-    return list;
-  } finally {
-    clearStatusLine();
-  }
-}
-
-/**
- * Ask user which directory to use as project root when opening Chrome (key 'o').
- * Reads one line via stdin.once('data') so that stdin is NOT closed (readline.close()
- * would destroy stdin and the process would exit before the menu keypress listener runs).
- * @param {string} currentCwd
- * @returns {Promise<string>} Resolved absolute path to use as outputDir
- */
-export function askProjectDirForOpen(currentCwd) {
-  return new Promise((resolve) => {
-    const wasRaw = process.stdin.isTTY && process.stdin.isRaw;
-    if (wasRaw) process.stdin.setRawMode(false);
-
-    console.log('');
-    process.stdout.write(`  ${C.cyan}Project root${C.reset}: ${C.brightCyan}${currentCwd}${C.reset} (${C.green}Enter${C.reset} = use, or type path): `);
-
-    const onData = (chunk) => {
-      process.stdin.removeListener('data', onData);
-      process.stdin.pause();
-      if (wasRaw && process.stdin.isTTY) process.stdin.setRawMode(true);
-
-      const trimmed = (chunk.toString().trim().split('\n')[0] || '').trim();
-      if (trimmed === '') {
-        resolve(currentCwd);
-        return;
-      }
-      const resolved = path.resolve(currentCwd, trimmed);
-      try {
-        const stat = fs.statSync(resolved);
-        if (!stat.isDirectory()) {
-          log.warn(`Not a directory: ${resolved}, using current dir.`);
-          resolve(currentCwd);
-          return;
-        }
-      } catch {
-        log.warn(`Path not found: ${resolved}, using current dir.`);
-        resolve(currentCwd);
-        return;
-      }
-      resolve(resolved);
-    };
-    process.stdin.resume();
-    process.stdin.setEncoding('utf8');
-    process.stdin.once('data', onData);
-  });
-}
-
-/**
- * Let user pick one Chrome instance from list.
- * @param {Array<{ port: number, label: string }>} items
- * @returns {Promise<number|null>}
- */
-export function askUserToSelectChromeInstance(items) {
-  if (items.length === 0) return Promise.resolve(null);
-  if (items.length === 1) {
-    return Promise.resolve(items[0].port);
-  }
-  console.log('');
-  items.forEach((item, index) => {
-    console.log(`  ${C.brightGreen}${index + 1}${C.reset}. ${C.cyan}${item.label}${C.reset}`);
-  });
-  console.log('');
-  console.log(`  ${C.red}q${C.reset}. Cancel`);
-  console.log('');
-  return new Promise((resolve) => {
-    process.stdout.write(`${C.cyan}Select Chrome instance${C.reset} (${C.green}1-${items.length}${C.reset}, ${C.red}q${C.reset}=cancel): `);
-    const handleKey = (str, key) => {
-      if (!key) return;
-      process.stdin.removeListener('keypress', handleKey);
-      const char = (key.name || str).toLowerCase();
-      process.stdout.write(char + '\n');
-      if (char === 'q') {
-        resolve(null);
-      } else {
-        const num = parseInt(char, 10);
-        if (num >= 1 && num <= items.length) {
-          resolve(items[num - 1].port);
-        } else {
-          log.warn('Invalid selection');
-          resolve(null);
-        }
-      }
-    };
-    process.stdin.once('keypress', handleKey);
-  });
-}
-
-/**
- * Run in Interactive Mode. Requires runOpenMode and runJoinMode to be passed to avoid circular deps.
- * @param {Object} options
- * @param {{ runOpenMode: Function, runJoinMode: Function }} deps
- */
-export async function runInteractiveMode(options, deps) {
-  const {
-    defaultUrl = 'https://localhost:4000/',
-    realtime = false,
-    headless = false,
-    hardTimeout = 0,
-    navigationTimeout = 60_000,
-    outputDir: optionsOutputDir = process.cwd(),
-    paths: optionsPaths = null,
-    ignorePatterns = [],
-    httpPort = 60001,
-  } = options;
-
-  const { runOpenMode, runJoinMode } = deps;
-
-  // Ask for project root when interactive; otherwise use option/cwd
-  const outputDir = process.stdin.isTTY
-    ? await askProjectDirForOpen(process.cwd())
-    : (optionsOutputDir || process.cwd());
-
-  // Recompute paths if project root changed from CLI's original
-  const paths = (outputDir !== optionsOutputDir && optionsPaths)
-    ? getPaths(outputDir)
-    : (optionsPaths || getPaths(outputDir));
-  ensureDirectories(outputDir);
-
-  const profileLoc = getChromeProfileLocation(outputDir);
-  const cmdStderrLines = getLastCmdStderrAndClear();
-  // Merge UNC path line with CMD.EXE message (path first in stderr, then "CMD.EXE was started...")
-  let mergedStderr = [];
-  for (let i = 0; i < cmdStderrLines.length; i++) {
-    const curr = cmdStderrLines[i];
-    const next = cmdStderrLines[i + 1];
-    if (next && /^'\\\\/.test(curr) && /CMD\.EXE was started/i.test(next)) {
-      mergedStderr.push(`${next} ${curr}`);
-      i++;
-    } else {
-      mergedStderr.push(curr);
-    }
-  }
-  const infoLines = [
-    ...mergedStderr,
-    `${C.cyan}Profile path:${C.reset} ${profileLoc.path} ${C.dim}(${profileLoc.where})${C.reset}`,
-  ];
-  if (infoLines.length > 0) {
-    console.log('');
-    printBulletBox(infoLines);
-  }
-
-  readline.emitKeypressEvents(process.stdin);
-  if (process.stdin.isTTY) {
-    process.stdin.setRawMode(true);
-  }
-  process.stdin.resume(); // ensure stdin is readable after askProjectDirForOpen (may have paused it)
-
-  const MENU_INDENT = '    ';
-  const showMenu = () => {
-    console.log('');
-    printInteractiveMenuBlock('  Interactive   Chrome not started – choose action');
-    console.log(`${MENU_INDENT}${C.green}o${C.reset} = open Chrome (launch new browser → ${C.cyan}${defaultUrl}${C.reset})`);
-    console.log(`${MENU_INDENT}${C.green}j${C.reset} = join running Chrome (pick existing instance/tab)`);
-    console.log(`${MENU_INDENT}${C.green}q${C.reset} = quit`);
-  };
-
-  showMenu();
-
-  process.stdin.on('keypress', async (str, key) => {
-    if (key?.ctrl && key?.name === 'c') {
-      process.exit(0);
-    }
-    if (key?.ctrl || key?.shift || key?.meta) return;
-    const char = (key?.name || str)?.toLowerCase();
-    if (char === 'q') {
-      process.exit(0);
-    }
-    if (char === 'o') {
-      process.stdin.removeAllListeners('keypress');
-      process.stdin.setRawMode?.(false);
-      await runOpenMode(defaultUrl, {
-        realtime,
-        headless,
-        outputDir,
-        paths,
-        ignorePatterns,
-        hardTimeout,
-        navigationTimeout,
-        httpPort,
-        sharedHttpState: options.sharedHttpState,
-        sharedHttpServer: options.sharedHttpServer,
-        skipProfileBlock: true,
-      });
-      return;
-    }
-    if (char === 'j') {
-      printModeHeading('Join mode');
-      let instances = await getChromeInstances();
-      while (instances.length === 0) {
-        const hint = isWsl()
-          ? 'Start Chrome on Windows with: chrome.exe --remote-debugging-port=9222'
-          : 'Start Chrome with: google-chrome --remote-debugging-port=9222';
-        const titleContent = `${C.yellow}No Chrome with remote debugging found.${C.reset}\n${C.dim}${hint}${C.reset}`;
-        const content = buildWaitForChromeContent(titleContent);
-        const table = createTable({ colWidths: [72], tableOpts: { wordWrap: true } });
-        table.push([content]);
-        printTable(table);
-        await new Promise((resolve) => {
-          process.stdin.setRawMode?.(false);
-          process.stdin.resume();
-          process.stdin.once('data', () => {
-            if (process.stdin.isTTY) process.stdin.setRawMode(true);
-            resolve();
-          });
-        });
-        console.log('');
-        instances = await getChromeInstances();
-      }
-      const port = await askUserToSelectChromeInstance(instances);
-      if (port == null) return;
-      process.stdin.removeAllListeners('keypress');
-      process.stdin.setRawMode?.(false);
-      await runJoinMode(port, {
-        realtime,
-        outputDir,
-        paths,
-        ignorePatterns,
-        hardTimeout,
-        defaultUrl,
-        httpPort,
-        sharedHttpState: options.sharedHttpState,
-        sharedHttpServer: options.sharedHttpServer,
-        skipModeHeading: true,
-      });
-    }
-  });
-}

package/src/monitor.mjs

@@ -1,39 +0,0 @@
-/**
- * Browser Monitor - monitors browser console and network on dev server
- *
- * Modes:
- * - Default (lazy): Stores logs in memory, writes to file on demand
- *   Press 'd' to dump logs to files (auto-clears buffer after)
- *   Press 'c' to clear memory buffer
- *   Press 's' to show status
- *   Press 'k' to kill Chrome and exit
- *   Press 'q' to quit
- * - Realtime (--realtime): Writes every event immediately to files
- *
- * Features:
- * - Console output -> .browsermonitor/.puppeteer/console.log (filtered, with HMR detection)
- * - Network requests -> .browsermonitor/.puppeteer/network-log/ directory
- *   - .browsermonitor/.puppeteer/network.log - main log with request IDs
- *   - {id}.json - detailed request/response for each request
- * - DOM dump on /dump or key 'd' -> .browsermonitor/.puppeteer/dom.html (current JS-modified HTML structure)
- * - Console clear detection (clears buffer/log file)
- * - GUI browser mode (user can interact)
- * - HTTP API for LLM integration (default port 60001)
- *   - GET/POST /dump - Trigger dump of buffered logs
- *   - GET /status - Get current buffer status
- * - Proper cleanup on exit (SIGINT, SIGTERM, uncaughtException)
- */
-
-// Re-export modes (implementations live in monitor/ to keep this file small)
-export { runJoinMode } from './monitor/join-mode.mjs';
-export { runOpenMode } from './monitor/open-mode.mjs';
-
-/**
- * Run in Interactive Mode – delegates to monitor/interactive-mode.mjs with runOpenMode/runJoinMode to avoid circular deps.
- */
-export async function runInteractiveMode(options = {}) {
-  const { runInteractiveMode: runInteractive } = await import('./monitor/interactive-mode.mjs');
-  const { runOpenMode } = await import('./monitor/open-mode.mjs');
-  const { runJoinMode } = await import('./monitor/join-mode.mjs');
-  return runInteractive(options, { runOpenMode, runJoinMode });
-}