browser-debugger-cli 0.3.0 → 0.5.1

package/dist/cli/handlers/SignalHandler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Interface for shutdown callback
+ */
+export interface SignalHandlerOptions {
+    onShutdown: () => Promise<void>;
+}
+/**
+ * Manages process signal handling for graceful shutdown
+ */
+export declare class SignalHandler {
+    private options;
+    private isHandling;
+    constructor(options: SignalHandlerOptions);
+    /**
+     * Register signal handlers for graceful shutdown.
+     */
+    register(): void;
+    /**
+     * Unregister all signal handlers.
+     */
+    unregister(): void;
+    /**
+     * Handle shutdown signals (SIGINT, SIGTERM)
+     */
+    private handleSignal;
+    /**
+     * Handle unhandled promise rejections
+     */
+    private handleUnhandledRejection;
+    /**
+     * Handle uncaught exceptions
+     */
+    private handleUncaughtException;
+}
+//# sourceMappingURL=SignalHandler.d.ts.map

package/dist/cli/handlers/SignalHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalHandler.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/SignalHandler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,UAAU,CAAS;gBAEP,OAAO,EAAE,oBAAoB;IAEjD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAUhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,wBAAwB,CAS9B;IAEF;;OAEG;IACH,OAAO,CAAC,uBAAuB,CAS7B;CACH"}

package/dist/cli/handlers/SignalHandler.js

@@ -0,0 +1,81 @@
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { cleanupSession } from '../../utils/session.js';
+/**
+ * Manages process signal handling for graceful shutdown
+ */
+export class SignalHandler {
+    options;
+    isHandling = false;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Register signal handlers for graceful shutdown.
+     */
+    register() {
+        const handler = (signal) => this.handleSignal(signal);
+        process.on('SIGINT', () => handler('SIGINT'));
+        process.on('SIGTERM', () => handler('SIGTERM'));
+        process.on('unhandledRejection', this.handleUnhandledRejection);
+        process.on('uncaughtException', this.handleUncaughtException);
+    }
+    /**
+     * Unregister all signal handlers.
+     */
+    unregister() {
+        process.removeAllListeners('SIGINT');
+        process.removeAllListeners('SIGTERM');
+        process.removeAllListeners('unhandledRejection');
+        process.removeAllListeners('uncaughtException');
+    }
+    /**
+     * Handle shutdown signals (SIGINT, SIGTERM)
+     */
+    handleSignal(signal) {
+        if (this.isHandling) {
+            return;
+        }
+        this.isHandling = true;
+        console.error(`\nReceived ${signal}, shutting down gracefully...`);
+        this.unregister();
+        void (async () => {
+            try {
+                await this.options.onShutdown();
+                // onShutdown calls process.exit(), so we should never reach here
+            }
+            catch (error) {
+                console.error('Fatal error during shutdown:', error);
+                process.exit(EXIT_CODES.SIGNAL_HANDLER_ERROR);
+            }
+        })();
+    }
+    /**
+     * Handle unhandled promise rejections
+     */
+    handleUnhandledRejection = (reason) => {
+        console.error('Unhandled rejection:', reason);
+        console.error('Cleaning up session files...');
+        try {
+            cleanupSession();
+        }
+        catch (error) {
+            console.error('Error during cleanup:', error);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    };
+    /**
+     * Handle uncaught exceptions
+     */
+    handleUncaughtException = (error) => {
+        console.error('Uncaught exception:', error);
+        console.error('Cleaning up session files...');
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error during cleanup:', cleanupError);
+        }
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    };
+}
+//# sourceMappingURL=SignalHandler.js.map

package/dist/cli/handlers/SignalHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalHandler.js","sourceRoot":"","sources":["../../../src/cli/handlers/SignalHandler.ts"],"names":[],"mappings":"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"}

package/dist/cli/handlers/TargetSetup.d.ts

