gplay-metadata-synclisted
Install: claude install-skill PollyGlot/google-play-cli-skills
# gplay metadata sync (listings + images)
Manage the store front: per-locale listing **text** and **images**, kept as an
on-disk tree and reconciled with Play. Shared conventions are in
`gplay-cli-usage`.
## The sync model
gplay treats a local `./metadata` tree as the desired state and reconciles it
with Play (ADR-0011). The loop:
```
pull → edit on disk → validate (offline) → apply --dry-run → apply --confirm
```
On disk, text is `<locale>/<field>.txt` (`title`, `short_description`,
`full_description`, `video`). Images sit under `<locale>/images/`: a singular
slot (`icon`, `featureGraphic`, `tvBanner`) is
`<type>.<ext>`; a gallery slot (the `*Screenshots` types) is
`<type>/1.<ext>…N.<ext>` in display order. Google retired `promoGraphic`:
a leftover `images/promoGraphic.*` (common in Fastlane `supply` trees) is
never uploaded, and `metadata images validate`/`images apply` warn with
its path, so delete the file.
- **`metadata pull`** copies the live Listings into the tree; additive, so
`pull` then `apply` is a no-op.
- **`metadata validate`** lints the tree offline (no auth, no network); any
violation exits `20`, so it fits a pre-commit hook or CI gate.
- **`metadata apply`** reconciles disk → Play, additive by default; `--prune`
is the destructive opt-in (read `apply --help` before using it).
- **`metadata list`** summarizes what is live on Play, per locale.
## Apply safely
```bash
gplay metadata pull --dir ./metadata
# …edit the .txt files…
gplay metada