play images: tablet, TV and Wear sets are optional; play.tablets switch (default: tablet renders exist); a missing optional set never deletes Play's images without --prune

A phone-only project aborted with 'no sevenInchScreenshots'. Play requires the 512 icon, the 1024x500 feature graphic and at least 2 screenshots (Play Console Help answer 9866151). play images uploads what exists and prints an info line for missing optional sets; play.tablets true makes missing tablet sets an error in shots render/check/gallery, validate and play images. Pitfall 19.

skills/play-first-release/SKILL.md

@@ -43,6 +43,10 @@ deleting products. Sending a first release for review is the owner's action in t
    `--include-drafts` only on the owner's word); the real run asks in a terminal and PUTs only what changes.
 7. **API · Graphics.** Render (`store-screenshots` skill), `storebound shots jpeg`, then
    `storebound play images > .storebound/play-images.log 2>&1 &` and follow the log (it is slow: one edit per language).
+   Required: the 512 x 512 icon, the 1024 x 500 feature graphic and at least 2 phone screenshots (Play Console Help
+   answer 9866151). 7" / 10" tablet screenshots are optional (no tablet featuring without them): a phone-only project
+   gets an info line, not an error; `play.tablets: true` renders and requires them, `false` never asks. Tablet
+   screenshots already on Play stay unless the owner runs `--prune`.
 8. **API · In-app products.** `store-iap-setup` skill (`storebound play products`). Needs a build with the BILLING
    permission on any track first.
 9. **API · Data safety.** Answers in `dataSafety` of the config, `storebound play data-safety`, then check the summary

skills/store-pitfalls/SKILL.md

@@ -190,6 +190,22 @@ Each entry: **symptom** → cause → what to do → what guards it now. The ful
   https://developer.chrome.com/docs/web-platform/device-bound-session-credentials ,
   https://knowledge.workspace.google.com/admin/security/investigate-and-take-action-on-suspicious-session-cookies
 
+## 19. `play images` aborts on missing tablet screenshots
+- **Symptom:** `storebound play images --dry` on a phone-only project (renders with feature, ios65, ios69 and play, no
+  tab7 / tab10) stopped with `en-US: no sevenInchScreenshots in .../store/renders/en (render first: storebound shots
+  render)`.
+- **Cause:** every Play image type was treated as required. Play requires only the 512 x 512 icon, the 1024 x 500
+  feature graphic and at least 2 screenshots (Play Console Help, "Add preview assets to showcase your app", answer
+  9866151); 7" / 10" tablet, TV and Wear screenshots are optional (without tablet screenshots the app is not eligible
+  for tablet featuring).
+- **Do:** nothing special: `play images` uploads what exists and prints `tablet screenshots: none (optional; ...)`. To
+  render and require tablets set `play.tablets: true`; to never ask for them, `play.tablets: false` (default: true
+  when tablet renders exist). A missing optional set never deletes the tablet screenshots Play already has; the dry run
+  shows `keeps sevenInchScreenshots on Play`, and only `--prune` (owner's call) deletes them.
+- **Guard:** `langImages` / `missingChange` in `cli/play/images.ts`, `resolvedTablets` in `cli/shots/report.ts`;
+  `tests/play-post-reads.test.ts` (phone-only fixture: dry plan, info line, exit 0; `tablets: true` without renders is
+  an error; no tablet DELETE without `--prune`).
+
 ## Adding a lesson
 Every bug found in real use gets an entry in `docs/pitfalls.md` and here, and, where possible, a check or a test
 that fails without the fix (see CONTRIBUTING.md).

skills/store-screenshots/SKILL.md

@@ -16,8 +16,8 @@ iOS Simulator capture needs macOS + Xcode (`xcrun`); Android capture needs `adb`
 | ios65 | 1284 x 2778 | App Store 6.5" (`APP_IPHONE_65`) |
 | ipad13 | 2064 x 2752 | App Store 13" iPad (`APP_IPAD_PRO_3GEN_129`), required when the app runs on iPad; only with `apple.ipad: true` |
 | play | 1080 x 1920 | Play phone (2-8, ratio at most 2:1) |
-| tab7 | 1080 x 1920 | Play 7" tablet (tablet frames, Android tablet body) |
-| tab10 | 1440 x 2560 | Play 10" tablet |
+| tab7 | 1080 x 1920 | Play 7" tablet (tablet frames, Android tablet body); optional, see `play.tablets` |
+| tab10 | 1440 x 2560 | Play 10" tablet; optional, see `play.tablets` |
 | feature | 1024 x 500 | Play feature graphic (required) |
 
 Sources (re-check before a release; Apple renames display classes often):
@@ -42,6 +42,13 @@ to the 13" iPad screen (1032 x 1352 CSS px @2x below a 24 px bar), so an `iPad P
 simulator screenshot fits after the bar is cropped. Play tablet sizes (tab7 / tab10) reuse the same tablet frames, drawn
 in a plain Android tablet body instead of the iPad one.
 
+**Play tablets are optional.** Play requires the 512 x 512 icon, the 1024 x 500 feature graphic and at least 2
+screenshots (answer 9866151 above); 7" / 10" tablet screenshots are optional, but without them the app is not eligible
+for tablet featuring. `play.tablets` decides: unset = true when tablet renders (tab7/ or tab10/) already exist, else
+false; `false` = `shots render`, `shots check`, `shots gallery`, `validate` and `play images` never ask for them;
+`true` = they are rendered, and missing ones are errors. A phone-only project needs no setting: `play images` uploads
+the icon, feature graphic and phone screenshots and prints `tablet screenshots: none (optional; ...)`.
+
 ## Steps
 1. **Screenshot switches.** Give the app or game params for screenshots: language, demo data or a fixed seed, no ads /
    analytics / purchase UI, skip onboarding or the tutorial, jump to a screen or level, freeze at a moment. Frames must
@@ -119,6 +126,8 @@ in a plain Android tablet body instead of the iPad one.
    only issues, search) and light / dark. Tiles with store check errors are outlined red, warnings amber, with the
    message under the tile. Show the owner this page (or a screenshot of it) before uploading.
 10. **Upload.** `storebound play images` and `storebound apple screenshots` (both idempotent, background + log).
+   `play images` uploads only the sets that exist (tablet / TV / Wear when rendered) and never deletes a set Play has
+   but the renders lack: the dry run shows `keeps <type> on Play`; `--prune` (only on the owner's word) deletes them.
 
 ## A/B variants and store experiments
 `shots.variants.<id>`: `scenes` (order / subset), `copy` (a JSON merged over the base copy, only what changes),