apple screenshots: iPhone Duo through the App Asset Library (IPHONE_DUO placement group, APP_SCREENSHOT), pitfall 130

skills/store-pitfalls/SKILL.md

@@ -1610,3 +1610,19 @@ that fails without the fix (see CONTRIBUTING.md).
 - **Guard:** `cli/play/old-builds.ts` (play status, validate `old-builds`), `PLAY_NOT_LIVE` in `cli/lib/portfolio.ts`,
   `isAutoSendOnly` in `cli/play/review-pending.ts` (the commit is redone without changesNotSentForReview),
   `tests/play-old-builds.test.ts`.
+
+## 130. iPhone Duo screenshots were skipped as "not in the API"
+
+- **Symptom:** `apple screenshots` skipped the iPhone Duo sets with "the API has no iPhone Duo display type yet".
+  Wrong: ScreenshotDisplayType never gets a Duo value. API 4.5.1 put the display class `IPHONE_DUO` into the App Asset
+  Library (AppAssetLibraryDisplayClass) and deprecated appScreenshotSets / appScreenshots / appPreviewSets /
+  appPreviews in the same release.
+- **Do:** `storebound apple screenshots` uploads Duo (apple.iphoneDuo, renders iphone-duo-outer/ then
+  iphone-duo-inner/) through the library: `appAssetLibraryRefData` (filter placementTypes APP_SCREENSHOT) gives the
+  iOS placementProfileGroup of IPHONE_DUO, files go up as appAssetLibraryImages (category
+  APP_SCREENSHOTS_AND_PREVIEWS), then appAssetLibraryPlacements (APP_SCREENSHOT, that placementGroup, the version
+  localization). Same MD5 reuse as creative assets; read back.
+- **Never:** say an API lacks a store feature after checking one enum: search the whole spec (every schema with the
+  feature's name) first.
+- **Guard:** `cli/apple/duo-library.ts` (duoGroups, syncDuo), `duoDirs` in `cli/apple/screenshots.ts`,
+  `tests/ppo.test.ts`. Previews and the other display classes still use the deprecated sets until they move too.