@browserflow-ai/cli 0.0.6

package/dist/commands/review.js

@@ -0,0 +1,371 @@
+/**
+ * bf review command - start review server for exploration approval
+ * @see bf-kqu
+ */
+import { Command } from 'commander';
+import { readFile, writeFile, readdir, access } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { colors } from '../ui/colors.js';
+/**
+ * Load exploration data from disk
+ */
+export async function loadExploration(id, cwd = process.cwd()) {
+    const explorationPath = join(cwd, '.browserflow', 'explorations', id, 'exploration.json');
+    try {
+        const content = await readFile(explorationPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            throw new Error(`Exploration not found: ${id}`);
+        }
+        if (err instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in exploration file: ${err.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Save review data to disk
+ */
+export async function saveReview(id, reviewData, cwd = process.cwd()) {
+    const reviewPath = join(cwd, '.browserflow', 'explorations', id, 'review.json');
+    await writeFile(reviewPath, JSON.stringify(reviewData, null, 2));
+    return reviewPath;
+}
+/**
+ * List all available explorations
+ */
+export async function listExplorations(cwd = process.cwd()) {
+    const explorationsDir = join(cwd, '.browserflow', 'explorations');
+    try {
+        const entries = await readdir(explorationsDir);
+        return entries.filter(e => e.startsWith('exp-'));
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+/**
+ * Get MIME type based on file extension
+ */
+function getMimeType(pathname) {
+    const ext = pathname.split('.').pop()?.toLowerCase();
+    const mimeTypes = {
+        'html': 'text/html',
+        'css': 'text/css',
+        'js': 'application/javascript',
+        'json': 'application/json',
+        'png': 'image/png',
+        'jpg': 'image/jpeg',
+        'jpeg': 'image/jpeg',
+        'gif': 'image/gif',
+        'svg': 'image/svg+xml',
+        'ico': 'image/x-icon',
+        'woff': 'font/woff',
+        'woff2': 'font/woff2',
+        'ttf': 'font/ttf',
+    };
+    return mimeTypes[ext || ''] || 'application/octet-stream';
+}
+/**
+ * Find the review-ui dist directory
+ * Checks multiple locations to support both development and installed package scenarios
+ * @param cwd Optional working directory for testing (used to find monorepo structure)
+ */
+async function findReviewUIDistDir(cwd) {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const workingDir = cwd || process.cwd();
+    // When cwd is explicitly provided (testing), check that first
+    if (cwd) {
+        const testPath = join(cwd, 'packages', 'review-ui', 'dist');
+        try {
+            await access(testPath);
+            return testPath;
+        }
+        catch {
+            // Fall through to other methods
+        }
+    }
+    // Try to find @browserflow-ai/review-ui package (for installed scenarios)
+    try {
+        const reviewUiPkgPath = await import.meta.resolve?.('@browserflow-ai/review-ui/package.json');
+        if (reviewUiPkgPath) {
+            const pkgDir = dirname(fileURLToPath(reviewUiPkgPath));
+            const distDir = join(pkgDir, 'dist');
+            await access(distDir);
+            return distDir;
+        }
+    }
+    catch {
+        // Package resolution failed, try filesystem paths
+    }
+    // Fallback: check filesystem locations
+    const candidates = [
+        // 1. Development: from repo root / cwd
+        join(workingDir, 'packages', 'review-ui', 'dist'),
+        // 2. Development: monorepo structure (running from source)
+        join(__dirname, '..', '..', '..', '..', 'review-ui', 'dist'),
+        // 3. Installed package: review-ui as sibling in node_modules
+        join(__dirname, '..', '..', '..', 'review-ui', 'dist'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Try next candidate
+        }
+    }
+    throw new Error('Review UI not found. If running from source, build it with: cd packages/review-ui && bun run build');
+}
+/**
+ * Serve static files from review-ui dist
+ * @param pathname The URL pathname to serve
+ * @param cwd Optional working directory for testing
+ * @internal Exported for testing
+ */
+export async function serveStaticUI(pathname, cwd) {
+    let distDir;
+    try {
+        distDir = await findReviewUIDistDir(cwd);
+    }
+    catch (error) {
+        return new Response(error.message, { status: 500 });
+    }
+    try {
+        // Serve index.html for root path
+        if (pathname === '/' || pathname === '/index.html') {
+            const indexPath = join(distDir, 'index.html');
+            const content = await readFile(indexPath, 'utf-8');
+            return new Response(content, {
+                headers: { 'Content-Type': 'text/html' },
+            });
+        }
+        // Try to serve static file from dist
+        // Remove leading slash from pathname
+        const filePath = join(distDir, pathname.slice(1));
+        // Check if file exists and is within distDir (prevent directory traversal)
+        if (!filePath.startsWith(distDir)) {
+            return new Response('Not Found', { status: 404 });
+        }
+        try {
+            const content = await readFile(filePath);
+            const mimeType = getMimeType(pathname);
+            return new Response(content, {
+                headers: { 'Content-Type': mimeType },
+            });
+        }
+        catch (error) {
+            const err = error;
+            // If file not found and it's not an /assets/ request, fallback to index.html for SPA routing
+            if (err.code === 'ENOENT' && !pathname.startsWith('/assets/')) {
+                const indexPath = join(distDir, 'index.html');
+                const content = await readFile(indexPath, 'utf-8');
+                return new Response(content, {
+                    headers: { 'Content-Type': 'text/html' },
+                });
+            }
+            // Return 404 for non-existent files in /assets/
+            return new Response('Not Found', { status: 404 });
+        }
+    }
+    catch (error) {
+        // If dist directory doesn't exist, return error
+        return new Response('Review UI not built. Run: cd packages/review-ui && bun run build', {
+            status: 500
+        });
+    }
+}
+/**
+ * Open browser to the review UI
+ */
+async function openBrowser(url) {
+    const { spawn } = await import('node:child_process');
+    // Use platform-appropriate command to open browser
+    const cmd = process.platform === 'darwin'
+        ? 'open'
+        : process.platform === 'win32'
+            ? 'cmd'
+            : 'xdg-open';
+    const args = process.platform === 'win32'
+        ? ['/c', 'start', url]
+        : [url];
+    try {
+        const child = spawn(cmd, args, {
+            detached: true,
+            stdio: 'ignore'
+        });
+        child.on('error', () => {
+            console.log(colors.dim(`Could not auto-open browser. Visit: ${url}`));
+        });
+        child.unref();
+    }
+    catch {
+        console.log(colors.dim(`Could not auto-open browser. Visit: ${url}`));
+    }
+}
+export function reviewCommand() {
+    return new Command('review')
+        .description('Start review server for exploration approval')
+        .option('--exploration <id>', 'Specific exploration ID to review')
+        .option('--port <port>', 'Server port', '8190')
+        .option('--no-open', "Don't auto-open browser")
+        .action(async (options) => {
+        const port = parseInt(options.port, 10);
+        const cwd = process.cwd();
+        try {
+            const server = Bun.serve({
+                port,
+                async fetch(req) {
+                    const url = new URL(req.url);
+                    // Serve exploration data
+                    if (url.pathname === '/api/exploration') {
+                        const id = url.searchParams.get('id') || options.exploration;
+                        if (!id) {
+                            // List available explorations
+                            const explorations = await listExplorations(cwd);
+                            return Response.json({ explorations });
+                        }
+                        try {
+                            const data = await loadExploration(id, cwd);
+                            return Response.json(data);
+                        }
+                        catch (error) {
+                            const err = error;
+                            return Response.json({ error: err.message }, { status: 404 });
+                        }
+                    }
+                    // Handle review submission (POST /api/reviews/:id)
+                    if (url.pathname.startsWith('/api/reviews/') && req.method === 'POST') {
+                        const id = url.pathname.split('/').pop() || '';
+                        if (!id) {
+                            return Response.json({ error: 'Exploration ID is required' }, { status: 400 });
+                        }
+                        try {
+                            const contentType = req.headers.get('content-type') || '';
+                            let reviewData;
+                            const screenshotBlobs = new Map();
+                            if (contentType.includes('multipart/form-data')) {
+                                // Parse multipart form data
+                                const formData = await req.formData();
+                                // Extract review JSON - can be string or File/Blob
+                                const reviewDataField = formData.get('review_data');
+                                let reviewDataStr;
+                                if (typeof reviewDataField === 'string') {
+                                    reviewDataStr = reviewDataField;
+                                }
+                                else if (reviewDataField instanceof Blob) {
+                                    // Handle case where it's sent as a file
+                                    reviewDataStr = await reviewDataField.text();
+                                }
+                                else {
+                                    throw new Error('Missing review_data in form submission');
+                                }
+                                try {
+                                    reviewData = JSON.parse(reviewDataStr);
+                                }
+                                catch (parseErr) {
+                                    throw new Error(`Failed to parse review_data JSON: ${parseErr.message}`);
+                                }
+                                // Extract screenshot blobs (step-N-review files)
+                                for (const [key, value] of formData.entries()) {
+                                    if (key.startsWith('step-') && key.endsWith('-review') && value instanceof Blob) {
+                                        screenshotBlobs.set(key, value);
+                                    }
+                                }
+                            }
+                            else {
+                                // Backwards compatibility: plain JSON
+                                reviewData = await req.json();
+                            }
+                            // Save review.json
+                            const reviewPath = await saveReview(id, reviewData, cwd);
+                            // Save annotated screenshots if any
+                            if (screenshotBlobs.size > 0) {
+                                const screenshotsDir = join(cwd, '.browserflow', 'explorations', id, 'screenshots');
+                                for (const [key, blob] of screenshotBlobs) {
+                                    // Extract step index from key (e.g., "step-2-review" -> "02")
+                                    const match = key.match(/^step-(\d+)-review$/);
+                                    if (match) {
+                                        const stepIndex = match[1];
+                                        const paddedIndex = stepIndex.padStart(2, '0');
+                                        const filename = `step-${paddedIndex}-review.png`;
+                                        const buffer = Buffer.from(await blob.arrayBuffer());
+                                        await writeFile(join(screenshotsDir, filename), buffer);
+                                    }
+                                }
+                            }
+                            return Response.json({ success: true }, {
+                                headers: {
+                                    'X-Review-Path': reviewPath
+                                }
+                            });
+                        }
+                        catch (error) {
+                            const err = error;
+                            return Response.json({ error: err.message }, { status: 500 });
+                        }
+                    }
+                    // Serve screenshots from explorations
+                    if (url.pathname.startsWith('/api/screenshots/')) {
+                        // Path format: /api/screenshots/{exp-id}/{filename}
+                        const pathParts = url.pathname.split('/').filter(Boolean);
+                        if (pathParts.length >= 4) {
+                            const expId = pathParts[2];
+                            const filename = pathParts.slice(3).join('/');
+                            // Prevent directory traversal
+                            if (filename.includes('..') || expId.includes('..')) {
+                                return new Response('Forbidden', { status: 403 });
+                            }
+                            const screenshotPath = join(cwd, '.browserflow', 'explorations', expId, 'screenshots', filename);
+                            // Ensure path is within the expected directory
+                            const expectedBase = join(cwd, '.browserflow', 'explorations', expId, 'screenshots');
+                            if (!screenshotPath.startsWith(expectedBase)) {
+                                return new Response('Forbidden', { status: 403 });
+                            }
+                            try {
+                                const content = await readFile(screenshotPath);
+                                const mimeType = getMimeType(filename);
+                                return new Response(content, {
+                                    headers: { 'Content-Type': mimeType },
+                                });
+                            }
+                            catch (error) {
+                                const err = error;
+                                if (err.code === 'ENOENT') {
+                                    return new Response('Screenshot not found', { status: 404 });
+                                }
+                                throw error;
+                            }
+                        }
+                        return new Response('Invalid screenshot path', { status: 400 });
+                    }
+                    // Serve static review UI
+                    return serveStaticUI(url.pathname);
+                },
+            });
+            console.log(colors.info(`Review server: http://localhost:${port}`));
+            if (options.open !== false) {
+                const explorationParam = options.exploration ? `?id=${options.exploration}` : '';
+                await openBrowser(`http://localhost:${port}${explorationParam}`);
+            }
+            console.log(colors.dim('Press Ctrl+C to stop'));
+            // Keep process alive
+            await new Promise(() => { });
+        }
+        catch (error) {
+            const err = error;
+            console.error(colors.fail(err.message));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+import type { RunOptions } from '../run/types.js';
+export declare function runCommand(): Command;
+export declare function run(options: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,UAAU,IAAI,OAAO,CA6BpC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC5D"}

package/dist/commands/run.js

@@ -0,0 +1,66 @@
+import { Command } from 'commander';
+import { basename } from 'node:path';
+import { createRunStore } from '@browserflow-ai/core';
+import { resolveSpecs, executePlaywright } from '../run/executor.js';
+import { collectResults, generateFailureBundles } from '../run/results.js';
+import { printRunHeader, printRunSummary, printError } from '../run/output.js';
+export function runCommand() {
+    const cmd = new Command('run');
+    cmd
+        .description('Run BrowserFlow tests via Playwright')
+        .argument('[specs...]', 'Spec files to run')
+        .option('-s, --spec <name>', 'Run specific spec by name')
+        .option('-t, --tag <tag>', 'Filter tests by tag')
+        .option('-p, --parallel <workers>', 'Number of parallel workers', parseInt)
+        .option('--headed', 'Run tests in headed browser mode')
+        .option('--trace <mode>', 'Trace mode: on, off, on-first-retry', 'off')
+        .action(async (specs, cmdOptions) => {
+        const options = {
+            spec: cmdOptions.spec ?? specs[0],
+            tag: cmdOptions.tag,
+            parallel: cmdOptions.parallel,
+            headed: cmdOptions.headed,
+            trace: cmdOptions.trace,
+        };
+        try {
+            await run(options);
+        }
+        catch (error) {
+            printError(error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+export async function run(options) {
+    const runStore = createRunStore(process.cwd());
+    // 1. Determine which specs to run
+    const specs = await resolveSpecs(options);
+    // 2. Print header
+    printRunHeader(specs);
+    // 3. Create run directory for this execution
+    // Extract spec name from first spec file path
+    // e.g., 'specs/login.spec.yaml' -> 'login.spec' or 'login'
+    let specName = '_execution'; // fallback
+    if (specs.length > 0) {
+        const specFile = basename(specs[0]);
+        // Remove .yaml/.yml extension if present
+        specName = specFile.replace(/\.(yaml|yml)$/, '');
+    }
+    const runDir = await runStore.createRun(specName);
+    // 4. Execute Playwright tests
+    const executorResult = await executePlaywright(specs, options, runDir);
+    // 5. Collect results and generate summary
+    const summary = await collectResults(runDir, executorResult);
+    // 6. Print human-friendly output
+    printRunSummary(summary);
+    // 7. If failures, generate failure bundles
+    if (summary.failed > 0) {
+        await generateFailureBundles(runDir, summary.failures);
+    }
+    // 8. Exit with appropriate code
+    if (summary.failed > 0) {
+        process.exit(5); // Exit code 5 for test failures as per spec
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+export declare function run(argv?: string[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,aAAa,IAAI,OAAO,CAkBvC;AAED,wBAAgB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAGzC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { doctorCommand } from './commands/doctor.js';
+import { lintCommand } from './commands/lint.js';
+import { runCommand } from './commands/run.js';
+import { baselineCommand } from './commands/baseline.js';
+import { repairCommand } from './commands/repair.js';
+import { exploreCommand } from './commands/explore.js';
+import { reviewCommand } from './commands/review.js';
+const VERSION = '0.0.1';
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('bf')
+        .description('BrowserFlow - Human-in-the-Loop E2E Test Generation')
+        .version(VERSION);
+    program.addCommand(initCommand());
+    program.addCommand(doctorCommand());
+    program.addCommand(lintCommand());
+    program.addCommand(runCommand());
+    program.addCommand(baselineCommand());
+    program.addCommand(repairCommand());
+    program.addCommand(exploreCommand());
+    program.addCommand(reviewCommand());
+    return program;
+}
+export function run(argv) {
+    const program = createProgram();
+    program.parse(argv);
+}
+// Run if this is the entry point
+if (import.meta.main) {
+    run();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,qDAAqD,CAAC;SAClE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;IAEpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAe;IACjC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,iCAAiC;AACjC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,GAAG,EAAE,CAAC;AACR,CAAC"}

package/dist/run/executor.d.ts

@@ -0,0 +1,10 @@
+import type { RunOptions } from './types.js';
+export interface ExecutorResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    jsonOutput?: unknown;
+}
+export declare function executePlaywright(specs: string[], options: RunOptions, runDir: string): Promise<ExecutorResult>;
+export declare function resolveSpecs(options: RunOptions): Promise<string[]>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/run/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/run/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAyDzB;AA8CD,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASzE"}

package/dist/run/executor.js

@@ -0,0 +1,95 @@
+import { spawn } from 'node:child_process';
+import * as path from 'node:path';
+export async function executePlaywright(specs, options, runDir) {
+    const args = buildPlaywrightArgs(specs, options, runDir);
+    return new Promise((resolve) => {
+        let stdout = '';
+        let stderr = '';
+        const child = spawn('bunx', ['playwright', 'test', ...args], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            cwd: process.cwd(),
+        });
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            let jsonOutput;
+            try {
+                // Parse JSON output from JSON reporter
+                // The entire stdout should be valid JSON when using --reporter json
+                if (stdout.trim()) {
+                    jsonOutput = JSON.parse(stdout.trim());
+                }
+            }
+            catch (error) {
+                // If JSON parsing fails, try to extract JSON object from mixed output
+                try {
+                    const jsonMatch = stdout.match(/\{[\s\S]*\}/);
+                    if (jsonMatch) {
+                        jsonOutput = JSON.parse(jsonMatch[0]);
+                    }
+                }
+                catch {
+                    // Ignore parse errors - jsonOutput will remain undefined
+                }
+            }
+            resolve({
+                exitCode: code ?? 1,
+                stdout,
+                stderr,
+                jsonOutput,
+            });
+        });
+        child.on('error', (err) => {
+            resolve({
+                exitCode: 1,
+                stdout,
+                stderr: stderr + '\n' + err.message,
+                jsonOutput: undefined,
+            });
+        });
+    });
+}
+function buildPlaywrightArgs(specs, options, runDir) {
+    const args = [];
+    // Config file (if exists)
+    args.push('--config', 'e2e/playwright.config.ts');
+    // Reporter - use JSON for structured output
+    args.push('--reporter', 'json');
+    // Output directory for artifacts
+    args.push('--output', path.join(runDir, 'artifacts'));
+    // Parallel workers
+    if (options.parallel !== undefined) {
+        args.push('--workers', String(options.parallel));
+    }
+    // Headed mode
+    if (options.headed) {
+        args.push('--headed');
+    }
+    // Trace mode
+    if (options.trace) {
+        args.push('--trace', options.trace);
+    }
+    // Tag filter (using Playwright's grep)
+    if (options.tag) {
+        args.push('--grep', `@${options.tag}`);
+    }
+    // Spec files
+    for (const spec of specs) {
+        args.push(`e2e/tests/${spec}.spec.ts`);
+    }
+    return args;
+}
+export async function resolveSpecs(options) {
+    // If specific spec provided, use it
+    if (options.spec) {
+        return [options.spec];
+    }
+    // Otherwise, run all specs by not filtering
+    // Playwright will run all files matching the config pattern
+    return [];
+}
+//# sourceMappingURL=executor.js.map

package/dist/run/executor.js.map

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