browser-debugger-cli 0.1.0-alpha.1 → 0.2.0

package/dist/ui/messages/session.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Session-related user-facing messages.
+ *
+ * Centralized location for all session UI text including landing pages,
+ * status displays, and session management messages.
+ */
+/**
+ * Options for the landing page display.
+ */
+export interface LandingPageOptions {
+    /** Target URL being monitored */
+    url: string;
+}
+/**
+ * Generate the landing page display for session start.
+ *
+ * Shows a clean, organized overview of available commands grouped by domain.
+ *
+ * @param options - Landing page options
+ * @returns Formatted landing page string
+ *
+ * @example
+ * ```typescript
+ * const message = landingPage({
+ *   url: 'http://localhost:3000'
+ * });
+ * console.log(message);
+ * ```
+ */
+export declare function landingPage(options: LandingPageOptions): string;
+/**
+ * Generate "session stopped" success message.
+ *
+ * @param outputPath - Path to session output file
+ * @returns Formatted success message
+ */
+export declare function sessionStopped(outputPath: string): string;
+/**
+ * Standard messages for stop command operations.
+ */
+export declare const STOP_MESSAGES: {
+    readonly SUCCESS: "Session stopped successfully";
+    readonly NO_SESSION: "No active session found";
+    readonly FAILED: "Failed to stop session";
+    readonly DAEMON_NOT_RUNNING: "Daemon not running";
+};
+/**
+ * Generate stop session failed error message.
+ *
+ * @param reason - Reason for failure
+ * @returns Formatted error message
+ */
+export declare function stopFailedError(reason: string): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/ui/messages/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA+B/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAMD;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/ui/messages/session.js