@@ -0,0 +1,42 @@
+import { BdgSession } from '../../session/BdgSession.js';
+import type { CDPTarget, SessionOptions } from '../../types.js';
+/**
+ * Handles CDP target setup and session creation
+ */
+export declare class TargetSetup {
+    /**
+     * Create CDP connection and find/create target tab
+     *
+     * @param url - Original URL from CLI (for matching)
+     * @param targetUrl - Normalized target URL
+     * @param port - Chrome debugging port
+     * @param reuseTab - Whether to reuse existing tab
+     * @param sessionOptions - Session-level collection options
+     * @returns Session and target metadata
+     */
+    static setup(url: string, targetUrl: string, port: number, reuseTab: boolean, sessionOptions?: SessionOptions): Promise<{
+        session: BdgSession;
+        target: CDPTarget;
+    }>;
+    /**
+     * Fetch the current list of available CDP targets from Chrome.
+     * Used during session bootstrap to select a temporary connection target and to
+     * refresh metadata when the session creates or reuses tabs.
+     *
+     * @param port - Chrome debugging port
+     * @returns Array of CDP targets
+     */
+    private static fetchTargets;
+    /**
+     * Locate a specific CDP target by ID. Falls back to a fresh fetch when cached
+     * metadata is missing or incomplete (e.g., webSocketDebuggerUrl absent).
+     *
+     * @param targetId - Target ID to find
+     * @param port - Chrome debugging port
+     * @param cachedTargets - Optional cached target list
+     * @returns CDP target with webSocketDebuggerUrl
+     * @throws Error if target not found or missing webSocketDebuggerUrl
+     */
+    private static findTargetById;
+}
+//# sourceMappingURL=TargetSetup.d.ts.map

package/dist/cli/handlers/TargetSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TargetSetup.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/TargetSetup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;OASG;WACU,KAAK,CAChB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAoCtD;;;;;;;OAOG;mBACkB,YAAY;IAKjC;;;;;;;;;OASG;mBACkB,cAAc;CA2BpC"}

package/dist/cli/handlers/TargetSetup.js

@@ -0,0 +1,87 @@
+import { createOrFindTarget } from '../../connection/tabs.js';
+import { BdgSession } from '../../session/BdgSession.js';
+/**
+ * Handles CDP target setup and session creation
+ */
+export class TargetSetup {
+    /**
+     * Create CDP connection and find/create target tab
+     *
+     * @param url - Original URL from CLI (for matching)
+     * @param targetUrl - Normalized target URL
+     * @param port - Chrome debugging port
+     * @param reuseTab - Whether to reuse existing tab
+     * @param sessionOptions - Session-level collection options
+     * @returns Session and target metadata
+     */
+    static async setup(url, targetUrl, port, reuseTab, sessionOptions = {}) {
+        // Fetch targets once
+        const initialTargets = await this.fetchTargets(port);
+        if (initialTargets.length === 0) {
+            throw new Error('No targets available in Chrome');
+        }
+        // Use first available target to establish CDP connection
+        const tempTarget = initialTargets[0];
+        if (!tempTarget) {
+            throw new Error('No targets available in Chrome');
+        }
+        const tempSession = new BdgSession(tempTarget, port, sessionOptions);
+        await tempSession.connect();
+        if (!tempSession.isConnected()) {
+            throw new Error('Failed to establish CDP connection');
+        }
+        // Create or find target tab using TabManager
+        console.error(`Finding or creating tab for: ${targetUrl}`);
+        const target = await createOrFindTarget(url, tempSession.getCDP(), reuseTab);
+        console.error(`Using tab: ${target.url}`);
+        // Find full target metadata (refetches only if not in cache or new tab created)
+        const fullTarget = await this.findTargetById(target.id, port, initialTargets);
+        // Close temp session and reconnect to the correct target
+        tempSession.getCDP().close();
+        const session = new BdgSession(fullTarget, port, sessionOptions);
+        await session.connect();
+        return { session, target: fullTarget };
+    }
+    /**
+     * Fetch the current list of available CDP targets from Chrome.
+     * Used during session bootstrap to select a temporary connection target and to
+     * refresh metadata when the session creates or reuses tabs.
+     *
+     * @param port - Chrome debugging port
+     * @returns Array of CDP targets
+     */
+    static async fetchTargets(port) {
+        const response = await fetch(`http://127.0.0.1:${port}/json/list`);
+        return (await response.json());
+    }
+    /**
+     * Locate a specific CDP target by ID. Falls back to a fresh fetch when cached
+     * metadata is missing or incomplete (e.g., webSocketDebuggerUrl absent).
+     *
+     * @param targetId - Target ID to find
+     * @param port - Chrome debugging port
+     * @param cachedTargets - Optional cached target list
+     * @returns CDP target with webSocketDebuggerUrl
+     * @throws Error if target not found or missing webSocketDebuggerUrl
+     */
+    static async findTargetById(targetId, port, cachedTargets) {
+        // First check cached targets if provided
+        if (cachedTargets) {
+            const cached = cachedTargets.find((t) => t.id === targetId);
+            if (cached?.webSocketDebuggerUrl) {
+                return cached;
+            }
+        }
+        // Not in cache or missing webSocketDebuggerUrl - refetch
+        const targets = await this.fetchTargets(port);
+        const target = targets.find((t) => t.id === targetId);
+        if (!target) {
+            throw new Error(`Could not find target ${targetId}`);
+        }
+        if (!target.webSocketDebuggerUrl) {
+            throw new Error(`Could not find webSocketDebuggerUrl for target ${targetId}`);
+        }
+        return target;
+    }
+}
+//# sourceMappingURL=TargetSetup.js.map

