awesome-kubernetes/.github/workflows/readme_sync.yml

name: Nubenetes README Automated Sync

on:
  push:
    branches:
      - develop
    paths-ignore:
      - 'README.md'
  workflow_dispatch: # Permite ejecución manual desde la pestaña Actions

permissions:
  contents: write

concurrency:
  group: readme-sync-${{ github.ref }}
  cancel-in-progress: true

jobs:
  sync-readme:
    runs-on: ubuntu-latest
    if: |
      !contains(github.event.head_commit.message, '[skip ci]') && 
      !contains(github.event.head_commit.message, 'bot/v2-elite-sync') && 
      !contains(github.event.head_commit.message, 'bot/knowledge-update')
    steps:
      - name: Repository Synchronization
        uses: actions/checkout@v6
        with:
          fetch-depth: 0 # Full history for commit stats

      - name: Python 3.11 Environment Provisioning
        uses: actions/setup-python@v6
        with:
          python-version: '3.11'

      - name: Install Dependencies
        run: |
          python -m pip install --upgrade pip
          pip install pyyaml pytz python-dotenv

      - name: Execute README Metric Updater
        run: |
          export PYTHONPATH=$PYTHONPATH:.
          python src/readme_updater.py

      - name: Validate README Integrity (Guardrail)
        run: |
          export PYTHONPATH=$PYTHONPATH:.
          python src/safety_readme.py

      - name: Commit and Push README Updates
        run: |
          git config --global user.name "Nubenetes Bot"
          git config --global user.email "bot@nubenetes.com"
          git add README.md
          if git diff --staged --quiet; then
            echo "No changes in README.md to commit."
          else
            git commit -m "docs: automated README metric synchronization [skip ci]"
            git push origin develop
          fi