browser-debugger-cli 0.1.0 → 0.3.0

package/dist/commands/shared/OutputBuilder.js

@@ -0,0 +1,138 @@
+import { getErrorMessage } from '../../utils/errors.js';
+import { VERSION } from '../../utils/version.js';
+/**
+ * Helper: build output payloads for different modes with consistent metadata.
+ * Modes: preview (metadata only), full (with bodies), final (complete with DOM).
+ */
+export class OutputBuilder {
+    /**
+     * Build session output with consistent metadata.
+     *
+     * @param options - Configuration for output construction
+     * @returns BdgOutput payload
+     */
+    static build(options) {
+        const { mode, target, startTime, networkRequests, consoleLogs, domData, activeTelemetry } = options;
+        const baseOutput = {
+            version: VERSION,
+            success: true,
+            timestamp: new Date().toISOString(),
+            duration: Date.now() - startTime,
+            target: {
+                url: target.url,
+                title: target.title,
+            },
+            // Only final outputs are complete (partial=false)
+            partial: mode !== 'final',
+        };
+        if (mode === 'preview') {
+            // Lightweight preview: metadata only, last 1000 items
+            const previewData = {};
+            if (activeTelemetry.includes('network')) {
+                previewData['network'] = networkRequests.slice(-1000).map((req) => ({
+                    requestId: req.requestId,
+                    url: req.url,
+                    method: req.method,
+                    timestamp: req.timestamp,
+                    status: req.status,
+                    mimeType: req.mimeType,
+                    // Exclude requestBody, responseBody, headers for lightweight preview
+                }));
+            }
+            if (activeTelemetry.includes('console')) {
+                previewData['console'] = consoleLogs.slice(-1000).map((msg) => ({
+                    type: msg.type,
+                    text: msg.text,
+                    timestamp: msg.timestamp,
+                    // Exclude args for lightweight preview
+                }));
+            }
+            // DOM omitted in preview (only captured on stop)
+            return {
+                ...baseOutput,
+                data: previewData,
+            };
+        }
+        if (mode === 'full') {
+            // Full mode: complete data with bodies
+            const fullData = {};
+            if (activeTelemetry.includes('network')) {
+                fullData['network'] = networkRequests; // All data with bodies
+            }
+            if (activeTelemetry.includes('console')) {
+                fullData['console'] = consoleLogs; // All data with args
+            }
+            // DOM omitted (only captured on stop)
+            return {
+                ...baseOutput,
+                data: fullData,
+            };
+        }
+        // Final mode - includes DOM, partial=false
+        const finalData = {};
+        if (activeTelemetry.includes('network')) {
+            finalData['network'] = networkRequests;
+        }
+        if (activeTelemetry.includes('console')) {
+            finalData['console'] = consoleLogs;
+        }
+        if (activeTelemetry.includes('dom') && domData) {
+            finalData['dom'] = domData;
+        }
+        return {
+            ...baseOutput,
+            partial: false,
+            data: finalData,
+        };
+    }
+    /**
+     * Build error output with consistent structure.
+     *
+     * @param error - Error object or string
+     * @param startTime - Session start timestamp
+     * @param target - Optional target information
+     * @returns BdgOutput payload with error
+     */
+    static buildError(error, startTime, target) {
+        return {
+            version: VERSION,
+            success: false,
+            timestamp: new Date().toISOString(),
+            duration: Date.now() - startTime,
+            target: target ? { url: target.url, title: target.title } : { url: '', title: '' },
+            data: {},
+            error: getErrorMessage(error),
+        };
+    }
+    /**
+     * Build a simple JSON error response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param error - Error message or Error object
+     * @param options - Optional fields (exitCode, additional data)
+     * @returns JSON-serializable error object
+     */
+    static buildJsonError(error, options) {
+        return {
+            version: VERSION,
+            success: false,
+            error: error instanceof Error ? error.message : error,
+            ...options,
+        };
+    }
+    /**
+     * Build a simple JSON success response for commands.
+     * Used by commands that don't follow the full BdgOutput structure (stop, cleanup, query).
+     *
+     * @param data - Response data
+     * @returns JSON-serializable success object
+     */
+    static buildJsonSuccess(data) {
+        return {
+            version: VERSION,
+            success: true,
+            ...data,
+        };
+    }
+}
+//# sourceMappingURL=OutputBuilder.js.map

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

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

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

@@ -0,0 +1,54 @@
+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 declare const jsonOption: Option;
+/**
+ * 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 declare const lastOption: Option;
+/**
+ * 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 declare function filterOption(validTypes: string[]): Option;
+//# sourceMappingURL=commonOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonOptions.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,QAA6C,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAQnB,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAIzD"}

package/dist/commands/shared/commonOptions.js

@@ -0,0 +1,65 @@
+import { Option } from 'commander';
+import { invalidLastRangeError } from '../../ui/messages/validation.js';
+/**
+ * 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(invalidLastRangeError(0, 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,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;;;;;;;;;;;;;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,qBAAqB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,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":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAqC1D"}

package/dist/commands/shared/sessionController.js

@@ -0,0 +1,54 @@
+import { cleanupChromeAttemptingMessage, cleanupChromePidNotFoundMessage, cleanupChromeKillingMessage, cleanupChromeSuccessMessage, cleanupChromeFailedMessage, cleanupChromeProcessFailedMessage, } from '../../ui/messages/chrome.js';
+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(cleanupChromeAttemptingMessage());
+    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(cleanupChromePidNotFoundMessage());
+            return 0;
+        }
+        // Kill Chrome process (cross-platform)
+        console.error(cleanupChromeKillingMessage(chromePid));
+        try {
+            // Use SIGKILL for aggressive cleanup (force kill)
+            killChromeProcess(chromePid, 'SIGKILL');
+            console.error(cleanupChromeSuccessMessage());
+            // Clear the cache after successful kill
+            clearChromePid();
+            return 0;
+        }
+        catch (killError) {
+            console.error(cleanupChromeFailedMessage(getErrorMessage(killError)));
+            return 1;
+        }
+    }
+    catch (error) {
+        console.error(cleanupChromeProcessFailedMessage(getErrorMessage(error)));
+        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,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC;IAEhD,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,+BAA+B,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,uCAAuC;QACvC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC;YACH,kDAAkD;YAClD,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAExC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC;YAE7C,wCAAwC;YACxC,cAAc,EAAE,CAAC;YAEjB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzE,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;AA0BzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoF5D"}