package/dist/cli/handlers/TargetSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TargetSetup.js","sourceRoot":"","sources":["../../../src/cli/handlers/TargetSetup.ts"],"names":[],"mappings":"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"}

package/dist/cli/handlers/sessionController.d.ts

@@ -1,3 +1,4 @@
+import type { CollectorType } from '../../types.js';
 /**
  * Aggressively cleanup stale Chrome processes launched by bdg.
  *
@@ -18,4 +19,44 @@
  * @returns Number of errors encountered during cleanup
  */
 export declare function cleanupStaleChrome(): Promise<number>;
+/**
+ * Start a new session
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @param options.port - Chrome debugging port
+ * @param options.timeout - Auto-stop after timeout (seconds)
+ * @param options.reuseTab - Navigate existing tab instead of creating new one
+ * @param options.userDataDir - Chrome user data directory
+ * @param options.includeAll - Include all data (disable filtering)
+ * @param options.logLevel - Chrome launcher log level
+ * @param options.prefs - Chrome preferences as object
+ * @param options.prefsFile - Path to JSON file containing Chrome preferences
+ * @param options.chromeFlags - Additional Chrome command-line flags
+ * @param options.connectionPollInterval - Milliseconds between CDP readiness checks
+ * @param options.maxConnectionRetries - Maximum retry attempts before failing
+ * @param options.portStrictMode - Fail if Chrome debugging port is already in use
+ * @param collectors - Array of collector types to enable ('dom', 'network', 'console')
+ * @returns Promise that resolves when session completes
+ */
+export declare function startSession(url: string, options: {
+    port: number;
+    timeout?: number | undefined;
+    reuseTab?: boolean | undefined;
+    userDataDir?: string | undefined;
+    includeAll?: boolean | undefined;
+    logLevel?: 'verbose' | 'info' | 'error' | 'silent' | undefined;
+    prefs?: Record<string, unknown> | undefined;
+    prefsFile?: string | undefined;
+    chromeFlags?: string[] | undefined;
+    connectionPollInterval?: number | undefined;
+    maxConnectionRetries?: number | undefined;
+    portStrictMode?: boolean | undefined;
+    fetchAllBodies?: boolean | undefined;
+    fetchBodiesInclude?: string[] | undefined;
+    fetchBodiesExclude?: string[] | undefined;
+    networkInclude?: string[] | undefined;
+    networkExclude?: string[] | undefined;
+    compact?: boolean | undefined;
+}, collectors: CollectorType[]): Promise<void>;
 //# sourceMappingURL=sessionController.d.ts.map

package/dist/cli/handlers/sessionController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuC1D"}
+{"version":3,"file":"sessionController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAA6C,MAAM,SAAS,CAAC;AA4CxF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CA0C1D;AA8HD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,EACD,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6If"}

package/dist/cli/handlers/sessionController.js

