visor-ai 0.2.7 → 0.2.9

package/dist/cli.js

@@ -1,10 +1,11 @@
 import fs from 'node:fs';
 import { DEFAULT_SERVER_URL } from './adapters.js';
-import { DaemonRequestTimeoutError, DaemonUnavailableError, runDaemonAction, runDaemonScenario, startVisorDaemon, statusVisorDaemon, stopVisorDaemon } from './daemon.js';
+import { DaemonOperationError, DaemonRequestTimeoutError, DaemonUnavailableError, runDaemonAction, runDaemonDiscover, runDaemonScenario, startVisorDaemon, statusVisorDaemon, stopVisorDaemon } from './daemon.js';
 import { DeviceSelectionError, resolveRunningDevice } from './devices.js';
 import { makeError } from './errors.js';
+import { LocalRuntimeAdapter } from './localRuntime.js';
 import { writeReports } from './report.js';
-import { determinismCheck } from './runner.js';
+import { determinismCheck, runScenario } from './runner.js';
 import { errorMessage, makeId, utcNowIso } from './utils.js';
 import { parseAndValidate } from './validator.js';
 function packageVersion() {
@@ -29,6 +30,7 @@ const ALL_COMMANDS = new Set([
     ...ACTION_COMMANDS,
     'validate',
     'run',
+    'discover',
     'benchmark',
     'report',
     'start',
@@ -44,6 +46,8 @@ const GLOBAL_SPEC = {
     'server-url': 'string',
     'app-id': 'string',
     attach: 'boolean',
+    'no-map': 'boolean',
+    repair: 'boolean',
     verbose: 'boolean'
 };
 const ACTION_SPEC = {
@@ -51,12 +55,17 @@ const ACTION_SPEC = {
     target: 'string',
     x: 'number',
     y: 'number',
+    'start-x': 'number',
+    'start-y': 'number',
+    'end-x': 'number',
+    'end-y': 'number',
     direction: 'string',
     percent: 'number',
     normalized: 'boolean',
     to: 'string',
     name: 'string',
     value: 'string',
+    'start-value': 'number',
     label: 'string',
     ms: 'number',
     path: 'string'
@@ -68,9 +77,28 @@ const COMMAND_SPECS = {
         timeout: 'number',
         output: 'string',
         format: 'string',
+        runtime: 'string',
         'server-url': 'string',
         'app-id': 'string',
-        attach: 'boolean'
+        attach: 'boolean',
+        'no-map': 'boolean',
+        repair: 'boolean',
+        crawl: 'boolean',
+        'crawl-depth': 'number',
+        'crawl-limit': 'number'
+    },
+    discover: {
+        device: 'string',
+        timeout: 'number',
+        format: 'string',
+        'server-url': 'string',
+        'app-id': 'string',
+        attach: 'boolean',
+        'no-map': 'boolean',
+        repair: 'boolean',
+        crawl: 'boolean',
+        'crawl-depth': 'number',
+        'crawl-limit': 'number'
     },
     benchmark: {
         runs: 'number',
@@ -81,7 +109,10 @@ const COMMAND_SPECS = {
         format: 'string',
         'server-url': 'string',
         'app-id': 'string',
-        attach: 'boolean'
+        attach: 'boolean',
+        'no-map': 'boolean',
+        repair: 'boolean',
+        'compare-map': 'boolean'
     },
     report: { format: 'string' },
     start: {
@@ -106,6 +137,13 @@ const COMMAND_SPECS = {
     wait: ACTION_SPEC,
     source: ACTION_SPEC
 };
+const ACTION_ARG_OPTION_NAMES = {
+    'start-x': 'startX',
+    'start-y': 'startY',
+    'end-x': 'endX',
+    'end-y': 'endY',
+    'start-value': 'startValue'
+};
 function helpText() {
     return [
         'Visor TypeScript CLI',
@@ -117,8 +155,9 @@ function helpText() {
         '',
         'Commands:',
         '  validate <scenario>',
-        '  run <scenario> [--output <dir>]',
+        '  run <scenario> [--output <dir>] [--runtime appium|local]',
         '  benchmark <scenario> [--runs <n>] [--threshold <percent>]',
+        '  discover [--app-id <id>]',
         '  report [path]',
         '  start [--server-url <url>] [--appium-cmd <cmd>]',
         '  status [--server-url <url>]',
@@ -127,12 +166,125 @@ function helpText() {
         '',
         'Examples:',
         '  visor validate scenarios/checkout-smoke.json',
+        '  visor run path/to/scenario.json --runtime local --output artifacts-local',
         '  visor start --server-url http://127.0.0.1:4723',
         '  visor run scenarios/checkout-smoke.json --output artifacts-test',
+        '  visor run scenarios/checkout-smoke.json --no-map',
+        '  visor discover --app-id com.example.app',
         '  visor scroll --device emulator-5554 --direction down',
         '  visor status'
     ].join('\n');
 }
+function commandHelpText(command) {
+    if (command === 'tap') {
+        const examples = [
+            'visor tap --target accessibility=Continue',
+            'visor tap --target text=Continue',
+            'visor tap --target text~=Settings',
+            'visor tap --target "first-in-section=Featured products"',
+            'visor tap --x 120 --y 640',
+            'visor tap --x 0.5 --y 0.92 --normalized'
+        ];
+        return {
+            usageText: [
+                'Visor tap',
+                '',
+                'Usage:',
+                '  visor tap --target <selector> [runtime options]',
+                '  visor tap --x <points> --y <points> [--normalized] [runtime options]',
+                '',
+                'Options:',
+                '  --target <selector>       Selector to tap',
+                '  --x <points>              X coordinate in screen points, or fraction with --normalized',
+                '  --y <points>              Y coordinate in screen points, or fraction with --normalized',
+                '  --normalized              Treat x/y as fractions of current screen size',
+                '  --no-map                  Disable app-map reads and writes',
+                '  --repair                  Allow opt-in exploratory app-map repair'
+            ].join('\n'),
+            examples
+        };
+    }
+    if (command === 'discover') {
+        const examples = [
+            'visor discover --app-id com.example.app',
+            'visor discover --app-id com.example.app --crawl --crawl-depth 2 --crawl-limit 24'
+        ];
+        return {
+            usageText: [
+                'Visor discover',
+                '',
+                'Usage:',
+                '  visor discover [--app-id <id>] [--crawl] [runtime options]',
+                '',
+                'Options:',
+                '  --crawl                   Explore safe controls and record app-map edges',
+                '  --crawl-depth <n>         Maximum crawl depth, default 2',
+                '  --crawl-limit <n>         Maximum crawl actions, default 24',
+                '  --no-map                  Disable app-map reads and writes'
+            ].join('\n'),
+            examples
+        };
+    }
+    if (command === 'act') {
+        const examples = [
+            'visor act --name back',
+            'visor act --name reset --app-id com.example.app',
+            'visor act --name drag --start-x 120 --start-y 640 --end-x 320 --end-y 640',
+            'visor act --name slider --target accessibility=Amount --value 0.5'
+        ];
+        return {
+            usageText: [
+                'Visor act',
+                '',
+                'Usage:',
+                '  visor act --name <type|back|home|reset|drag|slider> [options]',
+                '',
+                'Options:',
+                '  --name <operation>        Helper action name',
+                '  --target <selector>      Target selector for type or slider',
+                '  --value <value>          Text value for type, or 0..1 slider value',
+                '  --start-x <points>       Drag start x coordinate',
+                '  --start-y <points>       Drag start y coordinate',
+                '  --end-x <points>         Drag end x coordinate',
+                '  --end-y <points>         Drag end y coordinate',
+                '  --start-value <0..1>     Slider starting value, default 0.5',
+                '  --normalized             Treat drag coordinates as viewport fractions'
+            ].join('\n'),
+            examples
+        };
+    }
+    if (command === 'benchmark') {
+        const examples = [
+            'visor benchmark scenarios/checkout-smoke.json --runs 20',
+            'visor benchmark scenarios/checkout-smoke.json --runs 5 --compare-map'
+        ];
+        return {
+            usageText: [
+                'Visor benchmark',
+                '',
+                'Usage:',
+                '  visor benchmark <scenario> [--runs <n>] [--threshold <percent>] [--compare-map]',
+                '',
+                'Options:',
+                '  --runs <n>               Number of runs, default 20',
+                '  --threshold <percent>    Required determinism score, default 95',
+                '  --compare-map            Run no-map and app-map variants for A/B comparison'
+            ].join('\n'),
+            examples
+        };
+    }
+    return {
+        usageText: [
+            `Visor ${command}`,
+            '',
+            'Usage:',
+            `  visor ${command} [options]`,
+            '',
+            'Run visor --help for the full command list.'
+        ].join('\n'),
+        examples: []
+    };
+}
 function envelopeOk(commandId, startedAt, artifacts = [], nextAction = '') {
     return {
         status: 'ok',
@@ -216,7 +368,14 @@ async function resolvedRuntime(options) {
         output_dir: String(options.output ?? 'artifacts'),
         server_url: String(options['server-url'] ?? DEFAULT_SERVER_URL),
         app_id: typeof options['app-id'] === 'string' ? options['app-id'] : undefined,
-        attach_to_running: Boolean(options.attach)
+        attach_to_running: Boolean(options.attach),
+        map: {
+            enabled: !Boolean(options['no-map']),
+            ...(options.repair === true ? { repair: true } : {}),
+            ...(options.crawl === true ? { crawl: true } : {}),
+            ...(typeof options['crawl-depth'] === 'number' ? { crawlDepth: options['crawl-depth'] } : {}),
+            ...(typeof options['crawl-limit'] === 'number' ? { crawlLimit: options['crawl-limit'] } : {})
+        }
     };
 }
 function actionArgs(command, options) {
@@ -228,12 +387,15 @@ function actionArgs(command, options) {
         'verbose',
         'server-url',
         'seed',
+        'runtime',
         'app-id',
-        'attach'
+        'attach',
+        'no-map',
+        'repair'
     ]);
     const args = Object.entries(options).reduce((acc, [key, value]) => {
         if (!commonIgnored.has(key) && value !== undefined) {
-            acc[key] = value;
+            acc[ACTION_ARG_OPTION_NAMES[key] ?? key] = value;
         }
         return acc;
     }, {});
@@ -242,6 +404,10 @@ function actionArgs(command, options) {
     }
     return args;
 }
+function unsupportedRuntimeResult(commandId, startedAt, runtime) {
+    const response = envelopeFail(commandId, startedAt, 'INPUT_ERROR', 'Unsupported runtime', `Unsupported runtime '${String(runtime)}'`, 'Use --runtime appium or --runtime local');
+    return { code: 1, response };
+}
 function isTargetInitializationError(error) {
     const message = errorMessage(error);
     return (message.includes('Failed to create WebdriverIO Appium session') ||
@@ -261,15 +427,80 @@ function targetInitializationNextStep(error) {
     }
     return 'Verify Appium driver setup, target device state, and app id, then retry.';
 }
-function cmdHelp() {
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function optionalString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function mapArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function mapActionCount(variants) {
+    let total = 0;
+    for (const variant of variants) {
+        if (!isRecord(variant)) {
+            continue;
+        }
+        total += mapArray(variant.actions).length;
+    }
+    return total;
+}
+function appMapSummaryFromPath(mapPath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(mapPath, 'utf8'));
+        if (!isRecord(parsed)) {
+            return undefined;
+        }
+        const variants = mapArray(parsed.variants);
+        return {
+            schema_version: typeof parsed.schema_version === 'number' ? parsed.schema_version : undefined,
+            identity: optionalString(parsed.identity),
+            app_id: optionalString(parsed.app_id),
+            platform: optionalString(parsed.platform),
+            screens: mapArray(parsed.screens).length,
+            variants: variants.length,
+            edges: mapArray(parsed.edges).length,
+            actions: mapActionCount(variants),
+            auth_required_variants: variants.filter((variant) => isRecord(variant) && variant.auth_required === true).length,
+            updated_at: optionalString(parsed.updated_at)
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function addDiscoverMapSummary(result) {
+    if (!isRecord(result.map)) {
+        return result;
+    }
+    const map = result.map;
+    if (map.summary !== undefined || typeof map.path !== 'string') {
+        return result;
+    }
+    const summary = appMapSummaryFromPath(map.path);
+    if (!summary) {
+        return result;
+    }
+    return {
+        ...result,
+        map: {
+            ...map,
+            summary
+        }
+    };
+}
+function cmdHelp(command) {
     const commandId = makeId('cmd');
     const startedAt = utcNowIso();
     const response = envelopeOk(commandId, startedAt, [], 'validate');
+    const commandHelp = command ? commandHelpText(command) : undefined;
     response.data = {
-        usageText: helpText(),
-        commands: Array.from(ALL_COMMANDS),
-        examples: [
+        usageText: commandHelp?.usageText ?? helpText(),
+        commands: command ? [command] : Array.from(ALL_COMMANDS),
+        examples: commandHelp?.examples ?? [
             'visor validate scenarios/checkout-smoke.json',
+            'visor run path/to/scenario.json --runtime local --output artifacts-local',
             'visor start --server-url http://127.0.0.1:4723',
             'visor run scenarios/checkout-smoke.json --output artifacts-test',
             'visor scroll --device emulator-5554 --direction down',
@@ -313,6 +544,19 @@ export async function cmdValidate(parsed) {
         return { code: 1, response };
     }
 }
+async function cmdRunLocal(commandId, startedAt, scenario, warnings, runtime) {
+    const result = await runScenario(scenario, new LocalRuntimeAdapter(), runtime.device, runtime.timeout, runtime.output_dir);
+    const outputs = writeReports(result, runtime.output_dir);
+    const response = result.status === 'ok'
+        ? envelopeOk(commandId, startedAt, Object.values(outputs), 'report')
+        : envelopeFail(commandId, startedAt, result.error?.code ?? 'ACTION_ERROR', result.error?.message ?? 'Local runtime scenario failed', result.error?.likely_cause ?? 'The deterministic local runtime did not satisfy the scenario', result.error?.next_step ?? 'Inspect local runtime scenario artifacts and retry');
+    response.artifacts = Object.values(outputs);
+    response.data = {
+        run: result,
+        warnings
+    };
+    return { code: result.status === 'ok' ? 0 : 2, response };
+}
 export async function cmdRun(parsed) {
     const commandId = makeId('cmd');
     const startedAt = utcNowIso();
@@ -323,6 +567,24 @@ export async function cmdRun(parsed) {
         response.data = { issues };
         return { code: 1, response };
     }
+    if (parsed.options.runtime !== undefined &&
+        parsed.options.runtime !== 'appium' &&
+        parsed.options.runtime !== 'local') {
+        return unsupportedRuntimeResult(commandId, startedAt, parsed.options.runtime);
+    }
+    if (parsed.options.runtime === 'local') {
+        const runtime = {
+            device: 'local',
+            timeout: typeof parsed.options.timeout === 'number'
+                ? parsed.options.timeout
+                : typeof scenario.config.timeoutMs === 'number'
+                    ? scenario.config.timeoutMs
+                    : undefined,
+            output_dir: String(parsed.options.output ??
+                (typeof scenario.config.artifactsDir === 'string' ? scenario.config.artifactsDir : 'artifacts'))
+        };
+        return cmdRunLocal(commandId, startedAt, scenario, warningIssues(issues), runtime);
+    }
     let runtime;
     try {
         runtime = await resolvedRuntime({
@@ -351,7 +613,10 @@ export async function cmdRun(parsed) {
             device: runtime.device,
             app_id: runtime.app_id,
             attach_to_running: runtime.attach_to_running
-        }, scenario, runtime.device, runtime.timeout, runtime.output_dir);
+        }, scenario, runtime.device, runtime.timeout, runtime.output_dir, {
+            ...runtime.map,
+            appId: runtime.app_id
+        });
         const outputs = writeReports(result, runtime.output_dir);
         if (result.status === 'fail' && result.error) {
             const response = envelopeFail(commandId, startedAt, result.error.code, result.error.message, result.error.likely_cause, result.error.next_step);
@@ -384,6 +649,51 @@ export async function cmdRun(parsed) {
         return { code: 1, response };
     }
 }
+export async function cmdDiscover(parsed) {
+    const commandId = makeId('cmd');
+    const startedAt = utcNowIso();
+    let runtime;
+    try {
+        runtime = await resolvedRuntime(parsed.options);
+    }
+    catch (error) {
+        if (!(error instanceof DeviceSelectionError)) {
+            throw error;
+        }
+        const response = envelopeFail(commandId, startedAt, 'TARGET_ERROR', 'Device selection failed', error.message, 'Start one target device or rerun with --device <device-id>');
+        response.data = { devices: error.devices };
+        return { code: 1, response };
+    }
+    try {
+        const result = await runDaemonDiscover({
+            platform: runtime.platform,
+            server_url: runtime.server_url,
+            device: runtime.device,
+            app_id: runtime.app_id,
+            attach_to_running: runtime.attach_to_running
+        }, {
+            ...runtime.map,
+            appId: runtime.app_id
+        });
+        const response = envelopeOk(commandId, startedAt, [], 'run');
+        response.data = addDiscoverMapSummary(result);
+        return { code: 0, response };
+    }
+    catch (error) {
+        const isDaemonUnavailable = error instanceof DaemonUnavailableError;
+        const isDaemonTimeout = error instanceof DaemonRequestTimeoutError;
+        const response = envelopeFail(commandId, startedAt, isDaemonUnavailable || isDaemonTimeout ? 'TARGET_ERROR' : 'ACTION_ERROR', isDaemonUnavailable
+            ? 'discover requires visor start'
+            : isDaemonTimeout
+                ? 'discover timed out waiting for Visor daemon'
+                : 'discover failed', errorMessage(error), isDaemonUnavailable
+            ? 'Run `visor start`, verify the target emulator/simulator is booted, and retry.'
+            : isDaemonTimeout
+                ? 'Inspect .visor/daemon/daemon.log and .visor/appium/*.log, then retry or run `visor stop --force` before restarting.'
+                : 'Check target app state and retry');
+        return { code: 1, response };
+    }
+}
 export async function cmdBenchmark(parsed) {
     const commandId = makeId('cmd');
     const startedAt = utcNowIso();
@@ -417,39 +727,97 @@ export async function cmdBenchmark(parsed) {
     }
     const runs = typeof parsed.options.runs === 'number' ? parsed.options.runs : 20;
     const threshold = typeof parsed.options.threshold === 'number' ? parsed.options.threshold : 95;
-    const signatures = [];
-    const runIds = [];
-    let failures = 0;
-    for (let index = 0; index < runs; index += 1) {
-        try {
-            const result = await runDaemonScenario({
-                platform: runtime.platform,
-                server_url: runtime.server_url,
-                device: runtime.device,
-                app_id: runtime.app_id,
-                attach_to_running: runtime.attach_to_running
-            }, scenario, runtime.device, runtime.timeout, runtime.output_dir);
-            writeReports(result, runtime.output_dir);
-            signatures.push(result.determinism_signature);
-            runIds.push(result.run_id);
-            if (result.status !== 'ok') {
+    const runtimeRequest = {
+        platform: runtime.platform,
+        server_url: runtime.server_url,
+        device: runtime.device,
+        app_id: runtime.app_id,
+        attach_to_running: runtime.attach_to_running
+    };
+    const runVariant = async (name, mapEnabled, mapOptions) => {
+        const signatures = [];
+        const runIds = [];
+        let failures = 0;
+        for (let index = 0; index < runs; index += 1) {
+            try {
+                const result = await runDaemonScenario(runtimeRequest, scenario, runtime.device, runtime.timeout, runtime.output_dir, mapOptions);
+                writeReports(result, runtime.output_dir);
+                signatures.push(result.determinism_signature);
+                runIds.push(result.run_id);
+                if (result.status !== 'ok') {
+                    failures += 1;
+                }
+            }
+            catch (error) {
+                if (error instanceof DaemonUnavailableError) {
+                    const response = envelopeFail(commandId, startedAt, 'TARGET_ERROR', 'Benchmark requires visor start', errorMessage(error), 'Run `visor start`, verify the target emulator/simulator is booted, and retry.');
+                    return { error: { code: 1, response } };
+                }
+                if (error instanceof DaemonRequestTimeoutError) {
+                    const response = envelopeFail(commandId, startedAt, 'TARGET_ERROR', 'Timed out waiting for Visor daemon', errorMessage(error), 'Inspect .visor/daemon/daemon.log and .visor/appium/*.log, then retry or run `visor stop --force` before restarting.');
+                    return { error: { code: 1, response } };
+                }
                 failures += 1;
             }
         }
-        catch (error) {
-            if (error instanceof DaemonUnavailableError) {
-                const response = envelopeFail(commandId, startedAt, 'TARGET_ERROR', 'Benchmark requires visor start', errorMessage(error), 'Run `visor start`, verify the target emulator/simulator is booted, and retry.');
-                return { code: 1, response };
+        const score = determinismCheck(signatures);
+        return {
+            variant: {
+                name,
+                mapEnabled,
+                runs,
+                threshold,
+                determinismScore: score,
+                pass: score >= threshold && failures === 0,
+                failures,
+                runIds
             }
-            if (error instanceof DaemonRequestTimeoutError) {
-                const response = envelopeFail(commandId, startedAt, 'TARGET_ERROR', 'Timed out waiting for Visor daemon', errorMessage(error), 'Inspect .visor/daemon/daemon.log and .visor/appium/*.log, then retry or run `visor stop --force` before restarting.');
-                return { code: 1, response };
+        };
+    };
+    if (parsed.options['compare-map'] === true) {
+        const variants = [];
+        for (const variantConfig of [
+            { name: 'no-map', mapEnabled: false },
+            { name: 'map', mapEnabled: true }
+        ]) {
+            const outcome = await runVariant(variantConfig.name, variantConfig.mapEnabled, {
+                ...runtime.map,
+                enabled: variantConfig.mapEnabled,
+                appId: runtime.app_id
+            });
+            if ('error' in outcome) {
+                return outcome.error;
             }
-            failures += 1;
+            variants.push(outcome.variant);
         }
-    }
-    const score = determinismCheck(signatures);
-    const passGate = score >= threshold && failures === 0;
+        const failures = variants.reduce((total, variant) => total + Number(variant.failures ?? 0), 0);
+        const score = Math.min(...variants.map((variant) => Number(variant.determinismScore ?? 0)));
+        const passGate = variants.every((variant) => variant.pass === true);
+        const runIds = variants.flatMap((variant) => Array.isArray(variant.runIds) ? variant.runIds : []);
+        const response = envelopeOk(commandId, startedAt, [], 'report');
+        response.data = {
+            runs,
+            threshold,
+            determinismScore: score,
+            pass: passGate,
+            failures,
+            runIds,
+            variants,
+            warnings: warningIssues(issues)
+        };
+        return { code: passGate ? 0 : 3, response };
+    }
+    const outcome = await runVariant('benchmark', runtime.map.enabled !== false, {
+        ...runtime.map,
+        appId: runtime.app_id
+    });
+    if ('error' in outcome) {
+        return outcome.error;
+    }
+    const score = Number(outcome.variant.determinismScore ?? 0);
+    const failures = Number(outcome.variant.failures ?? 0);
+    const passGate = outcome.variant.pass === true;
+    const runIds = Array.isArray(outcome.variant.runIds) ? outcome.variant.runIds : [];
     const response = envelopeOk(commandId, startedAt, [], 'report');
     response.data = {
         runs,
@@ -499,7 +867,10 @@ export async function cmdAction(command, parsed) {
             device: options.device,
             app_id: options.app_id,
             attach_to_running: options.attach_to_running
-        }, command, actionArgs(command, parsed.options));
+        }, command, actionArgs(command, parsed.options), {
+            ...options.map,
+            appId: options.app_id
+        });
         const actionPayload = payload.args;
         if (actionPayload && typeof actionPayload === 'object' && !Array.isArray(actionPayload)) {
             const maybePath = actionPayload.path;
@@ -509,6 +880,9 @@ export async function cmdAction(command, parsed) {
         }
     }
     catch (error) {
+        if (error instanceof DaemonOperationError && error.data) {
+            payload = error.data;
+        }
         actionError = error;
     }
     if (actionError) {
@@ -573,10 +947,12 @@ export async function cmdStop(parsed) {
     }
 }
 export async function executeCommand(argv) {
-    if (argv.length === 0 ||
-        argv[0] === 'help' ||
-        argv.includes('--help') ||
-        argv.includes('-h')) {
+    const requestedHelp = argv[0] === 'help' || argv.includes('--help') || argv.includes('-h');
+    if (requestedHelp) {
+        const helpCommand = argv.find((token) => ALL_COMMANDS.has(token));
+        return cmdHelp(helpCommand);
+    }
+    if (argv.length === 0) {
         return cmdHelp();
     }
     if (argv.includes('--version') || argv.includes('-v')) {
@@ -589,6 +965,9 @@ export async function executeCommand(argv) {
     if (parsed.command === 'run') {
         return cmdRun(parsed);
     }
+    if (parsed.command === 'discover') {
+        return cmdDiscover(parsed);
+    }
     if (parsed.command === 'benchmark') {
         return cmdBenchmark(parsed);
     }