rnxsim 0.1.340 → 0.1.342

package/skills/rnx-visual/SKILL.md

@@ -78,13 +78,19 @@ npx pixelmatch before.png after.png diff.png 0.1      # writes diff.png
 **rnx vs native iOS (fidelity to the real thing):**
 
 ```sh
-# native side — capture from your booted iOS simulator
-xcrun simctl io booted screenshot native.png
-# rnx side — same screen, same appearance
+# native side: lifecycle and UI use xcodebuildmcp with one claimed simulator
+# lossless capture names that simulator explicitly; never use the booted alias
+xcrun simctl io <udid> screenshot --type=png native.png
+# rnx side: same screen, same appearance
 rnx screenshot -o rnx.png
 npx pixelmatch native.png rnx.png diff.png 0.1
 ```
 
+`xcodebuildmcp simulator screenshot` may return an optimized JPEG even when the
+proof contract requires a lossless source. Use it only when JPEG is acceptable.
+For parity proof, use the explicit-UDID PNG command above, then verify the
+decoded dimensions and file type before admitting the capture.
+
 crop both to the same region (`--area` / `--id`) when you only care
 about one element — a full-screen diff buries a 3px font-baseline shift
 under unrelated chrome.