@@ -1,4 +1,40 @@
-import { getErrorMessage } from '../../utils/errors.js';
+import { getChromeDiagnostics, formatDiagnosticsForError } from '../../utils/chromeDiagnostics.js';
+import { ChromeLaunchError } from '../../utils/errors.js';
+import { getExitCodeForError } from '../../utils/exitCodes.js';
+import { writePid, writeSessionMetadata, writeChromePid } from '../../utils/session.js';
+import { ChromeBootstrap } from './ChromeBootstrap.js';
+import { OutputBuilder } from './OutputBuilder.js';
+import { PreviewWriter } from './PreviewWriter.js';
+import { SessionLock } from './SessionLock.js';
+import { SessionLoop } from './SessionLoop.js';
+import { ShutdownController } from './ShutdownController.js';
+import { SignalHandler } from './SignalHandler.js';
+import { TargetSetup } from './TargetSetup.js';
+/**
+ * Report detailed diagnostic information when Chrome fails to launch.
+ *
+ * Uses chrome-launcher APIs to detect available Chrome installations and
+ * provide actionable error messages to help users troubleshoot.
+ *
+ * @param error Original error that caused the failure
+ */
+function reportLauncherFailure(error) {
+    console.error('\n--- Chrome Launch Diagnostics ---\n');
+    // Show original error
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${errorMessage}\n`);
+    // Get diagnostics using shared utility (cached to avoid repeated scans)
+    const diagnostics = getChromeDiagnostics();
+    const diagnosticLines = formatDiagnosticsForError(diagnostics);
+    diagnosticLines.forEach((line) => console.error(line));
+    // Provide troubleshooting steps
+    console.error('Troubleshooting:');
+    console.error('   1. Verify Chrome is installed and accessible');
+    console.error('   2. Check file permissions for Chrome binary');
+    console.error('   3. Try specifying a custom port: bdg <url> --port 9223');
+    console.error('   4. Use strict port mode: bdg <url> --port-strict');
+    console.error('   5. Check if another process is using the debugging port\n');
+}
 /**
  * Aggressively cleanup stale Chrome processes launched by bdg.
  *
@@ -22,8 +58,8 @@ export async function cleanupStaleChrome() {
     console.error('\nAttempting to kill stale Chrome processes...');
     try {
         // Import session utilities (dynamic import for ES modules)
-        const { readChromePid, clearChromePid } = await import('../../session/chrome.js');
-        const { killChromeProcess } = await import('../../session/process.js');
+        const sessionModule = await import('../../utils/session.js');
+        const { readChromePid, clearChromePid, killChromeProcess } = sessionModule;
         // Read Chrome PID from persistent cache
         const chromePid = readChromePid();
         if (!chromePid) {
@@ -42,14 +78,239 @@ export async function cleanupStaleChrome() {
             return 0;
         }
         catch (killError) {
-            console.error(`Error: Failed to kill Chrome process: ${getErrorMessage(killError)}`);
+            const errorMessage = killError instanceof Error ? killError.message : String(killError);
+            console.error(`Error: Failed to kill Chrome process: ${errorMessage}`);
             console.error('   Try manually killing Chrome processes if issues persist\n');
             return 1;
         }
     }
     catch (error) {
-        console.error(`Error: Failed to cleanup Chrome processes: ${getErrorMessage(error)}\n`);
+        console.error(`Error: Failed to cleanup Chrome processes: ${error instanceof Error ? error.message : String(error)}\n`);
         return 1;
     }
 }
+/**
+ * Encapsulates session state and lifecycle management
+ */
+class SessionContext {
+    session = null;
+    launchedChrome = null;
+    isShuttingDown = false;
+    previewWriter = null;
+    startTime;
+    target = null;
+    compact;
+    shutdownController;
+    /**
+     * Create a new session context and track the start timestamp.
+     * The context is shared with signal handlers so they can orchestrate shutdown.
+     *
+     * @param compact - If true, use compact JSON format (no indentation)
+     */
+    constructor(compact = false) {
+        this.startTime = Date.now();
+        this.compact = compact;
+        this.shutdownController = new ShutdownController(this);
+    }
+    /**
+     * Handle graceful shutdown: stops collectors, writes output, and exits.
+     *
+     * Idempotent — repeated calls after shutdown has started are ignored.
+     */
+    async stop() {
+        await this.shutdownController.shutdown();
+    }
+    /**
+     * Cleanup on error paths without exiting the process.
+     * Clears timers, tears down Chrome if bdg launched it, and removes session files.
+     */
+    async cleanup() {
+        await this.shutdownController.cleanup();
+    }
+}
+/**
+ * Phase 4: start requested collectors and persist session metadata for tooling.
+ *
+ * @param session Active BDG session instance
+ * @param collectors Collector types requested by the CLI
+ * @param startTime Timestamp when the session began
+ * @param port Chrome debugging port in use
+ * @param target Target metadata (includes websocket URL)
+ * @param chromePid PID of Chrome if bdg launched it (optional)
+ */
+async function startCollectorsAndMetadata(session, collectors, startTime, port, target, chromePid) {
+    // Start collectors with timing
+    const collectorStartTime = Date.now();
+    for (const collector of collectors) {
+        const individualStart = Date.now();
+        await session.startCollector(collector);
+        const individualDuration = Date.now() - individualStart;
+        console.error(`[PERF] Collector '${collector}' initialized: ${individualDuration}ms`);
+    }
+    const totalCollectorDuration = Date.now() - collectorStartTime;
+    console.error(`[PERF] All collectors initialized: ${totalCollectorDuration}ms`);
+    // Write session metadata
+    writePid(process.pid);
+    writeSessionMetadata({
+        bdgPid: process.pid,
+        chromePid,
+        startTime,
+        port,
+        targetId: target.id,
+        webSocketDebuggerUrl: target.webSocketDebuggerUrl,
+        activeCollectors: collectors,
+    });
+    // Note: Chrome PID cache is written immediately after launch (Phase 2)
+    // to ensure it's available even if later phases fail
+}
+/**
+ * Phase 5: Start preview writer with two-tier system
+ *
+ * Uses async I/O with mutex to prevent event loop blocking and overlapping writes.
+ */
+function startPreviewWriter(context, compact) {
+    if (!context.session) {
+        return;
+    }
+    // Create and start preview writer
+    context.previewWriter = new PreviewWriter(context.session, context.startTime, 5000, // intervalMs
+    compact);
+    context.previewWriter.start();
+}
+/**
+ * Print collection status message
+ */
+function printCollectionStatus(collectors, timeout) {
+    const collectorNames = collectors.length === 3 ? 'network, console, and DOM' : collectors.join(', ');
+    if (timeout) {
+        console.error(`Collecting ${collectorNames}... (Ctrl+C to stop and output, or wait ${timeout}s for timeout)`);
+    }
+    else {
+        console.error(`Collecting ${collectorNames}... (Ctrl+C to stop and output, or use 'bdg stop')`);
+    }
+}
+/**
+ * Start a new session
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @param options.port - Chrome debugging port
+ * @param options.timeout - Auto-stop after timeout (seconds)
+ * @param options.reuseTab - Navigate existing tab instead of creating new one
+ * @param options.userDataDir - Chrome user data directory
+ * @param options.includeAll - Include all data (disable filtering)
+ * @param options.logLevel - Chrome launcher log level
+ * @param options.prefs - Chrome preferences as object
+ * @param options.prefsFile - Path to JSON file containing Chrome preferences
+ * @param options.chromeFlags - Additional Chrome command-line flags
+ * @param options.connectionPollInterval - Milliseconds between CDP readiness checks
+ * @param options.maxConnectionRetries - Maximum retry attempts before failing
+ * @param options.portStrictMode - Fail if Chrome debugging port is already in use
+ * @param collectors - Array of collector types to enable ('dom', 'network', 'console')
+ * @returns Promise that resolves when session completes
+ */
+export async function startSession(url, options, collectors) {
+    const context = new SessionContext(options.compact ?? false);
+    // Setup signal handlers for graceful shutdown
+    const signalHandler = new SignalHandler({
+        onShutdown: async () => {
+            await context.stop();
+        },
+    });
+    signalHandler.register();
+    try {
+        // Phase 1: Lock acquisition and validation
+        const targetUrl = SessionLock.acquire(url, collectors);
+        // Phase 2: Chrome bootstrap
+        // Build launcher options, filtering out undefined values
+        const launchOptions = Object.fromEntries(Object.entries({
+            userDataDir: options.userDataDir,
+            logLevel: options.logLevel,
+            prefs: options.prefs,
+            prefsFile: options.prefsFile,
+            chromeFlags: options.chromeFlags,
+            connectionPollInterval: options.connectionPollInterval,
+            maxConnectionRetries: options.maxConnectionRetries,
+            portStrictMode: options.portStrictMode,
+        }).filter(([, value]) => value !== undefined));
+        context.launchedChrome = await ChromeBootstrap.launch(options.port, targetUrl, launchOptions);
+        // Write Chrome PID to persistent cache immediately after launch
+        // This must happen before Phase 3 so it's available even if setup fails
+        if (context.launchedChrome?.pid) {
+            writeChromePid(context.launchedChrome.pid);
+        }
+        // Phase 3: CDP connection and target setup
+        const setupStart = Date.now();
+        const sessionOptions = {
+            includeAll: options.includeAll ?? false,
+            fetchAllBodies: options.fetchAllBodies ?? false,
+            compact: options.compact ?? false,
+        };
+        if (options.fetchBodiesInclude !== undefined) {
+            sessionOptions.fetchBodiesInclude = options.fetchBodiesInclude;
+        }
+        if (options.fetchBodiesExclude !== undefined) {
+            sessionOptions.fetchBodiesExclude = options.fetchBodiesExclude;
+        }
+        if (options.networkInclude !== undefined) {
+            sessionOptions.networkInclude = options.networkInclude;
+        }
+        if (options.networkExclude !== undefined) {
+            sessionOptions.networkExclude = options.networkExclude;
+        }
+        const setupResult = await TargetSetup.setup(url, targetUrl, options.port, options.reuseTab ?? false, sessionOptions);
+        const session = setupResult.session;
+        const target = setupResult.target;
+        context.session = session;
+        context.target = target;
+        console.error(`[PERF] CDP connection and target setup: ${Date.now() - setupStart}ms`);
+        // Phase 4: Start collectors and write metadata
+        await startCollectorsAndMetadata(session, collectors, context.startTime, options.port, target, context.launchedChrome?.pid);
+        // Log active collectors for forensic tracking and optimization prioritization
+        console.error(`[bdg] active collectors: ${collectors.join(', ')} (${url}, port ${options.port})`);
+        // Total session startup time
+        const totalStartupTime = Date.now() - context.startTime;
+        console.error(`[PERF] Total session startup: ${totalStartupTime}ms`);
+        // Print status
+        printCollectionStatus(collectors, options.timeout);
+        // Set timeout if explicitly provided
+        if (options.timeout) {
+            setTimeout(() => {
+                console.error(`\nTimeout reached (${options.timeout}s)`);
+                void context.stop();
+            }, options.timeout * 1000);
+        }
+        // Phase 5: Start preview writer
+        startPreviewWriter(context, options.compact ?? false);
+        // Optional: Log memory usage periodically (every 30s)
+        const memoryLogInterval = setInterval(() => {
+            const usage = process.memoryUsage();
+            const heapUsedMB = (usage.heapUsed / 1024 / 1024).toFixed(2);
+            const heapTotalMB = (usage.heapTotal / 1024 / 1024).toFixed(2);
+            const rssMB = (usage.rss / 1024 / 1024).toFixed(2);
+            console.error(`[PERF] Memory: Heap ${heapUsedMB}/${heapTotalMB} MB, RSS ${rssMB} MB`);
+        }, 30000);
+        // Store interval in context for cleanup
+        const originalCleanup = context.cleanup.bind(context);
+        context.cleanup = async () => {
+            clearInterval(memoryLogInterval);
+            await originalCleanup();
+        };
+        // Phase 6: Run session loop
+        await SessionLoop.run(session, target);
+    }
+    catch (error) {
+        // Show diagnostic information for Chrome launch failures
+        if (error instanceof ChromeLaunchError) {
+            reportLauncherFailure(error);
+        }
+        const errorOutput = OutputBuilder.buildError(error, context.startTime, context.target ?? undefined);
+        console.log(JSON.stringify(errorOutput, null, 2));
+        // Cleanup on error
+        await context.cleanup();
+        // Use semantic exit codes based on error type
+        const exitCode = getExitCodeForError(error);
+        process.exit(exitCode);
+    }
+}
 //# sourceMappingURL=sessionController.js.map

package/dist/cli/handlers/sessionController.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionController.js","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEnE,wCAAwC;QACxC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAElC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;YAC1F,OAAO,CAAC,CAAC;QACX,CAAC;QAED,uCAAuC;QACvC,OAAO,CAAC,KAAK,CAAC,gCAAgC,SAAS,MAAM,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,kDAAkD;YAClD,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAExC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAEpD,wCAAwC;YACxC,cAAc,EAAE,CAAC;YAEjB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,yCAAyC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8CAA8C,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}
+{"version":3,"file":"sessionController.js","sourceRoot":"","sources":["../../../src/cli/handlers/sessionController.ts"],"names":[],"mappings":"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"}

package/dist/cli/registry.d.ts

@@ -4,8 +4,8 @@ import type { Command } from 'commander';
  */
 export type CommandRegistrar = (program: Command) => void;
 /**
- * Registry of all CLI commands with grouping
- * Order matters: groups organize commands in help output
+ * Registry of all CLI commands
+ * Order matters: start commands first (includes default), then others
  */
 export declare const commandRegistry: CommandRegistrar[];
 //# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAW1D;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,EA2B7C,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAQ7C,CAAC"}