update-readme.yml

name: Auto‑update README TOC

permissions:
  contents: write

on:
  push:
    paths:
      - '*/**'
      - '.github/workflows/update-readme.yml'
      - 'scripts/order.py'

jobs:
  regen-readme:
    runs-on: ubuntu-latest

    steps:
      - name: 🛎️ Checkout
        uses: actions/checkout@v4
        with:
          persist-credentials: true
          token: ${{ secrets.GITHUB_TOKEN }}

      - name: 🐍 Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.x'

      - name: ⚙️ Generate TOC
        run: python3 scripts/order.py

      - name: Commit & Push if changed
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "actions@github.com"
          git add README.md
          if ! git diff --staged --quiet; then
            git commit -m "chore: auto‑update README TOC"
            git push
          else
            echo "README.md already up to date."
          fi
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}