chore(scripts): add live postimages emulator test and smoke scripts

docs/upload-automation-retest-checklist.md

@@ -0,0 +1,140 @@
+# Upload Automation Retest Checklist
+
+Retest checklist for Android and desktop after changes to media upload automation (`MediaUploadAutomationRunner`, `MediaUploadRecipes`, `upload-orchestrator`, etc.).
+
+## Quality Gate (blocking)
+
+Run before merge/rollout. All must pass.
+
+| Command | Purpose | Interpretation |
+|---------|---------|----------------|
+| `yarn test` | Unit tests (Vitest) | Exit 0 = pass. Fix failing tests before merge. |
+| `yarn build` | Production build | Exit 0 = pass. No build errors. |
+| `yarn lint` | Lint (oxlint) | Exit 0 = pass. Fix lint errors. |
+| `yarn type-check` | TypeScript (tsgo) | Exit 0 = pass. Fix type errors. |
+| `yarn doctor` | React Doctor | Advisory. Prioritize `error` > `warning`. |
+
+**Quick run (all quality gates):**
+
+```bash
+yarn retest:quality
+```
+
+---
+
+## Postimages chooser contract (required local gate)
+
+Runs postimages-specific emulator contract tests against deterministic fixtures. **Emulator required.** Must pass before merge.
+
+```bash
+yarn contract:postimages
+```
+
+- **Prereq:** Android emulator running or USB device connected.
+- **Interpretation:** Exit 0 = contract tests pass. Runs `MediaUploadAutomationRunnerTest` (postimages chooser contract + imgur/generic fixtures). Uses deterministic fixtures in `android/app/src/main/assets/fixtures/`.
+
+---
+
+## Live postimages test (fully automated, real provider)
+
+Runs a real provider upload test with no manual taps. The script will:
+- install missing Android SDK components when `sdkmanager` is available
+- create/start an emulator AVD when needed
+- run `PostimagesLiveUploadTest` on a booted emulator/device
+- generate a blank white `100x100` PNG at runtime inside the instrumentation test
+
+```bash
+yarn live:postimages:auto
+```
+
+- **Prereq:** Android command-line tools installed (`sdkmanager`, `avdmanager`, `adb`, `emulator`) or available in `ANDROID_SDK_ROOT` / `ANDROID_HOME`.
+- **Interpretation:** Exit 0 = real upload to `postimages.org` succeeded end-to-end.
+- **Note:** This is a live-provider check (network/captcha/rate-limit dependent), so it can be flaky compared to fixture contracts.
+
+---
+
+## Android Emulator Verification (report-only)
+
+Instrumentation tests run on an **emulator or physical device**. Requires an emulator/device to be running and connected.
+
+### Standard run
+
+```bash
+yarn android:connectedTest
+```
+
+Or directly (uses UTP workaround for protobuf compatibility):
+
+```bash
+cd android && ./gradlew :app:connectedDebugAndroidTest -Pandroid.experimental.androidTest.useUnifiedTestPlatform=false
+```
+
+- **Prereq:** Emulator running (`emulator -avd <avd_name>` or Android Studio) or USB device.
+- **Interpretation:** Exit 0 = all instrumented tests pass. `MediaUploadAutomationRunnerTest` exercises fixtures in `android/app/src/main/assets/fixtures/`.
+
+### UTP / Protobuf issue (known)
+
+On some setups, `connectedDebugAndroidTest` fails with protobuf classloader conflicts (e.g. `IllegalAccessError` involving `com.google.protobuf.CodedInputStream`). This is a known UTP/Espresso + protobuf incompatibility.
+
+**Workaround (disable UTP, use legacy test runner):**
+
+Use this exact command, which passes `-Pandroid.experimental.androidTest.useUnifiedTestPlatform=false` to disable the unified test platform:
+
+```bash
+cd android && ./gradlew :app:connectedDebugAndroidTest -Pandroid.experimental.androidTest.useUnifiedTestPlatform=false
+```
+
+> **Caveat:** The `useUnifiedTestPlatform=false` flag may be deprecated in future Android Gradle Plugin versions; if it stops working, use the fallback below.
+
+If the above does not resolve it, exclude conflicting protobuf from Espresso in `android/app/build.gradle`:
+
+```gradle
+androidTestImplementation("androidx.test.espresso:espresso-core:3.3.0") {
+    exclude group: "com.google.protobuf", module: "protobuf-java"
+    exclude group: "com.google.protobuf", module: "protobuf-lite"
+}
+```
+
+---
+
+## Upload Selector Smoke Run (report-only, non-blocking)
+
+Probes live upload sites (Imgur, PostImages) to verify selectors in `media-upload-recipes` still match. **Always exits 0**; intended for CI report-only and local triage. **Not a merge gate**—check report for selector drift but do not block.
+
+```bash
+yarn smoke:upload-selectors
+```
+
+- **Output (report):** `scripts/upload-selectors-smoke-report.json`
+- **Output (snapshots):** `scripts/upload-selectors-smoke-snapshots/` (provider PNGs)
+- **Interpretation:** Check `summary.ok` vs `summary.warn` in the report. Warnings indicate selectors may need updates; do not block merge without further triage.
+
+---
+
+## Desktop (Electron)
+
+Build and run the Electron app to manually verify upload flows:
+
+```bash
+yarn electron:start
+```
+
+Unit tests for Electron automation (non-blocking, report-only):
+
+```bash
+node electron/media-upload-automation.test.js
+node electron/media-upload-recipes.test.js
+```
+
+---
+
+## Summary
+
+| Check | Blocking? | Command |
+|-------|-----------|---------|
+| Quality gate | Yes | `yarn retest:quality` |
+| Postimages chooser contract | Yes | `yarn contract:postimages` |
+| Postimages live provider automation | No (recommended local) | `yarn live:postimages:auto` |
+| Android instrumentation | No (report-only) | `yarn android:connectedTest` |
+| Upload selector smoke | No (report-only) | `yarn smoke:upload-selectors` |
+| Electron unit tests | No (report-only) | `node electron/media-upload-*.test.js` |