Function _parse_args_and_build_commands

ci/autoresearch/phases.py:171–715

Parse CLI args, validate modes, build JSON-RPC command list. Pure computation — no hardware I/O. Returns RunContext on success, int exit code on validation failure.

(args: Args)

def _parse_args_and_build_commands(args: Args) -> RunContext | int:
    """Parse CLI args, validate modes, build JSON-RPC command list.

    Pure computation — no hardware I/O.
    Returns RunContext on success, int exit code on validation failure.
    """
    final_environment = args.environment_positional or args.environment

    if args.lcd and not final_environment:
        final_environment = "esp32s3"
        print(
            "\u2139\ufe0f  --lcd flag requires ESP32-S3, auto-selecting 'esp32s3' environment"
        )

    if args.lcd_spi and not final_environment:
        final_environment = "esp32s3"
        print(
            "\u2139\ufe0f  --lcd-spi flag requires ESP32-S3, auto-selecting 'esp32s3' environment"
        )

    if args.lcd_rgb and not final_environment:
        final_environment = "esp32p4"
        print(
            "\u2139\ufe0f  --lcd-rgb flag requires ESP32-P4, auto-selecting 'esp32p4' environment"
        )

    # Driver selection
    drivers: list[str] = []
    simd_test_mode = args.simd
    coroutine_test_mode = args.coroutine

    if args.all:
        drivers = [
            "PARLIO",
            "RMT",
            "SPI",
            "UART",
            "LCD_CLOCKLESS",
            "LCD_SPI",
            "LCD_RGB",
            "OBJECT_FLED",
            "FLEX_IO",
            "LPUART",
        ]
    else:
        if args.parlio:
            drivers.append("PARLIO")
        if args.rmt:
            drivers.append("RMT")
        if args.spi:
            drivers.append("SPI")
        if args.uart:
            drivers.append("UART")
        if args.lcd:
            drivers.append("LCD_CLOCKLESS")
        if args.lcd_spi:
            drivers.append("LCD_SPI")
        if args.lcd_rgb: