browser-debugger-cli 0.1.0 → 0.2.0

package/dist/commands/shared/commonOptions.js

@@ -0,0 +1,64 @@
+import { Option } from 'commander';
+/**
+ * Shared --json flag for all commands that support JSON output.
+ * Standard option for machine-readable output.
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('status')
+ *   .addOption(jsonOption)
+ *   .action((options) => {
+ *     if (options.json) {
+ *       console.log(JSON.stringify(data));
+ *     }
+ *   });
+ * ```
+ */
+export const jsonOption = new Option('-j, --json', 'Output as JSON');
+/**
+ * Shared --last <n> option for pagination.
+ * Includes built-in validation for sensible limits.
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('console')
+ *   .addOption(lastOption)
+ *   .action((options) => {
+ *     const logs = allLogs.slice(-options.last);
+ *   });
+ * ```
+ */
+export const lastOption = new Option('--last <n>', 'Show last N items')
+    .default(0)
+    .argParser((val) => {
+    const n = parseInt(val, 10);
+    if (isNaN(n) || n < 0 || n > 10000) {
+        throw new Error('--last must be between 0 and 10000');
+    }
+    return n;
+});
+/**
+ * Create a --filter option with specified valid choices.
+ * Includes built-in validation using Commander's .choices() method.
+ *
+ * @param validTypes - Array of valid filter values
+ * @returns Commander Option instance
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('console')
+ *   .addOption(filterOption(['log', 'error', 'warning', 'info']))
+ *   .action((options) => {
+ *     if (options.filter) {
+ *       filtered = logs.filter(log => log.type === options.filter);
+ *     }
+ *   });
+ * ```
+ */
+export function filterOption(validTypes) {
+    return new Option('--filter <type>', `Filter by type (${validTypes.join(', ')})`).choices(validTypes);
+}
+//# sourceMappingURL=commonOptions.js.map

package/dist/commands/shared/commonOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonOptions.js","sourceRoot":"","sources":["../../../src/commands/shared/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC;KACpE,OAAO,CAAC,CAAC,CAAC;KACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,UAAoB;IAC/C,OAAO,IAAI,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CACvF,UAAU,CACX,CAAC;AACJ,CAAC"}

package/dist/commands/shared/daemonSessionController.d.ts

@@ -0,0 +1,23 @@
+import type { TelemetryType } from '../../types.js';
+/**
+ * Start a session via the daemon using IPC.
+ *
+ * This replaces the in-process sessionController.startSession() by:
+ * 1. Sending a start_session_request to the daemon
+ * 2. Waiting for the worker to launch and report readiness
+ * 3. Outputting metadata about the running session
+ * 4. Keeping the process alive while the session runs
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @param telemetry - Array of telemetry types to enable
+ */
+export declare function startSessionViaDaemon(url: string, options: {
+    port: number;
+    timeout: number | undefined;
+    userDataDir: string | undefined;
+    includeAll: boolean;
+    maxBodySize: number | undefined;
+    compact: boolean;
+}, telemetry: TelemetryType[]): Promise<void>;
+//# sourceMappingURL=daemonSessionController.d.ts.map

package/dist/commands/shared/daemonSessionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonSessionController.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/daemonSessionController.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAahD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,EACD,SAAS,EAAE,aAAa,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/commands/shared/daemonSessionController.js

