refresh-descriptions.yml

name: Refresh CoinGecko descriptions

# Rationale: descriptions.json is committed (not regenerated in the pages build)
# to avoid CI flakiness from CoinGecko availability. This monthly cron fetches
# fresh descriptions and opens a PR so a human can review the diff before merge.
# The PR branch is reset each run so stale PRs don't accumulate.

on:
  schedule:
    - cron: "0 6 1 * *"   # 1st of month, 06:00 UTC
  workflow_dispatch:

permissions:
  contents: write
  pull-requests: write

jobs:
  refresh:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"
          cache: "pip"

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Fetch fresh CoinGecko descriptions
        run: python scripts/fetch_descriptions.py --force-refetch
        env:
          PYTHONUNBUFFERED: "1"

      - name: Open PR with updated descriptions
        uses: peter-evans/create-pull-request@v6
        with:
          commit-message: "data: refresh CoinGecko descriptions"
          title: "Monthly: refresh CoinGecko descriptions"
          body: |
            Automated monthly refresh of `data/descriptions.json` from CoinGecko API v3.

            Review the diff:
            - New assets that now have descriptions
            - Assets whose descriptions changed significantly
            - Assets still missing (ok=false) — may need manual CoinGecko id fix

            Check `data/descriptions.MISSING.txt` for the full miss list.

            Do not merge until you have reviewed the diff. If any description looks
            wrong (wrong coin, marketing copy, stale), fix in `scripts/fetch_descriptions.py`
            (update `CG_ID_OVERRIDES` or `KNOWN_NO_DESCRIPTION`) and push to this branch.
          branch: refresh/descriptions
          delete-branch: false
          labels: "data, automated"