Function _run_tests_or_special_mode

ci/autoresearch/phases.py:1227–1342

Execute GPIO-only, special modes, or main RPC test loop. Returns exit code (0 = success, 1 = failure, 130 = interrupted).

(ctx: RunContext, qctx: QuietContext)

async def _run_tests_or_special_mode(ctx: RunContext, qctx: QuietContext) -> int:
    """Execute GPIO-only, special modes, or main RPC test loop.

    Returns exit code (0 = success, 1 = failure, 130 = interrupted).
    """
    upload_port = ctx.upload_port
    assert upload_port is not None
    serial_iface = ctx.serial_iface
    use_fbuild = ctx.use_fbuild

    # Low-memory ARM bring-up mode short-circuit. LPC845/LPC804 boards run a
    # JSON-RPC echo verification (examples/AutoResearchLpc/) instead of the
    # GPIO + LED-protocol matrix that ESP32/Teensy targets use. Must come
    # BEFORE the gpio_only_mode early-return so the harness actually runs the
    # echo check instead of bailing with a "no tests requested" success.
    bring_up_envs = {"lpc845brk", "lpcxpresso845max", "lpcxpresso804"}
    if ctx.final_environment in bring_up_envs:
        # FastLED #3021 Phase 1: --pin-toggle-rx runs the SCT-RX
        # loopback bench instead of the default echo bring-up.
        if getattr(ctx.args, "pin_toggle_rx", False):
            return await _run_lpc_pin_toggle_rx_tests(ctx)
        # FastLED #3021 Phase 2: --ws2812-loopback runs the WS2812
        # byte-match loopback bench. Requires the sketch to be
        # rebuilt with -DFASTLED_LPC_RX_SCT_WS2812=1 (gated due to
        # flash budget — see issue #3002).
        if getattr(ctx.args, "ws2812_loopback", False):
            return await _run_lpc_ws2812_loopback_tests(ctx)
        return await _run_bring_up_tests(ctx)

    # GPIO-only mode
    if ctx.gpio_only_mode:
        print()
        print("=" * 60)
        print(f"{Fore.GREEN}\u2713 GPIO-ONLY AUTORESEARCH SUCCEEDED{Style.RESET_ALL}")
        print("=" * 60)
        print("Pin discovery and GPIO connectivity pre-test passed.")
        print("No driver tests requested \u2014 skipping RPC test matrix.")
        print()
        return 0

    # Fall back to loopback for no-WiFi platforms
    net_server_mode = ctx.net_server_mode
    net_client_mode = ctx.net_client_mode
    net_loopback_mode = ctx.net_loopback_mode

    if (net_server_mode or net_client_mode) and ctx.final_environment:
        if not environment_has_wifi(ctx.final_environment):
            mode_name = "--net-server" if net_server_mode else "--net-client"
            print(
                f"\n\u26a0\ufe0f  {ctx.final_environment} does not have WiFi hardware"
            )
            print(f"   Falling back from {mode_name} to --net (loopback) mode")
            net_server_mode = False
            net_client_mode = False
            net_loopback_mode = True

    # Network mode
    if net_server_mode or net_client_mode: