afterburn-cli 1.0.0

package/dist/browser/browser-manager.d.ts

@@ -0,0 +1,45 @@
+import type { BrowserContext, Page } from 'playwright';
+import type { BrowserConfig } from '../types/artifacts.js';
+import type { ChallengeDetectionResult } from './challenge-detector.js';
+/**
+ * Manages browser lifecycle: launch, navigation, and cleanup.
+ * Automatically dismisses cookie banners after navigation.
+ */
+export declare class BrowserManager {
+    private browser;
+    private context;
+    private config?;
+    constructor(config?: Partial<BrowserConfig>);
+    /**
+     * Launches stealth-enabled browser and creates context
+     */
+    launch(): Promise<void>;
+    private _lastChallengeResult;
+    /**
+     * Returns the challenge detection result from the most recent newPage() navigation.
+     */
+    get lastChallengeResult(): ChallengeDetectionResult;
+    /**
+     * Creates a new page and optionally navigates to a URL.
+     * Automatically dismisses cookie banners and detects bot-challenge pages after navigation.
+     *
+     * @param url - Optional URL to navigate to
+     * @returns Playwright page instance
+     */
+    newPage(url?: string, options?: {
+        networkIdleTimeout?: number;
+    }): Promise<Page>;
+    /**
+     * Closes browser and cleans up resources.
+     * Safe to call multiple times.
+     */
+    close(): Promise<void>;
+    /**
+     * Returns the browser context for route interception (e.g., blocking resources).
+     */
+    getContext(): BrowserContext | null;
+    /**
+     * Checks if browser is currently launched
+     */
+    get isLaunched(): boolean;
+}

package/dist/browser/browser-manager.js

@@ -0,0 +1,88 @@
+// Browser lifecycle management with stealth and cookie dismissal
+import { createStealthBrowser } from './stealth-browser.js';
+import { dismissCookieBanner } from './cookie-dismisser.js';
+import { detectChallengePage } from './challenge-detector.js';
+/**
+ * Manages browser lifecycle: launch, navigation, and cleanup.
+ * Automatically dismisses cookie banners after navigation.
+ */
+export class BrowserManager {
+    browser = null;
+    context = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Launches stealth-enabled browser and creates context
+     */
+    async launch() {
+        const { browser, context } = await createStealthBrowser(this.config);
+        this.browser = browser;
+        this.context = context;
+    }
+    // Tracks whether the last navigated page was a bot-challenge page
+    _lastChallengeResult = { isChallengePage: false, provider: null };
+    /**
+     * Returns the challenge detection result from the most recent newPage() navigation.
+     */
+    get lastChallengeResult() {
+        return this._lastChallengeResult;
+    }
+    /**
+     * Creates a new page and optionally navigates to a URL.
+     * Automatically dismisses cookie banners and detects bot-challenge pages after navigation.
+     *
+     * @param url - Optional URL to navigate to
+     * @returns Playwright page instance
+     */
+    async newPage(url, options) {
+        if (!this.context) {
+            throw new Error('Browser not launched. Call launch() first.');
+        }
+        const page = await this.context.newPage();
+        if (url) {
+            // Navigate with DOM ready first
+            await page.goto(url, { waitUntil: 'domcontentloaded' });
+            // Detect anti-bot challenge pages before processing content
+            this._lastChallengeResult = await detectChallengePage(page);
+            if (this._lastChallengeResult.isChallengePage) {
+                console.warn(`Anti-bot challenge detected (${this._lastChallengeResult.provider}) on ${url}. Results may be incomplete.`);
+            }
+            // Try to dismiss cookie banner
+            await dismissCookieBanner(page);
+            // Wait for network idle with timeout (some SPAs never reach idle)
+            try {
+                await page.waitForLoadState('networkidle', { timeout: options?.networkIdleTimeout ?? 2000 });
+            }
+            catch {
+                // Timeout is acceptable - page may never reach networkidle
+            }
+        }
+        return page;
+    }
+    /**
+     * Closes browser and cleans up resources.
+     * Safe to call multiple times.
+     */
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.context = null;
+        }
+    }
+    /**
+     * Returns the browser context for route interception (e.g., blocking resources).
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * Checks if browser is currently launched
+     */
+    get isLaunched() {
+        return this.browser !== null && this.context !== null;
+    }
+}
+//# sourceMappingURL=browser-manager.js.map

