@browserflow-ai/cli 0.0.6

package/dist/commands/lint.js

@@ -0,0 +1,248 @@
+/**
+ * bf lint command - validates spec files against v2 schema
+ * @see bf-eq4
+ */
+import { Command } from 'commander';
+import { readFile, readdir, access } from 'node:fs/promises';
+import { join, relative, resolve } from 'node:path';
+import { parse as parseYaml, LineCounter, parseDocument } from 'yaml';
+import { specSchema } from '@browserflow-ai/core';
+import { colors, symbols } from '../ui/colors.js';
+import { logHeader, logNewline } from '../ui/prompts.js';
+/**
+ * Get line number for a path in YAML content
+ */
+export function getLineNumber(content, path) {
+    try {
+        const lineCounter = new LineCounter();
+        const doc = parseDocument(content, { lineCounter });
+        if (!doc.contents) {
+            return 1;
+        }
+        // Cast to any to use getIn method - the yaml library types are complex
+        const contents = doc.contents;
+        if (!('getIn' in contents)) {
+            return 1;
+        }
+        // Use getIn with keepScalar=true to get the actual node
+        const node = contents.getIn(path, true);
+        if (node && typeof node === 'object' && 'range' in node) {
+            const range = node.range;
+            if (range && range[0] !== undefined) {
+                const pos = lineCounter.linePos(range[0]);
+                return pos.line;
+            }
+        }
+        // If we can't find the exact node, try to find the parent
+        // This helps when the property doesn't exist (e.g., missing 'id')
+        if (path.length > 0) {
+            const parentPath = path.slice(0, -1);
+            const parentNode = contents.getIn(parentPath, true);
+            if (parentNode && typeof parentNode === 'object' && 'range' in parentNode) {
+                const range = parentNode.range;
+                if (range && range[0] !== undefined) {
+                    const pos = lineCounter.linePos(range[0]);
+                    return pos.line;
+                }
+            }
+        }
+        return 1;
+    }
+    catch {
+        return 1;
+    }
+}
+/**
+ * Format lint error with actionable message
+ */
+export function formatLintError(error) {
+    const { path, message, value } = error;
+    let actionableMessage = message;
+    // Make messages actionable based on error type
+    if (path.includes('id') && (message.toLowerCase().includes('required') || message.toLowerCase().includes('invalid'))) {
+        actionableMessage = "Step id is required - add 'id: unique_step_id' to this step";
+    }
+    else if (path.includes('timeout') || path.includes('duration')) {
+        if (value !== undefined) {
+            actionableMessage = `Invalid duration "${value}" - use format like "3s", "2m", or "500ms"`;
+        }
+        else if (message.toLowerCase().includes('duration')) {
+            actionableMessage = message;
+        }
+    }
+    else if (message.toLowerCase().includes('unique')) {
+        actionableMessage = 'Step IDs must be unique within spec - rename duplicate step IDs';
+    }
+    else if (message.toLowerCase().includes('kebab-case')) {
+        if (value !== undefined) {
+            actionableMessage = `Name "${value}" must be kebab-case (lowercase letters, numbers, and hyphens only)`;
+        }
+        else {
+            actionableMessage = 'Name must be kebab-case (lowercase letters, numbers, and hyphens only)';
+        }
+    }
+    return {
+        ...error,
+        message: actionableMessage,
+    };
+}
+/**
+ * Lint a single spec file content
+ */
+export function lintSpec(content, filename) {
+    const errors = [];
+    // Try to parse YAML
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch (e) {
+        const error = e;
+        errors.push({
+            path: '',
+            message: `YAML syntax error: ${error.message}`,
+            line: 1,
+        });
+        return { file: filename, errors };
+    }
+    // Validate against schema
+    const validation = specSchema.safeParse(parsed);
+    if (!validation.success) {
+        for (const issue of validation.error.issues) {
+            const path = issue.path.join('.');
+            const line = getLineNumber(content, issue.path);
+            // Get the value at this path for context
+            let value;
+            try {
+                let current = parsed;
+                for (const segment of issue.path) {
+                    if (current && typeof current === 'object') {
+                        current = current[segment];
+                    }
+                }
+                value = current;
+            }
+            catch {
+                // Ignore errors getting value
+            }
+            const error = {
+                path,
+                message: issue.message,
+                line,
+                value: typeof value === 'string' || typeof value === 'number' ? value : undefined,
+            };
+            errors.push(formatLintError(error));
+        }
+    }
+    return { file: filename, errors };
+}
+/**
+ * Lint multiple spec files
+ */
+export async function lintFiles(files, options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const results = [];
+    // If no files specified, find all yaml files in specs/
+    let targetFiles = files;
+    if (targetFiles.length === 0) {
+        try {
+            const specsDir = join(cwd, 'specs');
+            await access(specsDir);
+            const entries = await readdir(specsDir);
+            targetFiles = entries
+                .filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'))
+                .map((f) => join(specsDir, f));
+        }
+        catch {
+            // specs/ doesn't exist
+            return [];
+        }
+    }
+    // Lint each file
+    for (const file of targetFiles) {
+        const filePath = resolve(cwd, file);
+        const displayPath = relative(cwd, filePath);
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const result = lintSpec(content, displayPath);
+            results.push(result);
+        }
+        catch (e) {
+            const error = e;
+            results.push({
+                file: displayPath,
+                errors: [
+                    {
+                        path: '',
+                        message: error.code === 'ENOENT' ? 'File not found' : error.message,
+                        line: 1,
+                    },
+                ],
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Print lint results to console
+ */
+function printResults(results) {
+    let totalPassed = 0;
+    let totalFailed = 0;
+    let totalErrors = 0;
+    for (const result of results) {
+        if (result.errors.length === 0) {
+            console.log(`${symbols.pass} ${result.file}`);
+            totalPassed++;
+        }
+        else {
+            console.log(`${symbols.fail} ${result.file}`);
+            totalFailed++;
+            totalErrors += result.errors.length;
+            for (const error of result.errors) {
+                console.log(`  ${colors.dim(`Line ${error.line}:`)} ${error.message}`);
+                if (error.path) {
+                    console.log(`    ${colors.dim('at')} ${colors.code(error.path)}`);
+                }
+            }
+        }
+    }
+    logNewline();
+    const parts = [];
+    if (totalPassed > 0)
+        parts.push(colors.pass(`${totalPassed} passed`));
+    if (totalFailed > 0)
+        parts.push(colors.fail(`${totalFailed} failed`));
+    if (totalErrors > 0)
+        parts.push(`(${totalErrors} error${totalErrors > 1 ? 's' : ''})`);
+    console.log(parts.join(', '));
+}
+export function lintCommand() {
+    const cmd = new Command('lint');
+    cmd
+        .description('Validate BrowserFlow spec files')
+        .argument('[specs...]', 'Spec files or directories to lint')
+        .option('--fix', 'Attempt to fix issues automatically')
+        .action(async (specs, options) => {
+        logHeader('Linting specs');
+        logNewline();
+        const targetDir = specs.length > 0 ? undefined : 'specs/*.yaml';
+        if (specs.length === 0) {
+            console.log(colors.dim(`Linting ${targetDir}`));
+            logNewline();
+        }
+        const results = await lintFiles(specs, options);
+        if (results.length === 0) {
+            console.log(colors.dim('No spec files found.'));
+            return;
+        }
+        printResults(results);
+        // Exit code 3 for validation failure (per spec)
+        const hasErrors = results.some((r) => r.errors.length > 0);
+        if (hasErrors) {
+            process.exitCode = 3;
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/repair.d.ts

@@ -0,0 +1,72 @@
+/**
+ * bf repair command - fix broken tests using failure bundles
+ * @see bf-mtk
+ */
+import { Command } from 'commander';
+export type ErrorType = 'locator_not_found' | 'timeout' | 'assertion_failed' | 'screenshot_diff' | 'unknown';
+export interface FailureBundle {
+    run_id: string;
+    spec_name: string;
+    failed_at: string;
+    failure: {
+        step_id: string;
+        action: string;
+        error_message: string;
+        error_type: ErrorType;
+    };
+    context: {
+        url: string;
+        viewport: {
+            width: number;
+            height: number;
+        };
+        browser: string;
+    };
+    artifacts: {
+        trace?: string;
+        video?: string;
+        screenshot?: string;
+        diff?: {
+            baseline: string;
+            actual: string;
+            diff: string;
+        };
+        console_log?: string;
+        network_log?: string;
+    };
+    suggestions?: RepairSuggestion[];
+}
+export interface RepairSuggestion {
+    type: 'use_fallback' | 'increase_timeout' | 'update_baseline' | 'add_mask' | 'fix_assertion' | 'investigate';
+    description: string;
+    confidence: number;
+    patch?: Record<string, unknown>;
+}
+export interface RepairPlan {
+    suggestions: RepairSuggestion[];
+    primarySuggestion: RepairSuggestion;
+    autoApplicable: boolean;
+    requiresConfirmation: boolean;
+}
+export interface RepairOptions {
+    spec?: string;
+    fromRun?: string;
+    ai?: boolean;
+    apply?: boolean;
+    headed?: boolean;
+    cwd?: string;
+}
+/**
+ * Load failure bundle from a run directory or failure.json path
+ */
+export declare function loadFailureBundle(pathOrRunDir: string): Promise<FailureBundle>;
+/**
+ * Analyze a failure and generate deterministic repair suggestions
+ */
+export declare function analyzeFailure(bundle: FailureBundle): RepairSuggestion[];
+/**
+ * Generate a repair plan from suggestions
+ */
+export declare function generateRepairPlan(suggestions: RepairSuggestion[]): RepairPlan;
+export declare function repairCommand(): Command;
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/commands/repair.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,MAAM,SAAS,GAAG,mBAAmB,GAAG,SAAS,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE7G,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,SAAS,CAAC;KACvB,CAAC;IAEF,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBpF;AAsCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAyExE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,UAAU,CAc9E;AA6CD,wBAAgB,aAAa,IAAI,OAAO,CA4FvC"}

package/dist/commands/repair.js

@@ -0,0 +1,271 @@
+/**
+ * bf repair command - fix broken tests using failure bundles
+ * @see bf-mtk
+ */
+import { Command } from 'commander';
+import { readFile, access, readdir } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { colors, symbols } from '../ui/colors.js';
+import { logHeader, logNewline, logSuccess, logWarning, logError } from '../ui/prompts.js';
+const BROWSERFLOW_DIR = '.browserflow';
+const RUNS_DIR = 'runs';
+/**
+ * Load failure bundle from a run directory or failure.json path
+ */
+export async function loadFailureBundle(pathOrRunDir) {
+    let failurePath;
+    // Check if path is a failure.json file or a directory
+    if (pathOrRunDir.endsWith('failure.json')) {
+        failurePath = pathOrRunDir;
+    }
+    else {
+        failurePath = join(pathOrRunDir, 'failure.json');
+    }
+    try {
+        await access(failurePath);
+        const content = await readFile(failurePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === 'ENOENT') {
+            throw new Error(`Failure bundle not found: ${failurePath}`);
+        }
+        throw e;
+    }
+}
+/**
+ * Find the latest failure for a spec
+ */
+async function findLatestFailure(specName, cwd = process.cwd()) {
+    const runsDir = join(cwd, BROWSERFLOW_DIR, RUNS_DIR, '_execution');
+    try {
+        await access(runsDir);
+        const entries = await readdir(runsDir);
+        const runDirs = entries
+            .filter((e) => e.startsWith('run-'))
+            .sort()
+            .reverse();
+        // Check each run for a failure.json
+        for (const runDir of runDirs) {
+            const failurePath = join(runsDir, runDir, 'failure.json');
+            try {
+                await access(failurePath);
+                const content = await readFile(failurePath, 'utf-8');
+                const bundle = JSON.parse(content);
+                if (!specName || bundle.spec_name === specName) {
+                    return join(runsDir, runDir);
+                }
+            }
+            catch {
+                // No failure.json in this run
+                continue;
+            }
+        }
+    }
+    catch {
+        // Runs directory doesn't exist
+    }
+    return null;
+}
+/**
+ * Analyze a failure and generate deterministic repair suggestions
+ */
+export function analyzeFailure(bundle) {
+    const suggestions = [];
+    const { failure } = bundle;
+    switch (failure.error_type) {
+        case 'locator_not_found':
+            suggestions.push({
+                type: 'use_fallback',
+                description: 'Try fallback locator strategy',
+                confidence: 0.7,
+                patch: { use_fallback: true },
+            });
+            suggestions.push({
+                type: 'investigate',
+                description: 'Check if page structure has changed',
+                confidence: 0.5,
+            });
+            break;
+        case 'timeout':
+            suggestions.push({
+                type: 'increase_timeout',
+                description: 'Double the timeout duration',
+                confidence: 0.8,
+                patch: { timeout_multiplier: 2 },
+            });
+            suggestions.push({
+                type: 'investigate',
+                description: 'Check for slow network or page load issues',
+                confidence: 0.4,
+            });
+            break;
+        case 'assertion_failed':
+            suggestions.push({
+                type: 'fix_assertion',
+                description: 'Review and update the expected value',
+                confidence: 0.5,
+            });
+            suggestions.push({
+                type: 'investigate',
+                description: 'Verify the application behavior is correct',
+                confidence: 0.6,
+            });
+            break;
+        case 'screenshot_diff':
+            suggestions.push({
+                type: 'update_baseline',
+                description: 'Accept the new screenshot as baseline',
+                confidence: 0.6,
+            });
+            suggestions.push({
+                type: 'add_mask',
+                description: 'Add mask for dynamic content area',
+                confidence: 0.7,
+            });
+            suggestions.push({
+                type: 'investigate',
+                description: 'Verify visual change is intentional',
+                confidence: 0.5,
+            });
+            break;
+        default:
+            suggestions.push({
+                type: 'investigate',
+                description: 'Review error details and stack trace',
+                confidence: 0.3,
+            });
+    }
+    return suggestions;
+}
+/**
+ * Generate a repair plan from suggestions
+ */
+export function generateRepairPlan(suggestions) {
+    // Sort by confidence descending
+    const sorted = [...suggestions].sort((a, b) => b.confidence - a.confidence);
+    const primarySuggestion = sorted[0];
+    const autoApplicable = primarySuggestion.confidence >= 0.9;
+    const requiresConfirmation = !autoApplicable;
+    return {
+        suggestions: sorted,
+        primarySuggestion,
+        autoApplicable,
+        requiresConfirmation,
+    };
+}
+/**
+ * Print failure information
+ */
+function printFailureInfo(bundle) {
+    console.log(`${colors.bold('Spec:')} ${bundle.spec_name}`);
+    console.log(`${colors.bold('Failed step:')} ${bundle.failure.step_id} (${bundle.failure.action})`);
+    console.log(`${colors.bold('Error type:')} ${bundle.failure.error_type}`);
+    console.log(`${colors.bold('Message:')} ${bundle.failure.error_message}`);
+    logNewline();
+    console.log(`${colors.bold('Context:')}`);
+    console.log(`  URL: ${bundle.context.url}`);
+    console.log(`  Viewport: ${bundle.context.viewport.width}x${bundle.context.viewport.height}`);
+    console.log(`  Browser: ${bundle.context.browser}`);
+}
+/**
+ * Print repair suggestions
+ */
+function printSuggestions(plan) {
+    console.log(colors.bold('Repair suggestions:'));
+    logNewline();
+    for (let i = 0; i < plan.suggestions.length; i++) {
+        const suggestion = plan.suggestions[i];
+        const confidencePercent = Math.round(suggestion.confidence * 100);
+        const confidenceColor = suggestion.confidence >= 0.7 ? colors.pass : suggestion.confidence >= 0.5 ? colors.warning : colors.dim;
+        const isPrimary = i === 0;
+        const prefix = isPrimary ? symbols.arrow : symbols.bullet;
+        console.log(`${prefix} ${suggestion.description} ${confidenceColor(`(${confidencePercent}% confidence)`)}`);
+        console.log(`  ${colors.dim(`Type: ${suggestion.type}`)}`);
+    }
+    if (plan.autoApplicable) {
+        logNewline();
+        console.log(colors.pass('Primary suggestion can be auto-applied with --apply flag.'));
+    }
+}
+export function repairCommand() {
+    const cmd = new Command('repair');
+    cmd
+        .description('Fix broken tests using failure bundles')
+        .option('-s, --spec <name>', 'Repair specific spec')
+        .option('--from-run <path>', 'Path to failure.json or run directory')
+        .option('--ai', 'Enable AI-assisted repair suggestions')
+        .option('--apply', 'Auto-apply the highest confidence suggestion')
+        .option('--headed', 'Show browser during repair verification')
+        .action(async (options) => {
+        logHeader('Repair Test');
+        logNewline();
+        const cwd = options.cwd || process.cwd();
+        // 1. Find or load failure bundle
+        let failurePath = null;
+        if (options.fromRun) {
+            failurePath = options.fromRun;
+        }
+        else {
+            failurePath = await findLatestFailure(options.spec || '', cwd);
+        }
+        if (!failurePath) {
+            logError('No failure bundle found.');
+            console.log(colors.dim('Run "bf run" first to generate test results.'));
+            process.exitCode = 1;
+            return;
+        }
+        // 2. Load failure bundle
+        let bundle;
+        try {
+            bundle = await loadFailureBundle(failurePath);
+        }
+        catch (e) {
+            logError(e.message);
+            process.exitCode = 1;
+            return;
+        }
+        // 3. Display failure info
+        printFailureInfo(bundle);
+        logNewline();
+        // 4. Analyze and generate suggestions
+        const suggestions = analyzeFailure(bundle);
+        // 5. (Optional) AI suggestions
+        if (options.ai) {
+            logWarning('AI-assisted repair not yet implemented. Using deterministic suggestions only.');
+            // In a real implementation, we would call an AI service here
+        }
+        // 6. Generate repair plan
+        if (suggestions.length === 0) {
+            console.log(colors.dim('No automatic repair suggestions available.'));
+            console.log('Manual intervention may be required.');
+            return;
+        }
+        const plan = generateRepairPlan(suggestions);
+        // 7. Print suggestions
+        printSuggestions(plan);
+        // 8. Apply if requested
+        if (options.apply) {
+            logNewline();
+            if (plan.autoApplicable) {
+                logSuccess(`Applying: ${plan.primarySuggestion.description}`);
+                console.log(colors.dim('(Repair application not yet implemented)'));
+                // In a real implementation:
+                // - Apply the patch to the lockfile/spec
+                // - Regenerate the test
+                // - Run verification
+            }
+            else {
+                logWarning('Primary suggestion has low confidence. Please review and apply manually.');
+                console.log(colors.dim(`Confidence: ${Math.round(plan.primarySuggestion.confidence * 100)}% (requires 90%+ for auto-apply)`));
+            }
+        }
+        else {
+            logNewline();
+            console.log(colors.dim('Run with --apply to auto-apply the primary suggestion.'));
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=repair.js.map

package/dist/commands/repair.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,26 @@
+/**
+ * bf review command - start review server for exploration approval
+ * @see bf-kqu
+ */
+import { Command } from 'commander';
+/**
+ * Load exploration data from disk
+ */
+export declare function loadExploration(id: string, cwd?: string): Promise<unknown>;
+/**
+ * Save review data to disk
+ */
+export declare function saveReview(id: string, reviewData: unknown, cwd?: string): Promise<string>;
+/**
+ * List all available explorations
+ */
+export declare function listExplorations(cwd?: string): Promise<string[]>;
+/**
+ * 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 declare function serveStaticUI(pathname: string, cwd?: string): Promise<Response>;
+export declare function reviewCommand(): Command;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB/F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9G;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAarF;AAoFD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwDrF;AAmCD,wBAAgB,aAAa,IAAI,OAAO,CAmMvC"}