test(docs): android e2e refinement, upstream API review refinement

Author: mikehardy

okf-bundle/ci-workflows/android.md

@@ -74,5 +74,6 @@ Under load, Jet may run only a small prefix before mocha-remote desync, often af
 | Empty Jacoco XML (~235 bytes) | No `.ec` pulled — check post-e2e logs |
 | `adb reverse --remove` in Detox logs | Expected on 1006; should be warn-only after Detox patch |
 | Detox red, tests green in log | Pre-patch: teardown adb error; re-run or check patch applied |
+| Emulator offline / hung / duplicate instance | Warm quickboot snapshot restore; `tests/.detoxrc.js` sets `bootArgs: '-no-snapshot-load -no-snapshot-save'` for cold boot when Detox launches TestingAVD |
 | `codecov/project/android-native` fail | Jacoco XML not uploaded — check post-e2e logs and Codecov Uploads tab for `android-native` flag |
 | FIS 503 / `Too many server requests` / RC cascade | Live cloud quota (shared project) — not Android-specific; see [cloud API quota triage](../testing/firebase-testing-project.md#ci-triage-cloud-api-quota-pressure) |

okf-bundle/testing/change-authoring-workflow.md

@@ -146,6 +146,17 @@ flowchart TD
 
 Step detail: [running e2e § unit-focused iteration loop](running-e2e.md#unit-focused-tier-iteration-loop).
 
+<a id="platform-sdk-bridge-contracts"></a>
+
+### Platform SDK bridge contracts (blocking)
+
+Before changing native bridge code that calls a **platform SDK** (Firebase Android/iOS, OS APIs, vendor SDKs, etc.):
+
+1. **Read each platform's official API signature and docs independently** — do not assume Android, iOS, and Web behave the same because the RNFB bridge presents a unified JavaScript surface.
+2. **Verify null vs empty string** — many SDKs treat absent values (`null`/`nil`) and empty strings (`""`) differently; map bridge fields to the SDK parameter the docs specify for "absent" values.
+3. **Do not apply defensive parity** — fixing platform A does not justify the same change on platform B without checking B's contract (e.g. `@Nullable` vs `nonnull`, optional vs required).
+4. **Record evidence** — link or cite the reference URL / header signature in the work queue note or triage report when the fix is native-only on one platform.
+
 <a id="e2e-diagnosis-escalation"></a>
 
 ### E2e diagnosis escalation

tests/.detoxrc.js

@@ -62,6 +62,9 @@ module.exports = {
       device: {
         avdName: 'TestingAVD',
       },
+      // Cold boot: do not load/save AVD snapshots (warm quickboot is unreliable locally).
+      bootArgs: '-no-snapshot-load -no-snapshot-save',
+      readonly: true,
     },
   },
   configurations: {