package/dist/browser/browser-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-manager.js","sourceRoot":"","sources":["../../src/browser/browser-manager.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAIjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAmB,IAAI,CAAC;IAC/B,OAAO,GAA0B,IAAI,CAAC;IACtC,MAAM,CAA0B;IAExC,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,kEAAkE;IAC1D,oBAAoB,GAA6B,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAEpG;;OAEG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,GAAY,EAAE,OAAyC;QACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAE1C,IAAI,GAAG,EAAE,CAAC;YACR,gCAAgC;YAChC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAExD,4DAA4D;YAC5D,IAAI,CAAC,oBAAoB,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,oBAAoB,CAAC,eAAe,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,QAAQ,GAAG,8BAA8B,CAAC,CAAC;YAC5H,CAAC;YAED,+BAA+B;YAC/B,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAEhC,kEAAkE;YAClE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/F,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IACxD,CAAC;CACF"}

package/dist/browser/challenge-detector.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from 'playwright';
+export interface ChallengeDetectionResult {
+    isChallengePage: boolean;
+    provider: string | null;
+}
+/**
+ * Checks if the current page is an anti-bot challenge page rather than real site content.
+ * Should be called after page.goto() to prevent parsing challenge HTML as real content.
+ */
+export declare function detectChallengePage(page: Page): Promise<ChallengeDetectionResult>;

package/dist/browser/challenge-detector.js

@@ -0,0 +1,58 @@
+// Detect anti-bot challenge pages (Cloudflare, Akamai, etc.) that block automated testing
+/**
+ * Checks if the current page is an anti-bot challenge page rather than real site content.
+ * Should be called after page.goto() to prevent parsing challenge HTML as real content.
+ */
+export async function detectChallengePage(page) {
+    try {
+        const title = await page.title();
+        const titleLower = title.toLowerCase();
+        // Cloudflare challenge: title is "Just a moment..." or "Attention Required!"
+        if (titleLower.includes('just a moment') || titleLower.includes('attention required')) {
+            return { isChallengePage: true, provider: 'Cloudflare' };
+        }
+        // Check for known challenge page indicators in the DOM
+        const challengeIndicators = await page.evaluate(() => {
+            const body = document.body?.textContent?.toLowerCase() || '';
+            const html = document.documentElement?.innerHTML?.toLowerCase() || '';
+            return {
+                // Cloudflare-specific
+                hasCfChallenge: !!document.querySelector('#cf-challenge-running, #challenge-running, .cf-browser-verification'),
+                hasCfScript: html.includes('__cf_chl_opt') || html.includes('cf-browser-verification'),
+                hasCheckingBrowser: body.includes('checking your browser') || body.includes('verify you are human'),
+                // Akamai Bot Manager
+                hasAkamai: html.includes('akamai') && (body.includes('access denied') || body.includes('reference #')),
+                // Generic bot detection
+                hasAccessDenied: (body.includes('access denied') || body.includes('forbidden')) && body.length < 2000,
+                hasCaptcha: !!document.querySelector('.g-recaptcha, .h-captcha, [data-sitekey]'),
+                // PerimeterX
+                hasPerimeterX: html.includes('perimeterx') || html.includes('_pxhd'),
+                bodyLength: body.length,
+            };
+        });
+        if (challengeIndicators.hasCfChallenge || challengeIndicators.hasCfScript) {
+            return { isChallengePage: true, provider: 'Cloudflare' };
+        }
+        if (challengeIndicators.hasCheckingBrowser && challengeIndicators.bodyLength < 5000) {
+            return { isChallengePage: true, provider: 'Anti-bot protection' };
+        }
+        if (challengeIndicators.hasAkamai) {
+            return { isChallengePage: true, provider: 'Akamai' };
+        }
+        if (challengeIndicators.hasPerimeterX) {
+            return { isChallengePage: true, provider: 'PerimeterX' };
+        }
+        if (challengeIndicators.hasAccessDenied) {
+            return { isChallengePage: true, provider: 'Access control' };
+        }
+        if (challengeIndicators.hasCaptcha && challengeIndicators.bodyLength < 5000) {
+            return { isChallengePage: true, provider: 'CAPTCHA' };
+        }
+        return { isChallengePage: false, provider: null };
+    }
+    catch {
+        // If detection fails, assume it's not a challenge page
+        return { isChallengePage: false, provider: null };
+    }
+}
+//# sourceMappingURL=challenge-detector.js.map

