@browserflow-ai/cli 0.0.6

package/dist/commands/doctor.js

@@ -0,0 +1,230 @@
+import { Command } from 'commander';
+import { exec as execCallback } from 'node:child_process';
+import { promisify } from 'node:util';
+import { access, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createServer } from 'node:net';
+import { parse as parseYaml } from 'yaml';
+import { logSuccess, logError, logWarning, logHeader, logNewline } from '../ui/prompts.js';
+import { colors } from '../ui/colors.js';
+const exec = promisify(execCallback);
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port, '127.0.0.1');
+    });
+}
+export async function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1));
+    if (major >= 18) {
+        return { status: 'pass', message: `Node.js ${version}` };
+    }
+    return {
+        status: 'fail',
+        message: `Node.js ${version} (need >=18)`,
+        fixHint: 'Install Node.js 18+ from https://nodejs.org',
+    };
+}
+export async function checkAgentBrowser() {
+    try {
+        const { stdout } = await exec('agent-browser --version');
+        const version = stdout.trim();
+        // Handle version with or without 'v' prefix
+        const displayVersion = version.startsWith('v') ? version : `v${version}`;
+        return { status: 'pass', message: displayVersion };
+    }
+    catch {
+        return {
+            status: 'fail',
+            message: 'Not installed',
+            fixHint: 'Run: bun add -g agent-browser',
+        };
+    }
+}
+export async function checkPlaywrightBrowsers() {
+    try {
+        // Get playwright version
+        const { stdout: versionOutput } = await exec('bunx playwright --version');
+        const version = versionOutput.trim();
+        // Check if chromium is installed using --list
+        try {
+            const { stdout: listOutput } = await exec('bunx playwright install --list');
+            // Check if chromium is listed in the browsers section
+            if (listOutput.includes('chromium-')) {
+                return { status: 'pass', message: `Installed (Playwright ${version})` };
+            }
+            return {
+                status: 'warn',
+                message: `Playwright ${version} (chromium not installed)`,
+                fixHint: 'Run: bunx playwright install chromium',
+            };
+        }
+        catch {
+            return {
+                status: 'warn',
+                message: `Playwright ${version} (browsers may need install)`,
+                fixHint: 'Run: bunx playwright install chromium',
+            };
+        }
+    }
+    catch {
+        return {
+            status: 'fail',
+            message: 'Not installed',
+            fixHint: 'Run: bunx playwright install chromium',
+        };
+    }
+}
+async function loadConfig() {
+    const configPath = join(process.cwd(), 'browserflow.yaml');
+    if (!(await fileExists(configPath))) {
+        return { config: null, error: 'No browserflow.yaml' };
+    }
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        const config = parseYaml(content);
+        return { config };
+    }
+    catch (err) {
+        return { config: null, error: `Invalid YAML: ${err.message}` };
+    }
+}
+export async function checkConfiguration() {
+    const { config, error } = await loadConfig();
+    if (!config) {
+        return {
+            status: 'fail',
+            message: error ?? 'No browserflow.yaml',
+            fixHint: 'Run: bf init',
+        };
+    }
+    return { status: 'pass', message: 'Valid' };
+}
+export async function checkReviewPort() {
+    const { config } = await loadConfig();
+    const port = config?.review?.port ?? 8190;
+    if (await isPortAvailable(port)) {
+        return { status: 'pass', message: `Port ${port} available` };
+    }
+    return {
+        status: 'warn',
+        message: `Port ${port} in use`,
+        fixHint: 'Change review.port in browserflow.yaml',
+    };
+}
+function createDefaultChecks() {
+    return [
+        { name: 'Node.js version', check: checkNodeVersion },
+        { name: 'agent-browser', check: checkAgentBrowser },
+        { name: 'Playwright browsers', check: checkPlaywrightBrowsers },
+        { name: 'Configuration', check: checkConfiguration },
+        { name: 'Review port', check: checkReviewPort },
+    ];
+}
+export function createMockChecks(options = {}) {
+    if (options.allPass) {
+        return [
+            { name: 'Node.js version', check: async () => ({ status: 'pass', message: 'v20.0.0' }) },
+            { name: 'agent-browser', check: async () => ({ status: 'pass', message: 'v0.5.0' }) },
+            { name: 'Playwright browsers', check: async () => ({ status: 'pass', message: 'Installed' }) },
+            { name: 'Configuration', check: async () => ({ status: 'pass', message: 'Valid' }) },
+            { name: 'Review port', check: async () => ({ status: 'pass', message: 'Port 8190 available' }) },
+        ];
+    }
+    return createDefaultChecks();
+}
+export async function runDoctor(options, checks = createDefaultChecks()) {
+    const checkOutputs = [];
+    for (const check of checks) {
+        const result = await check.check();
+        checkOutputs.push({ name: check.name, result });
+        // Attempt fix if requested and available
+        if (options.fix && result.status === 'fail' && check.fix) {
+            try {
+                await check.fix();
+                // Re-run check after fix
+                const newResult = await check.check();
+                checkOutputs[checkOutputs.length - 1].result = newResult;
+            }
+            catch {
+                // Fix failed, keep original result
+            }
+        }
+    }
+    const summary = {
+        passed: checkOutputs.filter(c => c.result.status === 'pass').length,
+        warnings: checkOutputs.filter(c => c.result.status === 'warn').length,
+        failed: checkOutputs.filter(c => c.result.status === 'fail').length,
+    };
+    // Exit code: 0 for all pass, 0 for warnings only, 1 for any failures
+    const exitCode = summary.failed > 0 ? 1 : 0;
+    return { checks: checkOutputs, summary, exitCode };
+}
+function formatCheckOutput(check) {
+    const { name, result } = check;
+    const paddedName = name.padEnd(20);
+    switch (result.status) {
+        case 'pass':
+            logSuccess(`${paddedName} ${result.message}`);
+            break;
+        case 'warn':
+            logWarning(`${paddedName} ${result.message}`);
+            if (result.fixHint) {
+                console.log(`    ${colors.dim('→')} ${result.fixHint}`);
+            }
+            break;
+        case 'fail':
+            logError(`${paddedName} ${result.message}`);
+            if (result.fixHint) {
+                console.log(`    ${colors.dim('→')} ${result.fixHint}`);
+            }
+            break;
+    }
+}
+export function doctorCommand() {
+    const cmd = new Command('doctor');
+    cmd
+        .description('Check environment and dependencies')
+        .option('-v, --verbose', 'Show detailed output')
+        .option('--fix', 'Attempt to fix issues automatically')
+        .action(async (options) => {
+        logHeader('BrowserFlow Doctor');
+        logNewline();
+        const result = await runDoctor(options);
+        for (const check of result.checks) {
+            formatCheckOutput(check);
+        }
+        logNewline();
+        const { passed, warnings, failed } = result.summary;
+        const parts = [];
+        if (passed > 0)
+            parts.push(colors.pass(`${passed} passed`));
+        if (warnings > 0)
+            parts.push(colors.warning(`${warnings} warning${warnings > 1 ? 's' : ''}`));
+        if (failed > 0)
+            parts.push(colors.fail(`${failed} failed`));
+        console.log(parts.join(', '));
+        if (failed > 0 && !options.fix) {
+            logNewline();
+            console.log(colors.dim('Run bf doctor --fix to attempt automatic fixes.'));
+        }
+        process.exitCode = result.exitCode;
+    });
+    return cmd;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/explore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * bf explore command - runs AI exploration for a spec
+ * @see bf-x9t
+ */
+import { Command } from 'commander';
+import type { BrowserFlowSpec } from '@browserflow-ai/core';
+/**
+ * Load and validate a spec file
+ */
+export declare function loadAndValidateSpec(specName: string, cwd?: string): Promise<BrowserFlowSpec>;
+export declare function exploreCommand(): Command;
+//# sourceMappingURL=explore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../src/commands/explore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK5D;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmCjH;AA4BD,wBAAgB,cAAc,IAAI,OAAO,CAkDxC"}

package/dist/commands/explore.js

@@ -0,0 +1,114 @@
+/**
+ * bf explore command - runs AI exploration for a spec
+ * @see bf-x9t
+ */
+import { Command } from 'commander';
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { specSchema } from '@browserflow-ai/core';
+import { Explorer, ClaudeAdapter, ClaudeCliAdapter, createBrowserSession } from '@browserflow-ai/exploration';
+import { colors } from '../ui/colors.js';
+/**
+ * Load and validate a spec file
+ */
+export async function loadAndValidateSpec(specName, cwd = process.cwd()) {
+    const specPath = join(cwd, 'specs', `${specName}.yaml`);
+    // Read file
+    let content;
+    try {
+        content = await readFile(specPath, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            throw new Error(`Spec file not found: ${specPath}`);
+        }
+        throw error;
+    }
+    // Parse YAML
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`YAML syntax error: ${err.message}`);
+    }
+    // Validate against schema
+    const validation = specSchema.safeParse(parsed);
+    if (!validation.success) {
+        const issues = validation.error.issues.map((issue) => {
+            const path = issue.path.join('.');
+            return `  - ${path}: ${issue.message}`;
+        }).join('\n');
+        throw new Error(`Spec validation failed:\n${issues}`);
+    }
+    return validation.data;
+}
+/**
+ * Write exploration output to disk
+ */
+async function writeExplorationOutput(result) {
+    const outputDir = join('.browserflow', 'explorations', result.explorationId);
+    await mkdir(outputDir, { recursive: true });
+    await writeFile(join(outputDir, 'exploration.json'), JSON.stringify(result, null, 2));
+}
+/**
+ * Create an AI adapter based on the adapter name
+ */
+function createAdapter(adapterName) {
+    switch (adapterName) {
+        case 'claude':
+            return new ClaudeAdapter();
+        case 'claude-cli':
+            return new ClaudeCliAdapter();
+        default:
+            throw new Error(`Unknown adapter: ${adapterName}. Available: claude, claude-cli`);
+    }
+}
+export function exploreCommand() {
+    const cmd = new Command('explore');
+    cmd
+        .description('Run AI exploration for a spec')
+        .requiredOption('--spec <name>', 'Spec name to explore')
+        .option('--url <url>', 'Base URL (overrides config)')
+        .option('--headed', 'Run browser in headed mode')
+        .option('--adapter <name>', 'AI adapter: claude (SDK), claude-cli (CLI)', 'claude')
+        .action(async (options) => {
+        try {
+            // 1. Load and validate spec
+            const spec = await loadAndValidateSpec(options.spec);
+            // 2. Determine base URL
+            const baseUrl = options.url || 'http://localhost:3000';
+            // 3. Create browser session and AI adapter
+            const browser = createBrowserSession();
+            const adapter = createAdapter(options.adapter);
+            // 4. Create explorer
+            const explorer = new Explorer({
+                adapter,
+                browser,
+                headless: !options.headed,
+                outputDir: '.browserflow/explorations',
+            });
+            // 5. Run exploration
+            console.log(colors.dim(`Running exploration for ${spec.name}...`));
+            const result = await explorer.runExploration(spec, baseUrl, {
+                specPath: `specs/${options.spec}.yaml`,
+                headless: !options.headed,
+            });
+            // 6. Write exploration output
+            await writeExplorationOutput(result);
+            // 7. Print summary
+            console.log(colors.success(`Exploration complete: ${result.explorationId}`));
+            console.log(`Run \`bf review --exploration ${result.explorationId}\` to review`);
+        }
+        catch (error) {
+            const err = error;
+            console.error(colors.fail(err.message));
+            process.exitCode = 1;
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=explore.js.map

package/dist/commands/explore.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+export declare const DEFAULT_CONFIG = "project:\n  name: my-project\n  base_url: http://localhost:3000\n\nruntime:\n  browser: chromium\n  headless: true\n  viewport:\n    width: 1280\n    height: 720\n  timeout: 30s\n\nlocators:\n  prefer_testid: true\n  testid_attributes:\n    - data-testid\n    - data-test\n\nexploration:\n  adapter: claude\n  max_retries: 3\n\nreview:\n  port: 8190\n  auto_open: true\n\noutput:\n  tests_dir: e2e/tests\n  baselines_dir: baselines\n";
+export declare const EXAMPLE_SPEC = "version: 2\nname: example\ndescription: Example spec - customize for your app\n\nsteps:\n  - id: visit_home\n    action: navigate\n    url: /\n\n  - id: homepage_screenshot\n    action: screenshot\n    name: homepage\n\ntags:\n  - example\n  - smoke\n";
+export interface InitOptions {
+    force?: boolean;
+    example?: boolean;
+}
+export interface InitResult {
+    created: string[];
+    updated: string[];
+    skipped: string[];
+}
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+export declare function initCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,cAAc,sbA6B1B,CAAC;AAEF,eAAO,MAAM,YAAY,gQAgBxB,CAAC;AAIF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA2CD,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAyCvE;AAED,wBAAgB,WAAW,IAAI,OAAO,CAuCrC"}

package/dist/commands/init.js

@@ -0,0 +1,160 @@
+import { Command } from 'commander';
+import { mkdir, writeFile, readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { logSuccess, logWarning, logHeader, logNewline, logInfo } from '../ui/prompts.js';
+import { colors } from '../ui/colors.js';
+export const DEFAULT_CONFIG = `project:
+  name: my-project
+  base_url: http://localhost:3000
+
+runtime:
+  browser: chromium
+  headless: true
+  viewport:
+    width: 1280
+    height: 720
+  timeout: 30s
+
+locators:
+  prefer_testid: true
+  testid_attributes:
+    - data-testid
+    - data-test
+
+exploration:
+  adapter: claude
+  max_retries: 3
+
+review:
+  port: 8190
+  auto_open: true
+
+output:
+  tests_dir: e2e/tests
+  baselines_dir: baselines
+`;
+export const EXAMPLE_SPEC = `version: 2
+name: example
+description: Example spec - customize for your app
+
+steps:
+  - id: visit_home
+    action: navigate
+    url: /
+
+  - id: homepage_screenshot
+    action: screenshot
+    name: homepage
+
+tags:
+  - example
+  - smoke
+`;
+const GITIGNORE_ENTRIES = ['.browserflow/', 'node_modules/'];
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function appendToGitignore(entries) {
+    const gitignorePath = join(process.cwd(), '.gitignore');
+    let existingContent = '';
+    const added = [];
+    try {
+        existingContent = await readFile(gitignorePath, 'utf-8');
+    }
+    catch {
+        // File doesn't exist yet
+    }
+    const existingLines = new Set(existingContent.split('\n').map(l => l.trim()));
+    const toAdd = [];
+    for (const entry of entries) {
+        if (!existingLines.has(entry)) {
+            toAdd.push(entry);
+            added.push(entry);
+        }
+    }
+    if (toAdd.length > 0) {
+        const newContent = existingContent
+            ? existingContent.trimEnd() + '\n' + toAdd.join('\n') + '\n'
+            : toAdd.join('\n') + '\n';
+        await writeFile(gitignorePath, newContent);
+        return { updated: true, added };
+    }
+    return { updated: false, added: [] };
+}
+export async function runInit(options) {
+    const result = {
+        created: [],
+        updated: [],
+        skipped: [],
+    };
+    // 1. Create browserflow.yaml
+    const configPath = join(process.cwd(), 'browserflow.yaml');
+    const configExists = await fileExists(configPath);
+    if (!configExists || options.force) {
+        await writeFile(configPath, DEFAULT_CONFIG);
+        result.created.push('browserflow.yaml');
+    }
+    else {
+        result.skipped.push('browserflow.yaml');
+    }
+    // 2. Create specs/ directory
+    const specsDir = join(process.cwd(), 'specs');
+    const specsDirExists = await fileExists(specsDir);
+    if (!specsDirExists) {
+        await mkdir(specsDir, { recursive: true });
+        result.created.push('specs/');
+    }
+    // 3. Update .gitignore
+    const gitignoreResult = await appendToGitignore(GITIGNORE_ENTRIES);
+    if (gitignoreResult.updated) {
+        result.updated.push('.gitignore');
+    }
+    // 4. Create example spec (if --example)
+    if (options.example) {
+        const examplePath = join(specsDir, 'example.yaml');
+        await writeFile(examplePath, EXAMPLE_SPEC);
+        result.created.push('specs/example.yaml');
+    }
+    return result;
+}
+export function initCommand() {
+    const cmd = new Command('init');
+    cmd
+        .description('Initialize BrowserFlow in the current project')
+        .option('-f, --force', 'Overwrite existing configuration')
+        .option('--example', 'Create an example spec file')
+        .action(async (options) => {
+        logHeader('BrowserFlow Initialized!');
+        logNewline();
+        const result = await runInit(options);
+        if (result.created.length > 0 || result.updated.length > 0) {
+            console.log(colors.bold('Created:'));
+            for (const file of result.created) {
+                logSuccess(file);
+            }
+            for (const file of result.updated) {
+                logSuccess(`${file} (updated)`);
+            }
+            logNewline();
+        }
+        if (result.skipped.length > 0) {
+            console.log(colors.bold('Skipped (already exists):'));
+            for (const file of result.skipped) {
+                logWarning(`${file} - use --force to overwrite`);
+            }
+            logNewline();
+        }
+        console.log(colors.bold('Next steps:'));
+        logInfo('Edit browserflow.yaml with your project settings');
+        logInfo('Write specs in specs/ directory');
+        logInfo(`Run: ${colors.code('bf explore --spec <name>')}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/lint.d.ts

@@ -0,0 +1,37 @@
+/**
+ * bf lint command - validates spec files against v2 schema
+ * @see bf-eq4
+ */
+import { Command } from 'commander';
+export interface LintError {
+    path: string;
+    message: string;
+    line: number;
+    value?: unknown;
+}
+export interface LintResult {
+    file: string;
+    errors: LintError[];
+}
+export interface LintOptions {
+    fix?: boolean;
+    cwd?: string;
+}
+/**
+ * Get line number for a path in YAML content
+ */
+export declare function getLineNumber(content: string, path: (string | number)[]): number;
+/**
+ * Format lint error with actionable message
+ */
+export declare function formatLintError(error: LintError): LintError;
+/**
+ * Lint a single spec file content
+ */
+export declare function lintSpec(content: string, filename: string): LintResult;
+/**
+ * Lint multiple spec files
+ */
+export declare function lintFiles(files: string[], options?: LintOptions): Promise<LintResult[]>;
+export declare function lintCommand(): Command;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CA4ChF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CA2B3D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAmDtE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CA6CvB;AAqCD,wBAAgB,WAAW,IAAI,OAAO,CAkCrC"}