browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/cli/formatters/detailsFormatter.d.ts

@@ -0,0 +1,10 @@
+import type { NetworkRequest, ConsoleMessage } from '../../types.js';
+/**
+ * Format network request details for human-readable output
+ */
+export declare function formatNetworkDetails(request: NetworkRequest): string;
+/**
+ * Format console message details for human-readable output
+ */
+export declare function formatConsoleDetails(message: ConsoleMessage): string;
+//# sourceMappingURL=detailsFormatter.d.ts.map

package/dist/cli/formatters/detailsFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailsFormatter.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/detailsFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA4CpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmBpE"}

package/dist/cli/formatters/detailsFormatter.js

@@ -0,0 +1,63 @@
+/**
+ * Format network request details for human-readable output
+ */
+export function formatNetworkDetails(request) {
+    const lines = [];
+    lines.push('Network Request Details');
+    lines.push('━'.repeat(70));
+    lines.push(`Request ID:  ${request.requestId}`);
+    lines.push(`URL:         ${request.url}`);
+    lines.push(`Method:      ${request.method}`);
+    lines.push(`Status:      ${request.status ?? 'pending'}`);
+    lines.push(`MIME Type:   ${request.mimeType ?? 'N/A'}`);
+    lines.push('');
+    if (request.requestHeaders) {
+        lines.push('Request Headers:');
+        lines.push('━'.repeat(70));
+        Object.entries(request.requestHeaders).forEach(([key, value]) => {
+            lines.push(`  ${key}: ${value}`);
+        });
+        lines.push('');
+    }
+    if (request.requestBody) {
+        lines.push('Request Body:');
+        lines.push('━'.repeat(70));
+        lines.push(request.requestBody);
+        lines.push('');
+    }
+    if (request.responseHeaders) {
+        lines.push('Response Headers:');
+        lines.push('━'.repeat(70));
+        Object.entries(request.responseHeaders).forEach(([key, value]) => {
+            lines.push(`  ${key}: ${value}`);
+        });
+        lines.push('');
+    }
+    if (request.responseBody) {
+        lines.push('Response Body:');
+        lines.push('━'.repeat(70));
+        lines.push(request.responseBody);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format console message details for human-readable output
+ */
+export function formatConsoleDetails(message) {
+    const lines = [];
+    lines.push('Console Message Details');
+    lines.push('━'.repeat(70));
+    lines.push(`Type:       ${message.type}`);
+    lines.push(`Timestamp:  ${new Date(message.timestamp).toISOString()}`);
+    lines.push(`Text:       ${message.text}`);
+    lines.push('');
+    if (message.args && message.args.length > 0) {
+        lines.push('Arguments:');
+        lines.push('━'.repeat(70));
+        message.args.forEach((arg, idx) => {
+            lines.push(`  [${idx}]: ${JSON.stringify(arg, null, 2)}`);
+        });
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=detailsFormatter.js.map

package/dist/cli/formatters/detailsFormatter.js.map

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

package/dist/cli/formatters/previewFormatter.d.ts

@@ -0,0 +1,27 @@
+import type { BdgOutput } from '../../types.js';
+/**
+ * Flags that shape how preview output is rendered for `bdg peek`.
+ */
+export interface PreviewOptions {
+    /** Emit raw JSON instead of formatted text. */
+    json?: boolean;
+    /** Limit output to network requests (ignores console data). */
+    network?: boolean;
+    /** Limit output to console messages (ignores network data). */
+    console?: boolean;
+    /** Number of recent entries to include (parsed as integer). */
+    last: string;
+    /** Use the expanded, human-friendly layout. */
+    verbose?: boolean;
+    /** Stream updates until interrupted (tail-like behaviour). */
+    follow?: boolean;
+}
+/**
+ * Format preview output (peek command)
+ */
+export declare function formatPreview(output: BdgOutput, options: PreviewOptions): string;
+/**
+ * Format "no preview data" message
+ */
+export declare function formatNoPreviewDataMessage(): string;
+//# sourceMappingURL=previewFormatter.d.ts.map

package/dist/cli/formatters/previewFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewFormatter.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/previewFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAMhF;AAgKD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD"}

package/dist/cli/formatters/previewFormatter.js

@@ -0,0 +1,160 @@
+import { truncateUrl, truncateText } from '../../utils/url.js';
+/**
+ * Format preview output (peek command)
+ */
+export function formatPreview(output, options) {
+    if (options.json) {
+        return formatPreviewAsJson(output, options);
+    }
+    return formatPreviewHumanReadable(output, options);
+}
+/**
+ * Format preview as JSON
+ *
+ * Returns the output wrapped in a preview object to maintain the
+ * IPC response structure (.preview.data path for JSON consumers).
+ */
+function formatPreviewAsJson(output, options) {
+    const jsonOutput = {
+        ...output,
+    };
+    // Apply filters
+    if (options.network) {
+        delete jsonOutput.data.console;
+    }
+    if (options.console) {
+        delete jsonOutput.data.network;
+    }
+    // Apply --last limit
+    const lastCount = parseInt(options.last);
+    if (jsonOutput.data.network && jsonOutput.data.network.length > lastCount) {
+        jsonOutput.data.network = jsonOutput.data.network.slice(-lastCount);
+    }
+    if (jsonOutput.data.console && jsonOutput.data.console.length > lastCount) {
+        jsonOutput.data.console = jsonOutput.data.console.slice(-lastCount);
+    }
+    // Wrap in preview object to maintain .preview.data path for JSON consumers
+    return JSON.stringify({ preview: jsonOutput }, null, 2);
+}
+/**
+ * Format preview as human-readable output
+ */
+function formatPreviewHumanReadable(output, options) {
+    // Use verbose format if requested, otherwise use compact
+    if (options.verbose) {
+        return formatPreviewVerbose(output, options);
+    }
+    return formatPreviewCompact(output, options);
+}
+/**
+ * Format preview in compact format (default)
+ * Token-efficient output optimized for AI agents
+ */
+function formatPreviewCompact(output, options) {
+    const lines = [];
+    // Simple header (no Unicode box drawing)
+    lines.push(`PREVIEW | Duration: ${Math.floor(output.duration / 1000)}s | Updated: ${output.timestamp}`);
+    lines.push('');
+    const lastCount = parseInt(options.last);
+    // Show network requests (compact)
+    if (!options.console && output.data.network) {
+        const requests = output.data.network.slice(-lastCount);
+        lines.push(`NETWORK (${requests.length}/${output.data.network.length}):`);
+        if (requests.length === 0) {
+            lines.push('  (none)');
+        }
+        else {
+            requests.forEach((req) => {
+                const status = req.status ?? 'pending';
+                const url = truncateUrl(req.url, 50);
+                lines.push(`  ${status} ${req.method} ${url} [${req.requestId}]`);
+            });
+        }
+        lines.push('');
+    }
+    // Show console messages (compact)
+    if (!options.network && output.data.console) {
+        const messages = output.data.console.slice(-lastCount);
+        lines.push(`CONSOLE (${messages.length}/${output.data.console.length}):`);
+        if (messages.length === 0) {
+            lines.push('  (none)');
+        }
+        else {
+            messages.forEach((msg) => {
+                const prefix = msg.type.toUpperCase().padEnd(5);
+                const text = truncateText(msg.text, 2);
+                lines.push(`  ${prefix} ${text}`);
+            });
+        }
+        lines.push('');
+    }
+    // Minimal suggestions
+    lines.push('Tip: bdg stop | bdg peek --last 50 | bdg peek --verbose');
+    return lines.join('\n');
+}
+/**
+ * Format preview in verbose format (opt-in with --verbose)
+ * Original human-friendly output with Unicode formatting
+ */
+function formatPreviewVerbose(output, options) {
+    const lines = [];
+    lines.push('Live Preview (Partial Data)');
+    lines.push('━'.repeat(50));
+    lines.push(`Duration:         ${Math.floor(output.duration / 1000)}s`);
+    lines.push(`Last updated:     ${output.timestamp}`);
+    lines.push('');
+    const lastCount = parseInt(options.last);
+    // Show network requests
+    if (!options.console && output.data.network) {
+        const requests = output.data.network.slice(-lastCount);
+        lines.push(`Network Requests (last ${requests.length} of ${output.data.network.length})`);
+        lines.push('━'.repeat(50));
+        if (requests.length === 0) {
+            lines.push('No network requests yet');
+        }
+        else {
+            requests.forEach((req) => {
+                const statusColor = req.status && req.status >= 400 ? 'ERR' : 'OK';
+                const status = req.status ?? 'pending';
+                lines.push(`${statusColor} ${status} ${req.method} ${req.url}`);
+                if (req.mimeType) {
+                    lines.push(`  Type: ${req.mimeType}`);
+                }
+                lines.push(`  ID: ${req.requestId} (use 'bdg details network ${req.requestId}' for full details)`);
+            });
+        }
+        lines.push('');
+    }
+    // Show console messages
+    if (!options.network && output.data.console) {
+        const messages = output.data.console.slice(-lastCount);
+        lines.push(`Console Messages (last ${messages.length} of ${output.data.console.length})`);
+        lines.push('━'.repeat(50));
+        if (messages.length === 0) {
+            lines.push('No console messages yet');
+        }
+        else {
+            messages.forEach((msg) => {
+                const icon = msg.type === 'error' ? 'ERR' : msg.type === 'warning' ? 'WARN' : 'INFO';
+                lines.push(`${icon} [${msg.type}] ${msg.text}`);
+            });
+        }
+        lines.push('');
+    }
+    lines.push('Commands:');
+    lines.push('  Stop session:    bdg stop');
+    lines.push('  Full preview:    bdg peek --last 50');
+    lines.push('  Watch live:      bdg peek --follow');
+    return lines.join('\n');
+}
+/**
+ * Format "no preview data" message
+ */
+export function formatNoPreviewDataMessage() {
+    return `Error: No active session found
+No preview data available
+
+Start a session with: bdg <url>
+Check session status: bdg status`;
+}
+//# sourceMappingURL=previewFormatter.js.map

package/dist/cli/formatters/previewFormatter.js.map

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

package/dist/cli/formatters/statusFormatter.d.ts

@@ -0,0 +1,34 @@
+import type { SessionMetadata } from '../../session/metadata.js';
+export interface StatusData {
+    version: string;
+    active: boolean;
+    bdgPid?: number;
+    chromePid?: number | undefined;
+    chromeAlive?: boolean;
+    startTime?: number;
+    duration?: number;
+    durationFormatted?: string;
+    port?: number;
+    targetId?: string | undefined;
+    webSocketDebuggerUrl?: string | undefined;
+    collectors?: string[];
+    stale?: boolean;
+    stalePid?: number;
+    warning?: string;
+}
+/**
+ * Format session status for human-readable output
+ * @param metadata - Session metadata
+ * @param pid - BDG process ID
+ * @param verbose - Show detailed Chrome diagnostics
+ */
+export declare function formatSessionStatus(metadata: SessionMetadata, pid: number, verbose?: boolean): string;
+/**
+ * Convert status data to JSON format
+ */
+export declare function formatStatusAsJson(metadata: SessionMetadata | null, pid: number | null): StatusData;
+/**
+ * Format "no session" message
+ */
+export declare function formatNoSessionMessage(): string;
+//# sourceMappingURL=statusFormatter.d.ts.map

package/dist/cli/formatters/statusFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusFormatter.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/statusFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,GACd,MAAM,CAuDR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAChC,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,UAAU,CA8CZ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAM/C"}

package/dist/cli/formatters/statusFormatter.js

@@ -0,0 +1,108 @@
+import { isProcessAlive } from '../../session/process.js';
+import { getChromeDiagnostics, formatDiagnosticsForStatus } from '../../utils/chromeDiagnostics.js';
+import { VERSION } from '../../utils/version.js';
+/**
+ * Format session status for human-readable output
+ * @param metadata - Session metadata
+ * @param pid - BDG process ID
+ * @param verbose - Show detailed Chrome diagnostics
+ */
+export function formatSessionStatus(metadata, pid, verbose = false) {
+    // Calculate duration
+    const now = Date.now();
+    const durationMs = now - metadata.startTime;
+    const durationSec = Math.floor(durationMs / 1000);
+    const minutes = Math.floor(durationSec / 60);
+    const seconds = durationSec % 60;
+    const durationFormatted = minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+    // Check if Chrome is alive
+    const chromeAlive = metadata.chromePid ? isProcessAlive(metadata.chromePid) : false;
+    const lines = [];
+    lines.push('Session Status');
+    lines.push('━'.repeat(50));
+    lines.push(`Status:           ACTIVE`);
+    lines.push(`BDG PID:          ${pid}`);
+    if (metadata.chromePid) {
+        lines.push(`Chrome PID:       ${metadata.chromePid} ${chromeAlive ? '(running)' : '(not running)'}`);
+    }
+    lines.push(`Duration:         ${durationFormatted}`);
+    lines.push(`Port:             ${metadata.port}`);
+    lines.push('');
+    lines.push('Collectors');
+    lines.push('━'.repeat(50));
+    // Use activeCollectors from metadata, fallback to all collectors for backward compatibility
+    const activeCollectors = metadata.activeCollectors ?? ['network', 'console', 'dom'];
+    lines.push(`Network:          ${activeCollectors.includes('network') ? 'Active' : 'Inactive'}`);
+    lines.push(`Console:          ${activeCollectors.includes('console') ? 'Active' : 'Inactive'}`);
+    lines.push(`DOM:              ${activeCollectors.includes('dom') ? 'Active' : 'Inactive'}`);
+    // Add verbose Chrome diagnostics if requested
+    if (verbose) {
+        lines.push('');
+        lines.push('Chrome Diagnostics');
+        lines.push('━'.repeat(50));
+        // Get diagnostics using shared utility (cached to avoid repeated scans)
+        const diagnostics = getChromeDiagnostics();
+        const diagnosticLines = formatDiagnosticsForStatus(diagnostics);
+        lines.push(...diagnosticLines);
+    }
+    lines.push('');
+    lines.push('Commands:');
+    lines.push('  Stop session:    bdg stop');
+    lines.push('  Query browser:   bdg query <script>');
+    return lines.join('\n');
+}
+/**
+ * Convert status data to JSON format
+ */
+export function formatStatusAsJson(metadata, pid) {
+    if (!pid) {
+        return { version: VERSION, active: false };
+    }
+    const isAlive = isProcessAlive(pid);
+    if (!isAlive) {
+        return { version: VERSION, active: false, stale: true, stalePid: pid };
+    }
+    if (!metadata) {
+        return {
+            version: VERSION,
+            active: true,
+            bdgPid: pid,
+            warning: 'Metadata not found (session may be from older version)',
+        };
+    }
+    // Calculate duration
+    const now = Date.now();
+    const durationMs = now - metadata.startTime;
+    const durationSec = Math.floor(durationMs / 1000);
+    const minutes = Math.floor(durationSec / 60);
+    const seconds = durationSec % 60;
+    const durationFormatted = minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+    // Check if Chrome is alive
+    const chromeAlive = metadata.chromePid ? isProcessAlive(metadata.chromePid) : false;
+    return {
+        version: VERSION,
+        active: true,
+        bdgPid: pid,
+        chromePid: metadata.chromePid,
+        chromeAlive,
+        startTime: metadata.startTime,
+        duration: durationMs,
+        durationFormatted,
+        port: metadata.port,
+        targetId: metadata.targetId,
+        webSocketDebuggerUrl: metadata.webSocketDebuggerUrl,
+        // Use activeCollectors from metadata, fallback to all collectors for backward compatibility
+        collectors: metadata.activeCollectors ?? ['network', 'console', 'dom'],
+    };
+}
+/**
+ * Format "no session" message
+ */
+export function formatNoSessionMessage() {
+    return `No active session found
+
+Suggestions:
+  Start a new session:     bdg <url>
+  List Chrome tabs:        bdg tabs`;
+}
+//# sourceMappingURL=statusFormatter.js.map

package/dist/cli/formatters/statusFormatter.js.map

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

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

@@ -0,0 +1,24 @@
+import { type LaunchOptions } from '../../connection/launcher.js';
+import type { LaunchedChrome } from '../../types.js';
+/**
+ * Handles Chrome browser launch and connection
+ */
+export declare class ChromeBootstrap {
+    /**
+     * Launch Chrome if not already running, or connect to existing instance.
+     *
+     * Delegates to chrome-launcher which handles:
+     * - Port availability checking
+     * - Strict mode enforcement (via portStrictMode option)
+     * - Chrome readiness polling
+     * - Reusing existing Chrome instances when port is occupied
+     *
+     * @param port - Chrome debugging port
+     * @param targetUrl - Initial URL to navigate to
+     * @param launchOptions - Chrome launcher options (userDataDir, logLevel, etc.)
+     * @returns LaunchedChrome instance if Chrome was launched, null if already running
+     * @throws Error if chrome-launcher fails to launch or connect
+     */
+    static launch(port: number, targetUrl: string, launchOptions?: Partial<LaunchOptions>): Promise<LaunchedChrome | null>;
+}
+//# sourceMappingURL=ChromeBootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeBootstrap.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ChromeBootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;WACU,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACrC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CA8BlC"}

package/dist/cli/handlers/ChromeBootstrap.js

@@ -0,0 +1,50 @@
+import { launchChrome } from '../../connection/launcher.js';
+/**
+ * Handles Chrome browser launch and connection
+ */
+export class ChromeBootstrap {
+    /**
+     * Launch Chrome if not already running, or connect to existing instance.
+     *
+     * Delegates to chrome-launcher which handles:
+     * - Port availability checking
+     * - Strict mode enforcement (via portStrictMode option)
+     * - Chrome readiness polling
+     * - Reusing existing Chrome instances when port is occupied
+     *
+     * @param port - Chrome debugging port
+     * @param targetUrl - Initial URL to navigate to
+     * @param launchOptions - Chrome launcher options (userDataDir, logLevel, etc.)
+     * @returns LaunchedChrome instance if Chrome was launched, null if already running
+     * @throws Error if chrome-launcher fails to launch or connect
+     */
+    static async launch(port, targetUrl, launchOptions) {
+        // Attempt launch - chrome-launcher handles everything:
+        // - Port availability checking
+        // - Launching new Chrome or reusing existing instance
+        // - Strict mode enforcement (throws if portStrictMode=true and can't connect)
+        // - Chrome readiness polling with retries
+        // Default to headless in CI environments (no display available)
+        // User can override via launchOptions.headless if needed
+        const isCI = process.env['CI'] === 'true' || process.env['CI'] === '1';
+        const headless = launchOptions?.headless ?? (isCI ? true : false);
+        const chrome = await launchChrome({
+            port,
+            headless,
+            url: targetUrl,
+            ...launchOptions,
+        });
+        // chrome-launcher returns a valid LaunchedChrome when successful
+        // PID will be 0 or undefined if reusing an existing Chrome instance
+        const isNewLaunch = chrome.pid && chrome.pid > 0;
+        if (isNewLaunch) {
+            console.error(`Chrome launched (PID: ${chrome.pid})`);
+            return chrome; // Return handle so we can kill it on cleanup
+        }
+        else {
+            console.error(`Chrome already running on port ${port}`);
+            return null; // Don't return handle - we don't own this Chrome instance
+        }
+    }
+}
+//# sourceMappingURL=ChromeBootstrap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeBootstrap.js","sourceRoot":"","sources":["../../../src/cli/handlers/ChromeBootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,0BAA0B,CAAC;AAG5E;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAY,EACZ,SAAiB,EACjB,aAAsC;QAEtC,uDAAuD;QACvD,+BAA+B;QAC/B,sDAAsD;QACtD,8EAA8E;QAC9E,0CAA0C;QAE1C,gEAAgE;QAChE,yDAAyD;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;QACvE,MAAM,QAAQ,GAAG,aAAa,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,IAAI;YACJ,QAAQ;YACR,GAAG,EAAE,SAAS;YACd,GAAG,aAAa;SACjB,CAAC,CAAC;QAEH,iEAAiE;QACjE,oEAAoE;QACpE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACjD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,CAAC,6CAA6C;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,CAAC,0DAA0D;QACzE,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,60 @@
+/**
+ * Standard options supported by CommandRunner.
+ * All commands that use CommandRunner must extend this interface.
+ */
+export interface BaseCommandOptions {
+    /** Output as JSON instead of human-readable format */
+    json?: boolean;
+}
+/**
+ * Result from a command handler.
+ * Handler functions should return this structure to indicate success/failure.
+ */
+export interface CommandResult<T = unknown> {
+    /** Whether the command succeeded */
+    success: boolean;
+    /** Data to output (for successful commands) */
+    data?: T;
+    /** Error message (for failed commands) */
+    error?: string;
+    /** Optional exit code override (defaults: SUCCESS=0, error codes from EXIT_CODES) */
+    exitCode?: number;
+}
+/**
+ * Handler function type.
+ * Command logic should be implemented as a function matching this signature.
+ */
+export type CommandHandler<TOptions extends BaseCommandOptions, TResult = unknown> = (options: TOptions) => Promise<CommandResult<TResult>>;
+/**
+ * Formatter function type for human-readable output.
+ * Receives the command result data and outputs to console.
+ */
+export type CommandFormatter<TResult = unknown> = (data: TResult) => void;
+/**
+ * Run a command with consistent error handling, output formatting, and exit codes.
+ * Eliminates boilerplate try-catch and JSON output logic from command handlers.
+ *
+ * This helper:
+ * - Wraps command logic in try-catch
+ * - Handles IPC connection errors (ENOENT, ECONNREFUSED)
+ * - Formats output as JSON or human-readable based on --json flag
+ * - Calls process.exit() with appropriate exit code
+ *
+ * @param handler - Command logic that returns CommandResult or throws
+ * @param options - Command options (must include json flag)
+ * @param formatter - Optional human-readable formatter (if not provided, outputs raw JSON)
+ *
+ * @example
+ * ```typescript
+ * await runCommand(
+ *   async (opts) => {
+ *     const data = await fetchData(opts.url);
+ *     return { success: true, data };
+ *   },
+ *   options,
+ *   formatData
+ * );
+ * ```
+ */
+export declare function runCommand<TOptions extends BaseCommandOptions, TResult = unknown>(handler: CommandHandler<TOptions, TResult>, options: TOptions, formatter?: CommandFormatter<TResult>): Promise<void>;
+//# sourceMappingURL=CommandRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommandRunner.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/CommandRunner.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,IAAI,CACnF,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,EACrF,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC1C,OAAO,EAAE,QAAQ,EACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAyDf"}