package/dist/browser/challenge-detector.js.map

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

package/dist/browser/cookie-dismisser.d.ts

@@ -0,0 +1,18 @@
+import type { Page } from 'playwright';
+import type { CookieBannerSelector } from '../types/artifacts.js';
+/**
+ * Known cookie consent platforms with their selectors
+ * Ordered by prevalence (OneTrust is most common)
+ */
+export declare const COOKIE_SELECTORS: CookieBannerSelector[];
+/**
+ * Attempts to detect and dismiss cookie consent banners.
+ * Tries known platforms in order, clicking the first visible accept button.
+ *
+ * @param page - Playwright page instance
+ * @returns Object indicating if banner was dismissed and which platform
+ */
+export declare function dismissCookieBanner(page: Page): Promise<{
+    dismissed: boolean;
+    platform: string | null;
+}>;

package/dist/browser/cookie-dismisser.js

@@ -0,0 +1,76 @@
+// Auto-detection and dismissal of cookie consent banners
+/**
+ * Known cookie consent platforms with their selectors
+ * Ordered by prevalence (OneTrust is most common)
+ */
+export const COOKIE_SELECTORS = [
+    {
+        name: 'OneTrust',
+        acceptButton: '#onetrust-accept-btn-handler',
+        modal: '#onetrust-banner-sdk',
+    },
+    {
+        name: 'Cookiebot',
+        acceptButton: '#CybotCookiebotDialogBodyLevelButtonLevelOptinAllowAll',
+        modal: '#CybotCookiebotDialog',
+    },
+    {
+        name: 'CookieYes',
+        acceptButton: '.cky-btn-accept',
+        modal: '.cky-consent-container',
+    },
+    {
+        name: 'Generic',
+        acceptButton: [
+            'button:has-text("Accept all")',
+            'button:has-text("Accept cookies")',
+            'button:has-text("Allow all")',
+            'button:has-text("I agree")',
+            '[id*="accept"]',
+            '[class*="accept"]',
+        ].join(', '),
+    },
+];
+/**
+ * Attempts to detect and dismiss cookie consent banners.
+ * Tries known platforms in order, clicking the first visible accept button.
+ *
+ * @param page - Playwright page instance
+ * @returns Object indicating if banner was dismissed and which platform
+ */
+export async function dismissCookieBanner(page) {
+    for (const selector of COOKIE_SELECTORS) {
+        try {
+            // Wait for accept button with short timeout (banner may not exist)
+            const button = page.locator(selector.acceptButton).first();
+            const isVisible = await button.isVisible({ timeout: 800 });
+            if (!isVisible) {
+                continue;
+            }
+            // Click the accept button
+            await button.click();
+            // If modal selector exists, wait for it to become hidden
+            if (selector.modal) {
+                try {
+                    await page.locator(selector.modal).waitFor({
+                        state: 'hidden',
+                        timeout: 5000,
+                    });
+                }
+                catch {
+                    // Modal might not disappear or might not exist - non-critical
+                }
+            }
+            // Wait for animations to complete
+            await page.waitForTimeout(500);
+            return { dismissed: true, platform: selector.name };
+        }
+        catch {
+            // This selector didn't work, try next one
+            continue;
+        }
+    }
+    // No cookie banner found
+    return { dismissed: false, platform: null };
+}
+//# sourceMappingURL=cookie-dismisser.js.map

