libs/cua-driver/test-harness/
│
├── shared/                       ◀── cross-OS single source of truth
│   ├── scenarios.json            #   defines every app + scenario (titles, AutomationIds,
│   │                             #   expected tree shape). Read by BOTH the apps and the tests.
│   └── web/index.html            #   the page WebView2 AND Electron both load
│
├── apps/                         ◀── the test-target GUI apps, grouped by where they run
│   ├── cross-platform/
│   │   └── electron/             #   main.js · package.json        (Win / macOS / Linux)
│   ├── macos/
│   │   ├── appkit/               #   main.swift                    (macOS)
│   │   └── swiftui/              #   main.swift                    (macOS)
│   └── windows/
│       ├── wpf/                  #   WPF: MainWindow, Owned/Layered popups,
│       │                         #        NativeButtonHost, Scenarios.cs   (Windows)
│       ├── winui3/               #   WinUI3: App, MainWindow, Program.cs    (Windows)
│       └── webview2/             #   WebView2 host (WPF) → loads shared/web  (Windows)
│
├── build/                        ◀── host-OS build scripts
│   ├── macos.sh                  #   swiftc the macOS apps + electron
│   └── windows.ps1               #   dotnet publish the .NET apps + electron
│
├── smoke/                        ◀── per-tool CLI smoke runner + baseline
│   ├── macos.sh
│   └── results/macos.txt
│
├── CuaTestHarness.sln            #   .NET solution tying the Windows apps together
└── README.md

libs/cua-driver/rust/crates/cua-driver/tests/   ◀── the CONSUMERS (Rust integration tests)
│   (all build on the cua-driver-testkit crate; named by 4-family taxonomy —
│    harness_ / modality_ / protocol_ / guard_. See TEST_SUITE.md.)
├── harness_wpf_test.rs           (Windows)
├── harness_winui3_test.rs        (Windows)
├── harness_web_test.rs           (Windows — WebView2 + Electron via CDP)
├── harness_libreoffice_test.rs   (Windows — LibreOffice VCL/SAL via MSAA)
├── harness_appkit_test.rs        (macOS)
└── harness_swiftui_test.rs       (macOS)
    (the focus-steal sentinel + deprecated capture_mode compatibility tests now live under
     modality_background_test.rs — see TEST_SUITE.md for the full inventory)

flowchart TD
    SoT["shared/scenarios.json
(single source of truth:
titles · AutomationIds · expected tree)"]
    WEB["shared/web/index.html"]

    subgraph APPS["apps/ — test-target GUI apps"]
        direction LR
        WPF["windows/wpf"]
        WINUI["windows/winui3"]
        WV["windows/webview2"]
        ELEC["cross-platform/electron"]
        AK["macos/appkit"]
        SW["macos/swiftui"]
    end

    BUILD["build/ → test-apps/harness-*
(macos.sh · windows.ps1)"]

    subgraph TESTS["Rust integration tests (crates/cua-driver/tests/)"]
        direction LR
        T1["harness_wpf · winui3 · web_windows
bg_modality · lo_vcl  (Windows)"]
        T2["harness_appkit · swiftui  (macOS)"]
    end

    DRIVER(["cua-driver tools
(click / type / get_window_state / page / …)"])

    SoT -->|apps read at startup:
set window titles & AutomationIds| APPS
    WEB --> WV
    WEB --> ELEC
    APPS --> BUILD
    BUILD -->|each test launches its built app| TESTS
    SoT -->|tests read: assert expected shape
without hardcoding strings| TESTS
    TESTS -->|drive| DRIVER
    DRIVER -->|act on| APPS
    TESTS -->|re-snapshot & assert| TESTS

    classDef sot fill:#1f883d,stroke:#116329,color:#fff;
    class SoT,WEB sot;