apple creative-assets: select Header and Search Results assets once processed (Prepare for Submission), not once approved: Apple reviews an asset only in a review submission, so 0.8.13 waited forever; upload and select in one run with a bounded processing wait; --add-for-review puts unreviewed assets into the draft review submission (never submits); --verify reads every slot back read-only (MCP apple_creative_assets_verify); a rejected file or one that failed processing twice is not re-uploaded, an archived copy is unarchived; fake commits library assets to PREPARE_FOR_SUBMISSION; pitfall 76 rewritten; apple-name check test only looks at name hints

docs/api-coverage.md

@@ -421,7 +421,7 @@ Specs: Apple [App Store Connect API 4.5.1](https://developer.apple.com/sample-co
 | `apps_appPriceSchedule_getToOneRelationship` | GET | `/v1/apps/{id}/relationships/appPriceSchedule` | read |  |
 | `apps_appStoreVersionExperimentsV2_getToManyRelated` | GET | `/v1/apps/{id}/appStoreVersionExperimentsV2` | read | apple/ppo |
 | `apps_appStoreVersionExperimentsV2_getToManyRelationship` | GET | `/v1/apps/{id}/relationships/appStoreVersionExperimentsV2` | read |  |
-| `apps_appStoreVersions_getToManyRelated` | GET | `/v1/apps/{id}/appStoreVersions` | read | apple/asc, apple/iap-submit, apple/listing, apple/release, apple/resubmit, apple/review-details, apple/status, art, lib/store-apps, listing-store, onboard, validate |
+| `apps_appStoreVersions_getToManyRelated` | GET | `/v1/apps/{id}/appStoreVersions` | read | apple/asc, apple/creative-assets, apple/iap-submit, apple/listing, apple/release, apple/resubmit, apple/review-details, apple/status, art, lib/store-apps, listing-store, onboard, validate |
 | `apps_appStoreVersions_getToManyRelationship` | GET | `/v1/apps/{id}/relationships/appStoreVersions` | read |  |
 | `apps_appTags_getToManyRelated` | GET | `/v1/apps/{id}/appTags` | read |  |
 | `apps_appTags_getToManyRelationship` | GET | `/v1/apps/{id}/relationships/appTags` | read |  |

docs/drafts/header-search-results-announcement.md

@@ -0,0 +1,29 @@
+# Draft: Header and Search Results support (not posted)
+
+## Release tweet
+
+storebound now fills App Store Connect's new Header and Search Results: a 21:9 product page header and a 3:2 search
+results asset per language, image or video, checked locally, uploaded once, selected on the version and added to the
+draft review submission. You still press Submit. `storebound apple creative-assets --dry`
+
+## Announcement
+
+**App Store Header and Search Results, end to end**
+
+Since October 2026, App Store Connect has a Header and Search Results tab next to App Previews and Screenshots. On
+iOS and iPadOS 27 these assets show at the top of the product page and in search results.
+
+`storebound apple creative-assets` handles the whole flow through the App Store Connect API:
+
+- **Checks before upload.** Header 3840 x 1646 (21:9), search results 3:2 (1920 x 1280 up to 3840 x 2560), or one
+  universal 5244 x 2950 PNG for both. No alpha. Videos run 5-30 s at 30 or 60 fps, and search videos play muted.
+- **Upserts into the Asset Library.** Each file goes up once, matched by MD5. Re-runs send nothing. Archived copies are
+  restored instead of uploaded again, and a file App Review rejected is never re-sent.
+- **Selects the assets on the version** once they are processed, as the console's Browse Assets does. No waiting on an
+  approval that only a submission can start.
+- **`--add-for-review`** puts the new assets into the draft review submission, along with your first version or on
+  their own after that. storebound never submits; Submit for Review stays your button.
+- **`--verify`** reads every slot back without writing and fails if a slot does not show your local file.
+
+Dry run by default over MCP (`apple_creative_assets`, `apple_creative_assets_verify`). Google Play has no such slot.
+The feature graphic and promo video are the closest match there.

docs/store-art.md

@@ -98,11 +98,19 @@ Screenshots". Optional: without these assets the App Store uses in-app events, a
   play muted. `apple.creativeAssets.header: false` / `search: false` skips a slot.
 - **Not rendered by `shots render`**: the scene templates are portrait device shots; make the wide art yourself (or from
   the feature graphic artwork at the larger size) and drop it in.
-- **Upload:** `storebound apple creative-assets --dry`, then without `--dry`. Files go into the app's Asset Library
-  (API: `appAssetLibraryImages` / `appAssetLibraryVideos`, category `CREATIVE_ASSETS`); Apple reviews each asset, and
-  only an approved one is selected for the slot (`appAssetLibraryPlacements`, `PRODUCT_PAGE_HEADER_ASSET` /
-  `APP_STORE_SEARCH_RESULTS_ASSET`). Until then the run says "waiting for Apple's approval": re-run later. Same file
-  (MD5) = nothing sent. MCP: `apple_creative_assets` (dry by default).
+- **Upload and select:** `storebound apple creative-assets --dry`, then without `--dry`. Files go into the app's Asset
+  Library (API: `appAssetLibraryImages` / `appAssetLibraryVideos`, category `CREATIVE_ASSETS`), and once processed
+  ("Prepare for Submission", a bounded wait of 2 minutes with a heartbeat) the run selects them for the slots of the
+  editable version (`appAssetLibraryPlacements`, `PRODUCT_PAGE_HEADER_ASSET` / `APP_STORE_SEARCH_RESULTS_ASSET`), as the
+  console's Browse Assets > Save does. Approval is not needed first. Same file (MD5) = nothing sent; an archived copy is
+  unarchived; a file App Review rejected is never uploaded again (change the file). MCP: `apple_creative_assets` (dry by
+  default).
+- **Review:** an asset is reviewed only once it is in a review submission (its own item, `appAssetLibraryImage` /
+  `appAssetLibraryVideo`; the console's "Add for Review"). `--add-for-review` adds the selected, unreviewed assets to the
+  app's draft submission, once: before the first approved version it is the same submission as that version, later
+  they can go alone. Pressing Submit for Review stays the owner's.
+- **Verify:** `storebound apple creative-assets --verify` (MCP `apple_creative_assets_verify`) is read-only: every slot
+  of the editable version (else the live one) shows the local file, with its review state; exit 1 when one differs.
 - **Checks:** `storebound check` and `validate` print an info note when no locale has one.
 - **Play:** no such slot. The feature graphic (1024 x 500, `play images`) and the promo video (YouTube URL) are the
   closest equivalents.