package/dist/browser/cookie-dismisser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-dismisser.js","sourceRoot":"","sources":["../../src/browser/cookie-dismisser.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAKzD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD;QACE,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,8BAA8B;QAC5C,KAAK,EAAE,sBAAsB;KAC9B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,wDAAwD;QACtE,KAAK,EAAE,uBAAuB;KAC/B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,iBAAiB;QAC/B,KAAK,EAAE,wBAAwB;KAChC;IACD;QACE,IAAI,EAAE,SAAS;QACf,YAAY,EAAE;YACZ,+BAA+B;YAC/B,mCAAmC;YACnC,8BAA8B;YAC9B,4BAA4B;YAC5B,gBAAgB;YAChB,mBAAmB;SACpB,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAU;IAEV,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,mEAAmE;YACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAE3D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,0BAA0B;YAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAErB,yDAAyD;YACzD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;wBACzC,KAAK,EAAE,QAAQ;wBACf,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,8DAA8D;gBAChE,CAAC;YACH,CAAC;YAED,kCAAkC;YAClC,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAE/B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,SAAS;QACX,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,4 @@
+export * from './stealth-browser.js';
+export * from './cookie-dismisser.js';
+export * from './challenge-detector.js';
+export * from './browser-manager.js';

package/dist/browser/index.js

@@ -0,0 +1,6 @@
+// Barrel export for browser module
+export * from './stealth-browser.js';
+export * from './cookie-dismisser.js';
+export * from './challenge-detector.js';
+export * from './browser-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/browser/stealth-browser.d.ts

@@ -0,0 +1,13 @@
+import type { Browser, BrowserContext } from 'playwright';
+import type { BrowserConfig } from '../types/artifacts.js';
+/**
+ * Creates a stealth-enabled Playwright browser with anti-bot evasion.
+ * Uses playwright-extra with stealth plugin to bypass detection on real websites.
+ *
+ * @param config - Optional browser configuration overrides
+ * @returns Object containing browser and context references
+ */
+export declare function createStealthBrowser(config?: Partial<BrowserConfig>): Promise<{
+    browser: Browser;
+    context: BrowserContext;
+}>;

package/dist/browser/stealth-browser.js

@@ -0,0 +1,59 @@
+// Stealth-enabled Playwright browser creation with anti-bot evasion
+import { chromium } from 'playwright-extra';
+import StealthPlugin from 'puppeteer-extra-plugin-stealth';
+// Prevent duplicate plugin registration
+let pluginApplied = false;
+/**
+ * Default browser configuration with realistic fingerprint
+ */
+const DEFAULT_CONFIG = {
+    headless: true,
+    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36',
+    viewport: {
+        width: 1920,
+        height: 1080,
+    },
+    locale: 'en-US',
+    timezoneId: 'America/New_York',
+};
+/**
+ * Creates a stealth-enabled Playwright browser with anti-bot evasion.
+ * Uses playwright-extra with stealth plugin to bypass detection on real websites.
+ *
+ * @param config - Optional browser configuration overrides
+ * @returns Object containing browser and context references
+ */
+export async function createStealthBrowser(config) {
+    // Apply stealth plugin once
+    if (!pluginApplied) {
+        chromium.use(StealthPlugin());
+        pluginApplied = true;
+    }
+    // Merge config with defaults
+    const finalConfig = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        viewport: {
+            ...DEFAULT_CONFIG.viewport,
+            ...config?.viewport,
+        },
+    };
+    // Launch browser with anti-bot evasion arguments
+    const browser = await chromium.launch({
+        headless: finalConfig.headless,
+        args: [
+            '--disable-blink-features=AutomationControlled',
+            '--disable-features=IsolateOrigins,site-per-process',
+            '--disable-site-isolation-trials',
+        ],
+    });
+    // Create context with realistic fingerprint
+    const context = await browser.newContext({
+        userAgent: finalConfig.userAgent,
+        viewport: finalConfig.viewport,
+        locale: finalConfig.locale,
+        timezoneId: finalConfig.timezoneId,
+    });
+    return { browser, context };
+}
+//# sourceMappingURL=stealth-browser.js.map