@@ -0,0 +1,77 @@
+/**
+ * Session-related user-facing messages.
+ *
+ * Centralized location for all session UI text including landing pages,
+ * status displays, and session management messages.
+ */
+import { section } from '../../ui/formatting.js';
+/**
+ * Generate the landing page display for session start.
+ *
+ * Shows a clean, organized overview of available commands grouped by domain.
+ *
+ * @param options - Landing page options
+ * @returns Formatted landing page string
+ *
+ * @example
+ * ```typescript
+ * const message = landingPage({
+ *   url: 'http://localhost:3000'
+ * });
+ * console.log(message);
+ * ```
+ */
+export function landingPage(options) {
+    const { url } = options;
+    const lines = [];
+    lines.push('');
+    lines.push('▲  Session Started');
+    lines.push('');
+    lines.push(`Target: ${url}`);
+    lines.push('');
+    lines.push(section('Explore by domain:', [
+        'bdg dom         DOM inspection & manipulation',
+        'bdg network     Network requests & cookies',
+        'bdg console     Console logs & messages',
+    ]));
+    lines.push('');
+    lines.push(section('Session:', [
+        'bdg status      Check session state',
+        'bdg stop        End session & save',
+    ]));
+    lines.push('');
+    lines.push(section('Advanced:', ['bdg cdp <method> [params]    Direct CDP access (300+ methods)']));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate "session stopped" success message.
+ *
+ * @param outputPath - Path to session output file
+ * @returns Formatted success message
+ */
+export function sessionStopped(outputPath) {
+    return `Session stopped. Output saved to: ${outputPath}`;
+}
+// ============================================================================
+// Stop Command Messages
+// ============================================================================
+/**
+ * Standard messages for stop command operations.
+ */
+export const STOP_MESSAGES = {
+    SUCCESS: 'Session stopped successfully',
+    NO_SESSION: 'No active session found',
+    FAILED: 'Failed to stop session',
+    DAEMON_NOT_RUNNING: 'Daemon not running',
+};
+/**
+ * Generate stop session failed error message.
+ *
+ * @param reason - Reason for failure
+ * @returns Formatted error message
+ */
+export function stopFailedError(reason) {
+    return `Stop session failed: ${reason}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/ui/messages/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAU7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,oBAAoB,EAAE;QAC5B,+CAA+C;QAC/C,4CAA4C;QAC5C,yCAAyC;KAC1C,CAAC,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,UAAU,EAAE;QAClB,qCAAqC;QACrC,oCAAoC;KACrC,CAAC,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,WAAW,EAAE,CAAC,+DAA+D,CAAC,CAAC,CACxF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,qCAAqC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,8BAA8B;IACvC,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,wBAAwB;IAChC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,wBAAwB,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/ui/messages/validation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validation error messages
+ *
+ * User-facing messages for input validation failures across commands.
+ */
+/**
+ * Generate invalid integer error message.
+ *
+ * @param fieldName - Name of the field being validated
+ * @param value - The invalid value provided
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * throw new Error(invalidIntegerError('timeout', 'abc'));
+ * // "Invalid timeout: "abc" is not a valid integer"
+ * ```
+ */
+export declare function invalidIntegerError(fieldName: string, value: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/ui/messages/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/ui/messages/validation.js

@@ -0,0 +1,22 @@
+/**
+ * Validation error messages
+ *
+ * User-facing messages for input validation failures across commands.
+ */
+/**
+ * Generate invalid integer error message.
+ *
+ * @param fieldName - Name of the field being validated
+ * @param value - The invalid value provided
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * throw new Error(invalidIntegerError('timeout', 'abc'));
+ * // "Invalid timeout: "abc" is not a valid integer"
+ * ```
+ */
+export function invalidIntegerError(fieldName, value) {
+    return `Invalid ${fieldName}: "${value}" is not a valid integer`;
+}
+//# sourceMappingURL=validation.js.map

package/dist/ui/messages/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/ui/messages/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAAa;IAClE,OAAO,WAAW,SAAS,MAAM,KAAK,0BAA0B,CAAC;AACnE,CAAC"}

package/dist/utils/__tests__/filters.unit.test.js

@@ -1,6 +1,6 @@
 import * as assert from 'node:assert/strict';
 import { describe, it } from 'node:test';
-import { matchesWildcard, shouldFetchBody, shouldExcludeUrl, shouldExcludeDomain, shouldExcludeConsoleMessage, DEFAULT_SKIP_BODY_PATTERNS, DEFAULT_EXCLUDED_DOMAINS, DEFAULT_EXCLUDED_CONSOLE_PATTERNS, } from '../filters.js';
+import { matchesWildcard, shouldFetchBody, shouldExcludeUrl, shouldExcludeDomain, shouldExcludeConsoleMessage, DEFAULT_SKIP_BODY_PATTERNS, DEFAULT_EXCLUDED_DOMAINS, DEFAULT_EXCLUDED_CONSOLE_PATTERNS, } from '../../utils/filters.js';
 void describe('filters - matchesWildcard', () => {
     void it('should match exact strings', () => {
         assert.equal(matchesWildcard('api.example.com', 'api.example.com'), true);

package/dist/utils/cdpHandlers.d.ts

@@ -3,7 +3,7 @@ import type { CDPConnection } from '../connection/cdp.js';
  * Registry for managing CDP event handlers with automatic cleanup.
  *
  * Provides a centralized way to register and clean up CDP event handlers,
- * eliminating the boilerplate code repeated across all collectors.
+ * eliminating the boilerplate code repeated across all telemetry modules.
  */
 export declare class CDPHandlerRegistry {
     private handlers;

package/dist/utils/cdpHandlers.js

@@ -2,7 +2,7 @@
  * Registry for managing CDP event handlers with automatic cleanup.
  *
  * Provides a centralized way to register and clean up CDP event handlers,
- * eliminating the boilerplate code repeated across all collectors.
+ * eliminating the boilerplate code repeated across all telemetry modules.
  */
 export class CDPHandlerRegistry {
     handlers = [];

package/dist/utils/chromeDiagnostics.d.ts

@@ -13,16 +13,4 @@ export interface ChromeDiagnostics {
  * @returns Chrome diagnostics information
  */
 export declare function getChromeDiagnostics(): ChromeDiagnostics;
-/**
- * Format diagnostics for error reporting when Chrome launch fails.
- * @param diagnostics - Chrome diagnostics information
- * @returns Formatted error message with troubleshooting steps
- */
-export declare function formatDiagnosticsForError(diagnostics: ChromeDiagnostics): string[];
-/**
- * Format diagnostics for verbose status output (bdg status --verbose).
- * @param diagnostics - Chrome diagnostics information
- * @returns Array of formatted status lines
- */
-export declare function formatDiagnosticsForStatus(diagnostics: ChromeDiagnostics): string[];
 //# sourceMappingURL=chromeDiagnostics.d.ts.map

package/dist/utils/chromeDiagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chromeDiagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/chromeDiagnostics.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CA0BxD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAwBlF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAmBnF"}
+{"version":3,"file":"chromeDiagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/chromeDiagnostics.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CA0BxD"}

package/dist/utils/chromeDiagnostics.js

@@ -34,55 +34,4 @@ export function getChromeDiagnostics() {
     };
     return cachedDiagnostics;
 }
-/**
- * Format diagnostics for error reporting when Chrome launch fails.
- * @param diagnostics - Chrome diagnostics information
- * @returns Formatted error message with troubleshooting steps
- */
-export function formatDiagnosticsForError(diagnostics) {
-    const lines = [];
-    if (diagnostics.installationCount === 0) {
-        lines.push('Error: No Chrome installations detected\n');
-        lines.push('Install Chrome from:');
-        lines.push('   https://www.google.com/chrome/\n');
-    }
-    else {
-        lines.push(`Found ${diagnostics.installationCount} Chrome installation${diagnostics.installationCount > 1 ? 's' : ''}:\n`);
-        diagnostics.installations.forEach((path, index) => {
-            lines.push(`  ${index + 1}. ${path}`);
-        });
-        lines.push('');
-        if (diagnostics.defaultPath) {
-            lines.push(`Default binary: ${diagnostics.defaultPath}\n`);
-        }
-        else {
-            lines.push('Default binary: Could not determine\n');
-        }
-    }
-    return lines;
-}
-/**
- * Format diagnostics for verbose status output (bdg status --verbose).
- * @param diagnostics - Chrome diagnostics information
- * @returns Array of formatted status lines
- */
-export function formatDiagnosticsForStatus(diagnostics) {
-    const lines = [];
-    if (diagnostics.defaultPath) {
-        lines.push(`Binary:           ${diagnostics.defaultPath}`);
-    }
-    else {
-        lines.push('Binary:           Could not determine');
-    }
-    lines.push(`Installations:    ${diagnostics.installationCount} found`);
-    if (diagnostics.installationCount > 0 && diagnostics.installationCount <= 3) {
-        diagnostics.installations.forEach((path, index) => {
-            lines.push(`  ${index + 1}. ${path}`);
-        });
-    }
-    else if (diagnostics.installationCount > 3) {
-        lines.push(`  (Use 'bdg cleanup --aggressive' to see all)`);
-    }
-    return lines;
-}
 //# sourceMappingURL=chromeDiagnostics.js.map

package/dist/utils/chromeDiagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"chromeDiagnostics.js","sourceRoot":"","sources":["../../src/utils/chromeDiagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chromeDiagnostics.js","sourceRoot":"","sources":["../../src/utils/chromeDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,iBAAiB,CAAC;AAWlD;;GAEG;AACH,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,WAAW,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;IAED,IAAI,aAAa,GAAa,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IAED,iBAAiB,GAAG;QAClB,WAAW;QACX,aAAa;QACb,iBAAiB,EAAE,aAAa,CAAC,MAAM;KACxC,CAAC;IAEF,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/utils/http.d.ts

@@ -1,4 +1,4 @@
-import type { CDPTarget } from '../types.js';
+import type { CDPTarget } from '../types';
 /**
  * Fetch CDP targets from Chrome's HTTP API.
  *

package/dist/utils/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe,gBAAgB;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,cAAc,IAAI,IAAI,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAe,gBAAgB;IAE/B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGlE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe,gBAAgB;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,cAAc,IAAI,IAAI,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAe,gBAAgB;IAE/B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/utils/logger.d.ts

@@ -1,42 +1,98 @@
 /**
- * Logging utilities for consistent formatted output.
+ * Logging utilities for consistent formatted output with log level support.
  *
- * WHY: Centralizes log formatting to avoid repetitive `console.error('[component] message')` patterns.
+ * WHY: Centralizes log formatting and enables debug mode for verbose logging.
+ * By default, only 'info' level logs are shown. Set BDG_DEBUG=1 or use --debug
+ * flag to enable verbose 'debug' level logs.
  */
+/**
+ * Enable debug logging globally.
+ *
+ * This is typically called during CLI initialization when --debug flag is detected.
+ * Debug mode shows all logs including verbose internal state changes and tracing.
+ */
+export declare function enableDebugLogging(): void;
+/**
+ * Check if debug logging is currently enabled.
+ *
+ * @returns True if debug mode is active
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Log level determines visibility of log messages.
+ *
+ * - 'info': Always shown (important user-facing messages, errors, key milestones)
+ * - 'debug': Only shown in debug mode (verbose internal state, IPC traces, progress updates)
+ */
+export type LogLevel = 'info' | 'debug';
 /**
  * Log contexts for different components.
  * Used to prefix log messages with component name.
  */
 export type LogContext = 'bdg' | 'launcher' | 'daemon' | 'worker' | 'client' | 'cleanup' | 'session' | 'chrome' | 'cdp' | 'ipc';
 /**
- * Create a logger function for a specific context.
+ * Logger instance with support for different log levels.
+ */
+export interface Logger {
+    /**
+     * Log an info message (always shown).
+     * Use for important user-facing messages and key milestones.
+     */
+    info: (message: string) => void;
+    /**
+     * Log a debug message (only shown in debug mode).
+     * Use for verbose internal state, progress updates, and traces.
+     */
+    debug: (message: string) => void;
+    /**
+     * Log a message (defaults to info level).
+     * Provided for backward compatibility.
+     */
+    (message: string): void;
+}
+/**
+ * Create a logger instance for a specific context.
  *
- * WHY: Provides consistent log formatting with context prefix.
+ * WHY: Provides consistent log formatting with context prefix and level support.
+ * By default, ALL logs are hidden unless --debug flag or BDG_DEBUG=1 is set.
+ * This keeps normal output clean and only shows logs when debugging.
  *
  * @param context - Component context for log prefix
- * @returns Logger function that prefixes messages with context
+ * @returns Logger instance with info/debug methods
  *
  * @example
  * ```typescript
  * const log = createLogger('cleanup');
- * log('Removed stale daemon socket');
- * // Output: [cleanup] Removed stale daemon socket
+ *
+ * // Always shown (even without --debug)
+ * log.info('Cleaned up stale session files');
+ *
+ * // Only shown in debug mode (--debug or BDG_DEBUG=1)
+ * log.debug('Checking PID file at ~/.bdg/daemon.pid');
+ *
+ * // Backward compatible (treated as debug - only shown in debug mode)
+ * log('Daemon started successfully');
  * ```
  */
-export declare function createLogger(context: LogContext): (message: string) => void;
+export declare function createLogger(context: LogContext): Logger;
 /**
  * Log a message with a specific context (one-off usage).
  *
- * WHY: Convenient for single log statements without creating a logger function.
+ * WHY: Convenient for single log statements without creating a logger instance.
  *
  * @param context - Component context for log prefix
  * @param message - Log message
+ * @param level - Log level (defaults to 'debug' - only shown with --debug)
  *
  * @example
  * ```typescript
- * log('cleanup', 'Removed stale daemon socket');
- * // Output: [cleanup] Removed stale daemon socket
+ * // Always shown (even without --debug)
+ * log('cleanup', 'Removed stale daemon socket', 'info');
+ *
+ * // Only shown in debug mode (default behavior)
+ * log('cleanup', 'Found PID file');
+ * log('cleanup', 'Checking lock file', 'debug');
  * ```
  */
-export declare function log(context: LogContext, message: string): void;
+export declare function log(context: LogContext, message: string, level?: LogLevel): void;
 //# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,KAAK,GACL,KAAK,CAAC;AAEV;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAI3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAMD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,KAAK,GACL,KAAK,CAAC;AAMV;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjC;;;OAGG;IACH,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAaxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,QAAkB,GAAG,IAAI,CAKzF"}

package/dist/utils/logger.js

@@ -1,43 +1,93 @@
 /**
- * Logging utilities for consistent formatted output.
+ * Logging utilities for consistent formatted output with log level support.
  *
- * WHY: Centralizes log formatting to avoid repetitive `console.error('[component] message')` patterns.
+ * WHY: Centralizes log formatting and enables debug mode for verbose logging.
+ * By default, only 'info' level logs are shown. Set BDG_DEBUG=1 or use --debug
+ * flag to enable verbose 'debug' level logs.
  */
+// ============================================================================
+// Global Debug State
+// ============================================================================
+let debugEnabled = false;
 /**
- * Create a logger function for a specific context.
+ * Enable debug logging globally.
  *
- * WHY: Provides consistent log formatting with context prefix.
+ * This is typically called during CLI initialization when --debug flag is detected.
+ * Debug mode shows all logs including verbose internal state changes and tracing.
+ */
+export function enableDebugLogging() {
+    debugEnabled = true;
+}
+/**
+ * Check if debug logging is currently enabled.
+ *
+ * @returns True if debug mode is active
+ */
+export function isDebugEnabled() {
+    return debugEnabled || process.env['BDG_DEBUG'] === '1';
+}
+// ============================================================================
+// Logger Implementation
+// ============================================================================
+/**
+ * Create a logger instance for a specific context.
+ *
+ * WHY: Provides consistent log formatting with context prefix and level support.
+ * By default, ALL logs are hidden unless --debug flag or BDG_DEBUG=1 is set.
+ * This keeps normal output clean and only shows logs when debugging.
  *
  * @param context - Component context for log prefix
- * @returns Logger function that prefixes messages with context
+ * @returns Logger instance with info/debug methods
  *
  * @example
  * ```typescript
  * const log = createLogger('cleanup');
- * log('Removed stale daemon socket');
- * // Output: [cleanup] Removed stale daemon socket
+ *
+ * // Always shown (even without --debug)
+ * log.info('Cleaned up stale session files');
+ *
+ * // Only shown in debug mode (--debug or BDG_DEBUG=1)
+ * log.debug('Checking PID file at ~/.bdg/daemon.pid');
+ *
+ * // Backward compatible (treated as debug - only shown in debug mode)
+ * log('Daemon started successfully');
  * ```
  */
 export function createLogger(context) {
-    return (message) => {
+    const logMessage = (message, level = 'debug') => {
+        if (level === 'debug' && !isDebugEnabled()) {
+            return;
+        }
         console.error(`[${context}] ${message}`);
     };
+    const logger = ((message) => logMessage(message, 'debug'));
+    logger.info = (message) => logMessage(message, 'info');
+    logger.debug = (message) => logMessage(message, 'debug');
+    return logger;
 }
 /**
  * Log a message with a specific context (one-off usage).
  *
- * WHY: Convenient for single log statements without creating a logger function.
+ * WHY: Convenient for single log statements without creating a logger instance.
  *
  * @param context - Component context for log prefix
  * @param message - Log message
+ * @param level - Log level (defaults to 'debug' - only shown with --debug)
  *
  * @example
  * ```typescript
- * log('cleanup', 'Removed stale daemon socket');
- * // Output: [cleanup] Removed stale daemon socket
+ * // Always shown (even without --debug)
+ * log('cleanup', 'Removed stale daemon socket', 'info');
+ *
+ * // Only shown in debug mode (default behavior)
+ * log('cleanup', 'Found PID file');
+ * log('cleanup', 'Checking lock file', 'debug');
  * ```
  */
-export function log(context, message) {
+export function log(context, message, level = 'debug') {
+    if (level === 'debug' && !isDebugEnabled()) {
+        return;
+    }
     console.error(`[${context}] ${message}`);
 }
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,OAAO,CAAC,OAAe,EAAE,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAAG,CAAC,OAAmB,EAAE,OAAe;IACtD,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC;AAC1D,CAAC;AAyDD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,QAAkB,OAAO,EAAQ,EAAE;QACtE,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAW,CAAC;IAC7E,MAAM,CAAC,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,GAAG,CAAC,OAAmB,EAAE,OAAe,EAAE,QAAkB,OAAO;IACjF,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utils/pageReadiness.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Smart page readiness detection using self-tuning thresholds
+ *
+ * This module provides adaptive page load detection that works for any page type
+ * without configuration. It uses a three-phase approach:
+ * 1. Load event (baseline readiness)
+ * 2. Network stability (adapts to request patterns)
+ * 3. DOM stability (adapts to mutation rate)
+ */
+import type { CDPConnection } from '../connection/cdp.js';
+/**
+ * Options for page readiness detection
+ */
+export interface PageReadinessOptions {
+    /**
+     * Maximum wait time before proceeding anyway
+     * Default: 2000ms (2 seconds)
+     */
+    maxWaitMs?: number;
+    /**
+     * Wait for network and DOM stability after load event
+     * Default: false (load event is sufficient for most pages)
+     * Enable for SPAs with heavy post-load hydration
+     */
+    waitForStability?: boolean;
+}
+/**
+ * Wait for page to be ready using self-tuning detection
+ *
+ * Strategy:
+ * 1. Wait for load event (baseline)
+ * 2. Wait for network to stabilize (adaptive)
+ * 3. Wait for DOM to stabilize (adaptive)
+ *
+ * All thresholds adapt to observed page behavior.
+ * No framework detection, no configuration needed.
+ *
+ * @param cdp - CDP connection
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```typescript
+ * // Default: Self-tuning for any page
+ * await waitForPageReady(cdp);
+ *
+ * // Custom timeout for slow apps
+ * await waitForPageReady(cdp, { maxWaitMs: 60000 });
+ * ```
+ */
+export declare function waitForPageReady(cdp: CDPConnection, options?: PageReadinessOptions): Promise<void>;
+//# sourceMappingURL=pageReadiness.d.ts.map

package/dist/utils/pageReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageReadiness.d.ts","sourceRoot":"","sources":["../../src/utils/pageReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAwBf"}