fix(helper): pump run loop for CLLocationManager auth before scan (the real root cause)

[chenchaoyi]

Summary

The real root cause of the macOS 26 install hang you've been seeing through v1.0.3 → v1.0.5.

The earlier fix in v1.0.3 (disclaim + CLLocationManager.startUpdatingLocation + Thread.sleep(0.3)) was on the right track for points 1 + 3 but got point 2 wrong:

Thread.sleep does not pump the run loop. CLLocationManager's delegate-callback handshake with locationd never actually completes inside a short-lived CLI subprocess. CoreWLAN's macOS 26 redaction gate checks whether the calling process is a registered location consumer — not just authorised — so scans came back redacted (ssid / bssid null) even when the bundle's TCC grant was in place.

The helper GUI window saying "Location: granted" was reading authorizationStatus synchronously (cached state). The CoreWLAN redaction gate is the stricter check, and it failed silently — leading to the polling hang.

Fix

New LocationAuthProbe : CLLocationManagerDelegate that flips a flag when locationManagerDidChangeAuthorization resolves status to non-.notDetermined. The scan subcommand pumps RunLoop.current.run(mode: .default, before: …) in 50ms slices, exiting as soon as the callback fires (typically <100ms when the grant is already in TCC.db) or after a 2s timeout. Only then does scanForNetworks run.

Mirrors the existing runBluetoothStatusProbe pattern — which is exactly why bluetooth-status has been working correctly through all these versions while scan has been broken.

Verification (local, before opening this PR)

helper/build.sh                          # rebuilds with the fix
open helper/diting-tianer.app            # new cdhash 6e74d56e..., user grants Location
pkill -f diting-tianer.app && sleep 1    # kill GUI to defeat warm-cache
helper/diting-tianer.app/.../diting-tianer scan | jq '.networks | length'

3 cold-start subprocess runs:

run 1: rows=129 with_bssid=129
run 2: rows=153 with_bssid=153
run 3: rows=153 with_bssid=153

100% unredacted, no warm GUI session needed. This is the first time the fix has been verified to work in the exact same conditions install.sh produces.

• uv run pytest — 499 passed
• Tag v1.0.6 + watch release workflow — awaiting your explicit go

🤖 Generated with Claude Code