package/dist/browser/stealth-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth-browser.js","sourceRoot":"","sources":["../../src/browser/stealth-browser.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAI3D,wCAAwC;AACxC,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;GAEG;AACH,MAAM,cAAc,GAAkB;IACpC,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,iHAAiH;IAC5H,QAAQ,EAAE;QACR,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;KACb;IACD,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,kBAAkB;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA+B;IAE/B,4BAA4B;IAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9B,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAkB;QACjC,GAAG,cAAc;QACjB,GAAG,MAAM;QACT,QAAQ,EAAE;YACR,GAAG,cAAc,CAAC,QAAQ;YAC1B,GAAG,MAAM,EAAE,QAAQ;SACpB;KACF,CAAC;IAEF,iDAAiD;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE;YACJ,+CAA+C;YAC/C,oDAAoD;YACpD,iCAAiC;SAClC;KACF,CAAC,CAAC;IAEH,4CAA4C;IAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACvC,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cli/commander-cli.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const program: Command;

package/dist/cli/commander-cli.js

@@ -0,0 +1,150 @@
+// Commander.js CLI program definition with all flags and action handler
+import { Command } from 'commander';
+import { runAfterburn } from '../core/index.js';
+import { ensureBrowserInstalled, createSpinner } from './index.js';
+import { runDoctor, printDoctorResults } from './doctor.js';
+export const program = new Command();
+program
+    .name('afterburn')
+    .description('Automated testing for vibe-coded websites')
+    .version('1.0.0')
+    .showHelpAfterError(true)
+    .argument('<url>', 'URL to test')
+    .option('--source <path>', 'Source code directory for pinpointing bugs')
+    .option('--email <email>', 'Login email (or set AFTERBURN_EMAIL env var)')
+    .option('--password <password>', 'Login password (tip: use AFTERBURN_PASSWORD env var to avoid shell history exposure)')
+    .option('--output-dir <path>', 'Custom output directory (default: ./afterburn-reports/{timestamp})')
+    .option('--flows <hints>', 'Comma-separated workflow hints (e.g., "signup, checkout")')
+    .option('--max-pages <n>', 'Max pages to crawl (default: 50, max: 500)', '50')
+    .option('--no-headless', 'Show browser window (useful for debugging)')
+    .option('--verbose', 'Show detailed progress output')
+    .action(async (url, opts) => {
+    // Resolve credentials: CLI flags take priority, env vars are fallback
+    const email = opts.email || process.env.AFTERBURN_EMAIL;
+    const password = opts.password || process.env.AFTERBURN_PASSWORD;
+    // First-run browser check
+    await ensureBrowserInstalled();
+    // Print banner
+    console.log('Afterburn v1.0.0\n');
+    // In verbose mode, show credential source without exposing actual values
+    if (opts.verbose) {
+        if (email) {
+            const atIndex = email.indexOf('@');
+            const masked = atIndex > 3
+                ? email.substring(0, 3) + '***' + email.substring(atIndex)
+                : '***' + email.substring(atIndex);
+            console.log(`  Auth email: ${masked}`);
+        }
+        if (password)
+            console.log(`  Auth password: ***`);
+    }
+    // Create spinner for progress tracking
+    let spinner;
+    let currentStage = '';
+    // Parse --flows flag
+    const flowHints = opts.flows
+        ? opts.flows.split(',').map(s => s.trim()).filter(Boolean)
+        : undefined;
+    // Parse --max-pages flag (Commander passes string, convert to number)
+    // Validation happens in core/engine.ts via validateMaxPages
+    const parsedMaxPages = parseInt(opts.maxPages, 10);
+    const maxPages = isNaN(parsedMaxPages) ? undefined : parsedMaxPages;
+    try {
+        const result = await runAfterburn({
+            targetUrl: url,
+            sourcePath: opts.source,
+            email,
+            password,
+            outputDir: opts.outputDir,
+            flowHints,
+            maxPages,
+            headless: opts.headless,
+            onProgress: (stage, message) => {
+                // Detect stage change before updating currentStage
+                const stageChanged = stage !== currentStage;
+                // Map stage names to ora spinner text
+                if (stageChanged) {
+                    currentStage = stage;
+                    // Stop previous spinner if exists
+                    if (spinner) {
+                        spinner.succeed();
+                        spinner = undefined;
+                    }
+                    // Start new spinner for new stage (except 'complete')
+                    if (stage !== 'complete') {
+                        const spinnerText = {
+                            browser: 'Checking browser...',
+                            discovery: 'Crawling site...',
+                            execution: 'Testing workflows...',
+                            analysis: 'Analyzing results...',
+                            reporting: 'Generating reports...',
+                        }[stage] || message;
+                        spinner = createSpinner(spinnerText).start();
+                    }
+                }
+                // Verbose mode: show detailed messages within same stage
+                if (opts.verbose && !stageChanged) {
+                    if (spinner) {
+                        spinner.text = message;
+                    }
+                }
+            },
+        });
+        // Complete spinner
+        if (spinner) {
+            spinner.succeed();
+        }
+        // Print one-liner summary (ASCII-safe for Windows terminals)
+        console.log(`\nHealth: ${result.healthScore.overall}/100 - ${result.totalIssues} issues found (${result.highPriorityCount} high, ${result.mediumPriorityCount} medium, ${result.lowPriorityCount} low)`);
+        // Print top 3 issues in terminal so the user sees value immediately
+        if (result.prioritizedIssues.length > 0) {
+            console.log('\nTop issues:');
+            const topIssues = result.prioritizedIssues.slice(0, 3);
+            for (let i = 0; i < topIssues.length; i++) {
+                const issue = topIssues[i];
+                const priorityTag = issue.priority === 'high' ? '[HIGH]' : issue.priority === 'medium' ? '[MED]' : '[LOW]';
+                // Truncate summary for terminal readability
+                const summary = issue.summary.length > 80 ? issue.summary.slice(0, 77) + '...' : issue.summary;
+                console.log(`  ${i + 1}. ${priorityTag} ${summary}`);
+            }
+            if (result.prioritizedIssues.length > 3) {
+                console.log(`  ... and ${result.prioritizedIssues.length - 3} more (see report)`);
+            }
+        }
+        // Print report paths if they exist
+        if (result.htmlReportPath || result.markdownReportPath) {
+            console.log('\nReports saved:');
+            if (result.htmlReportPath) {
+                console.log(`  HTML:     ${result.htmlReportPath}`);
+            }
+            if (result.markdownReportPath) {
+                console.log(`  Markdown: ${result.markdownReportPath}`);
+            }
+        }
+        console.log('');
+        // Exit with code based on execution results
+        process.exit(result.exitCode);
+    }
+    catch (error) {
+        // Fail spinner if active
+        if (spinner) {
+            spinner.fail();
+        }
+        console.error('\n[x] Error:', error instanceof Error ? error.message : String(error));
+        if (opts.verbose && error instanceof Error && error.stack) {
+            console.error('\nStack trace:');
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+});
+// Doctor subcommand: pre-flight environment checks
+program
+    .command('doctor')
+    .description('Check if your environment is ready to run Afterburn')
+    .action(async () => {
+    const { results, exitCode } = await runDoctor();
+    printDoctorResults(results, exitCode);
+    process.exit(exitCode);
+});
+//# sourceMappingURL=commander-cli.js.map

package/dist/cli/commander-cli.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,34 @@
+export type CheckStatus = 'pass' | 'warn' | 'fail';
+export interface CheckResult {
+    name: string;
+    status: CheckStatus;
+    message: string;
+    required: boolean;
+}
+/**
+ * Check Node.js version >= 18
+ */
+export declare function checkNodeVersion(): CheckResult;
+/**
+ * Check if Playwright Chromium browser is installed
+ */
+export declare function checkBrowserInstalled(): CheckResult;
+/**
+ * Check if GEMINI_API_KEY is set (optional, warn only)
+ */
+export declare function checkApiKey(): CheckResult;
+/**
+ * Check network connectivity by resolving a known host
+ */
+export declare function checkNetwork(): Promise<CheckResult>;
+/**
+ * Run all doctor checks and return results + exit code
+ */
+export declare function runDoctor(): Promise<{
+    results: CheckResult[];
+    exitCode: number;
+}>;
+/**
+ * Format and print doctor results to console
+ */
+export declare function printDoctorResults(results: CheckResult[], exitCode: number): void;