@@ -0,0 +1,79 @@
+import { landingPage } from '../../commands/shared/landingPage.js';
+import { startSession as sendStartSessionRequest } from '../../ipc/client.js';
+import { IPCErrorCode } from '../../ipc/types.js';
+import { sessionAlreadyRunningError, daemonConnectionFailedError, invalidResponseError, genericError, } from '../../ui/messages/errors.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('bdg');
+/**
+ * Start a session via the daemon using IPC.
+ *
+ * This replaces the in-process sessionController.startSession() by:
+ * 1. Sending a start_session_request to the daemon
+ * 2. Waiting for the worker to launch and report readiness
+ * 3. Outputting metadata about the running session
+ * 4. Keeping the process alive while the session runs
+ *
+ * @param url - Target URL to navigate to
+ * @param options - Session configuration options
+ * @param telemetry - Array of telemetry types to enable
+ */
+export async function startSessionViaDaemon(url, options, telemetry) {
+    try {
+        log.debug('Connecting to daemon...');
+        // Send start_session_request to daemon
+        const requestOptions = {};
+        if (options.port !== undefined)
+            requestOptions.port = options.port;
+        if (options.timeout !== undefined)
+            requestOptions.timeout = options.timeout;
+        if (telemetry.length > 0)
+            requestOptions.telemetry = telemetry;
+        if (options.includeAll !== undefined)
+            requestOptions.includeAll = options.includeAll;
+        if (options.userDataDir !== undefined)
+            requestOptions.userDataDir = options.userDataDir;
+        if (options.maxBodySize !== undefined)
+            requestOptions.maxBodySize = options.maxBodySize;
+        const response = await sendStartSessionRequest(url, requestOptions);
+        // Check for errors
+        if (response.status === 'error') {
+            // Special handling for SESSION_ALREADY_RUNNING with helpful context
+            if (response.errorCode === IPCErrorCode.SESSION_ALREADY_RUNNING && response.existingSession) {
+                const { pid, targetUrl, duration } = response.existingSession;
+                const durationMs = duration ? duration * 1000 : 0;
+                console.error(sessionAlreadyRunningError(pid, durationMs, targetUrl));
+            }
+            else {
+                console.error(genericError(`Daemon error: ${response.message ?? 'Unknown error'}`));
+            }
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Extract metadata from response
+        const { data } = response;
+        if (!data) {
+            console.error(invalidResponseError('missing data'));
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        // Display landing page with session information
+        const landing = landingPage({
+            url: data.targetUrl,
+        });
+        console.error(landing);
+        // Session runs in background worker - CLI exits immediately
+        // This allows user to run other commands in the same terminal
+        process.exit(0);
+    }
+    catch (error) {
+        // Handle connection errors
+        const errorMessage = getErrorMessage(error);
+        if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+            console.error(daemonConnectionFailedError());
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+        console.error(genericError(errorMessage));
+        process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+    }
+}
+//# sourceMappingURL=daemonSessionController.js.map

package/dist/commands/shared/daemonSessionController.js.map

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

package/dist/commands/shared/landingPage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Landing page display for session start.
+ *
+ * This handler re-exports the centralized landing page message from \@/ui/messages.
+ * All message formatting is now centralized in the UI layer.
+ */
+export { landingPage, type LandingPageOptions } from '../../ui/messages/session.js';
+//# sourceMappingURL=landingPage.d.ts.map

package/dist/commands/shared/landingPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landingPage.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/landingPage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/commands/shared/landingPage.js

@@ -0,0 +1,8 @@
+/**
+ * Landing page display for session start.
+ *
+ * This handler re-exports the centralized landing page message from \@/ui/messages.
+ * All message formatting is now centralized in the UI layer.
+ */
+export { landingPage } from '../../ui/messages/session.js';
+//# sourceMappingURL=landingPage.js.map

package/dist/commands/shared/landingPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landingPage.js","sourceRoot":"","sources":["../../../src/commands/shared/landingPage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAA2B,MAAM,0BAA0B,CAAC"}

package/dist/commands/shared/sessionController.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Aggressively cleanup stale Chrome processes launched by bdg.
+ *
+ * This function kills Chrome instances that were launched by bdg by:
+ * 1. Reading the Chrome PID from persistent cache (~/.bdg/chrome.pid)
+ * 2. Killing that specific Chrome process using cross-platform kill logic
+ *
+ * The cache survives session cleanup, so this works even after a normal session end.
+ *
+ * Cross-platform killing:
+ * - Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
+ * - Unix/macOS: Uses `process.kill(-pid, 'SIGKILL')` to kill process group
+ *
+ * Note: We can't use chromeLauncher.killAll() because it only tracks instances
+ * created via chromeLauncher.launch(), but we use new chromeLauncher.Launcher()
+ * which doesn't register in that tracking set.
+ *
+ * @returns Number of errors encountered during cleanup
+ */
+export declare function cleanupStaleChrome(): Promise<number>;
+//# sourceMappingURL=sessionController.d.ts.map

package/dist/commands/shared/sessionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionController.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/sessionController.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuC1D"}

package/dist/commands/shared/sessionController.js

@@ -0,0 +1,55 @@
+import { getErrorMessage } from '../../utils/errors.js';
+/**
+ * Aggressively cleanup stale Chrome processes launched by bdg.
+ *
+ * This function kills Chrome instances that were launched by bdg by:
+ * 1. Reading the Chrome PID from persistent cache (~/.bdg/chrome.pid)
+ * 2. Killing that specific Chrome process using cross-platform kill logic
+ *
+ * The cache survives session cleanup, so this works even after a normal session end.
+ *
+ * Cross-platform killing:
+ * - Windows: Uses `taskkill /pid <pid> /T /F` to kill process tree
+ * - Unix/macOS: Uses `process.kill(-pid, 'SIGKILL')` to kill process group
+ *
+ * Note: We can't use chromeLauncher.killAll() because it only tracks instances
+ * created via chromeLauncher.launch(), but we use new chromeLauncher.Launcher()
+ * which doesn't register in that tracking set.
+ *
+ * @returns Number of errors encountered during cleanup
+ */
+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');
+        // Read Chrome PID from persistent cache
+        const chromePid = readChromePid();
+        if (!chromePid) {
+            console.error('Warning: No Chrome PID found in cache');
+            console.error('   Either Chrome was already running, or no Chrome was launched by bdg\n');
+            return 0;
+        }
+        // Kill Chrome process (cross-platform)
+        console.error(`Killing Chrome process (PID: ${chromePid})...`);
+        try {
+            // Use SIGKILL for aggressive cleanup (force kill)
+            killChromeProcess(chromePid, 'SIGKILL');
+            console.error('Chrome process killed successfully');
+            // Clear the cache after successful kill
+            clearChromePid();
+            return 0;
+        }
+        catch (killError) {
+            console.error(`Error: Failed to kill Chrome process: ${getErrorMessage(killError)}`);
+            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`);
+        return 1;
+    }
+}
+//# sourceMappingURL=sessionController.js.map

package/dist/commands/shared/sessionController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionController.js","sourceRoot":"","sources":["../../../src/commands/shared/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"}

package/dist/commands/start.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+/**
+ * Register the start command
+ *
+ * @param program - Commander.js Command instance to register command on
+ * @returns void
+ */
+export declare function registerStartCommands(program: Command): void;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+GzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa5D"}

package/dist/commands/start.js

@@ -0,0 +1,85 @@
+import { startSessionViaDaemon } from '../commands/shared/daemonSessionController.js';
+import { DEFAULT_DEBUG_PORT, PORT_OPTION_DESCRIPTION, TIMEOUT_OPTION_DESCRIPTION, USER_DATA_DIR_OPTION_DESCRIPTION, } from '../constants.js';
+import { startCommandHelpMessage } from '../ui/messages/commands.js';
+import { invalidIntegerError } from '../ui/messages/validation.js';
+/**
+ * Apply shared telemetry options to a command
+ *
+ * @param command - Commander.js Command instance to apply options to
+ * @returns The modified Command instance with all telemetry options applied
+ */
+function applyCollectorOptions(command) {
+    return command
+        .option('-p, --port <number>', PORT_OPTION_DESCRIPTION, DEFAULT_DEBUG_PORT)
+        .option('-t, --timeout <seconds>', TIMEOUT_OPTION_DESCRIPTION)
+        .option('-u, --user-data-dir <path>', USER_DATA_DIR_OPTION_DESCRIPTION)
+        .option('-a, --all', 'Include all data (disable filtering of tracking/analytics)')
+        .option('-m, --max-body-size <megabytes>', 'Maximum response body size in MB (default: 5MB)', '5')
+        .option('--compact', 'Use compact JSON format (no indentation) for output files');
+}
+/**
+ * Parse a string to integer, returning undefined if not provided
+ * @param value - Optional string value to parse
+ * @param fieldName - Name of the field being parsed (for error messages)
+ * @returns Parsed integer or undefined if value was not provided
+ * @throws Error if value is provided but not a valid integer
+ */
+function parseOptionalInt(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        throw new Error(invalidIntegerError(fieldName, value));
+    }
+    return parsed;
+}
+/**
+ * Transform CLI options into session options
+ *
+ * @param options - Parsed command-line options from Commander
+ * @returns Session options object with parsed and normalized values
+ */
+function buildSessionOptions(options) {
+    const maxBodySizeMB = parseOptionalInt(options.maxBodySize, 'max-body-size');
+    return {
+        port: parseInt(options.port, 10),
+        timeout: parseOptionalInt(options.timeout, 'timeout'),
+        userDataDir: options.userDataDir,
+        includeAll: options.all ?? false,
+        maxBodySize: maxBodySizeMB !== undefined ? maxBodySizeMB * 1024 * 1024 : undefined,
+        compact: options.compact ?? false,
+    };
+}
+/**
+ * Common action handler for telemetry commands
+ *
+ * @param url - Target URL to collect telemetry from
+ * @param options - Parsed command-line options from Commander
+ * @returns Promise that resolves when session completes or is stopped
+ */
+async function collectorAction(url, options) {
+    const sessionOptions = buildSessionOptions(options);
+    // Always collect all 3 types (dom, network, console)
+    const telemetry = ['dom', 'network', 'console'];
+    // Dispatch to daemon via IPC instead of running in-process
+    await startSessionViaDaemon(url, sessionOptions, telemetry);
+}
+/**
+ * Register the start command
+ *
+ * @param program - Commander.js Command instance to register command on
+ * @returns void
+ */
+export function registerStartCommands(program) {
+    // Default command: always collects all 3 types (dom, network, console)
+    applyCollectorOptions(program.argument('[url]', 'Target URL (example.com or localhost:3000)')).action(async (url, options) => {
+        // Show friendly help if no URL provided
+        if (!url) {
+            console.error(startCommandHelpMessage());
+            process.exit(0);
+        }
+        await collectorAction(url, options);
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAoBlE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,OAAO,OAAO;SACX,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,CAAC;SAC1E,MAAM,CAAC,yBAAyB,EAAE,0BAA0B,CAAC;SAC7D,MAAM,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;SACtE,MAAM,CAAC,WAAW,EAAE,4DAA4D,CAAC;SACjF,MAAM,CACL,iCAAiC,EACjC,iDAAiD,EACjD,GAAG,CACJ;SACA,MAAM,CAAC,WAAW,EAAE,2DAA2D,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAAyB,EAAE,SAAiB;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAyB;IAQpD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;QACrD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;QAChC,WAAW,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;QAClF,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,OAAyB;IACnE,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAEpD,qDAAqD;IACrD,MAAM,SAAS,GAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjE,2DAA2D;IAC3D,MAAM,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,uEAAuE;IACvE,qBAAqB,CACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,4CAA4C,CAAC,CACxE,CAAC,MAAM,CAAC,KAAK,EAAE,GAAuB,EAAE,OAAyB,EAAE,EAAE;QACpE,wCAAwC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/{cli/commands/query.d.ts → commands/status.d.ts}

@@ -1,9 +1,9 @@
 import type { Command } from 'commander';
 /**
- * Register query command
+ * Register status command
  *
  * @param program - Commander.js Command instance to register commands on
  * @returns void
  */
-export declare function registerQueryCommand(program: Command): void;
-//# sourceMappingURL=query.d.ts.map
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoF5D"}

package/dist/commands/status.js

@@ -0,0 +1,87 @@
+import { getStatus } from '../ipc/client.js';
+import { cleanupStaleDaemonPid } from '../session/cleanup.js';
+import { formatSessionStatus, formatStatusAsJson, formatNoSessionMessage, } from '../ui/formatters/status.js';
+import { daemonNotRunningWithCleanup } from '../ui/messages/commands.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { EXIT_CODES } from '../utils/exitCodes.js';
+import { VERSION } from '../utils/version.js';
+/**
+ * Register status command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ * @returns void
+ */
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show active session status and collection statistics')
+        .option('-j, --json', 'Output as JSON')
+        .option('-v, --verbose', 'Show detailed Chrome diagnostics')
+        .action(async (options) => {
+        try {
+            // Request status from daemon via IPC
+            const response = await getStatus();
+            // Handle IPC error response
+            if (response.status === 'error') {
+                console.error(`Daemon error: ${response.error ?? 'Unknown error'}`);
+                process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+            }
+            // Extract data from response
+            const { data } = response;
+            if (!data) {
+                console.error('Invalid response from daemon: missing data');
+                process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+            }
+            // Check if there's an active session
+            if (!data.sessionPid || !data.sessionMetadata) {
+                if (options.json) {
+                    console.log(JSON.stringify({ version: VERSION, active: false }, null, 2));
+                }
+                else {
+                    console.error(formatNoSessionMessage());
+                }
+                process.exit(EXIT_CODES.SUCCESS);
+            }
+            // Convert IPC metadata to SessionMetadata format
+            const metadata = {
+                bdgPid: data.sessionMetadata.bdgPid,
+                chromePid: data.sessionMetadata.chromePid,
+                startTime: data.sessionMetadata.startTime,
+                port: data.sessionMetadata.port,
+                targetId: data.sessionMetadata.targetId,
+                webSocketDebuggerUrl: data.sessionMetadata.webSocketDebuggerUrl,
+                activeTelemetry: data.sessionMetadata.activeTelemetry,
+            };
+            if (options.json) {
+                // JSON output - include activity and page state
+                const jsonOutput = formatStatusAsJson(metadata, data.sessionPid);
+                // Merge in activity data if available
+                if (data.activity) {
+                    jsonOutput.activity = data.activity;
+                }
+                if (data.pageState) {
+                    jsonOutput.pageState = data.pageState;
+                }
+                console.log(JSON.stringify(jsonOutput, null, 2));
+            }
+            else {
+                // Human-readable output - pass activity and page state
+                console.log(formatSessionStatus(metadata, data.sessionPid, data.activity, data.pageState, options.verbose ?? false));
+            }
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        catch (error) {
+            // Handle connection errors (daemon not running)
+            const errorMessage = getErrorMessage(error);
+            if (errorMessage.includes('ENOENT') || errorMessage.includes('ECONNREFUSED')) {
+                // P0 Fix #2: Auto-cleanup stale daemon PID if it exists
+                const cleaned = cleanupStaleDaemonPid();
+                console.error(daemonNotRunningWithCleanup(cleaned));
+                process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+            }
+            console.error(`Error checking status: ${errorMessage}`);
+            process.exit(EXIT_CODES.UNHANDLED_EXCEPTION);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAY7C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;SACtC,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC;YAEnC,4BAA4B;YAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChC,OAAO,CAAC,KAAK,CAAC,iBAAiB,QAAQ,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC/C,CAAC;YAED,6BAA6B;YAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;gBAC5D,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC/C,CAAC;YAED,qCAAqC;YACrC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC5E,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC;gBAC1C,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YAED,iDAAiD;YACjD,MAAM,QAAQ,GAAoB;gBAChC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM;gBACnC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS;gBACzC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS;gBACzC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;gBAC/B,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ;gBACvC,oBAAoB,EAAE,IAAI,CAAC,eAAe,CAAC,oBAAoB;gBAC/D,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe;aACtD,CAAC;YAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,gDAAgD;gBAChD,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjE,sCAAsC;gBACtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;gBACtC,CAAC;gBACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBACxC,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,uDAAuD;gBACvD,OAAO,CAAC,GAAG,CACT,mBAAmB,CACjB,QAAQ,EACR,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,EACd,OAAO,CAAC,OAAO,IAAI,KAAK,CACzB,CACF,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gDAAgD;YAChD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC7E,wDAAwD;gBACxD,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;gBACpD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/stop.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+/**
+ * Register stop command
+ *
+ * @param program - Commander.js Command instance to register commands on
+ */
+export declare function registerStopCommand(program: Command): void;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqFzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8F1D"}