awesome-kubernetes/.github/workflows/03.3.agentic_v2_videos.yml

name: 03.3. V2 Video Hub Builder

on:
  push:
    branches:
      - develop
    paths:
      - 'src/v2_video_portal.py'
      - 'src/enrich_videos.py'
  workflow_run:
    workflows: ["03.2. V2 AI Curator"]
    branches: [develop]
    types:
      - completed
  schedule:
    - cron: '0 6 1 * *'  # Runs on the 1st of every month at 06:00 UTC (every ~30 days)
  workflow_dispatch:
    inputs:
      restore_cache:
        description: 'Restore inventory from cache (Warning: May overwrite recent manual changes)'
        required: false
        type: boolean
        default: false
      force_enrich:
        description: 'Force AI re-enrichment of all videos (ignores cache)'
        required: false
        type: boolean
        default: false

permissions:
  contents: write
  pull-requests: write

concurrency:
  group: develop-git-write-lock
  cancel-in-progress: false

jobs:
  build-video-hub:
    runs-on: ubuntu-latest
    if: |
      github.event_name != 'workflow_run' || 
      github.event.workflow_run.conclusion == 'success'
    steps:
      - name: Repository Synchronization
        uses: actions/checkout@v7
        with:
          ref: develop

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

      - name: Restore Incremental Inventory Cache
        if: ${{ github.event.inputs.restore_cache == 'true' }}
        uses: actions/cache/restore@v6
        with:
          path: data/inventory.yaml
          key: inventory-v2-${{ github.run_id }}-${{ github.run_attempt }}
          restore-keys: |
            inventory-v2-

      - name: Dependency Installation
        run: |
          python -m pip install --upgrade pip
          pip install pyyaml httpx tenacity pytz python-dotenv yt-dlp youtube-transcript-api

      - name: Execute Video Hub Enrichment
        env:
          PYTHONPATH: ${{ github.workspace }}
          GEMINI_API_KEY_1: ${{ secrets.GEMINI_API_KEY_1 }}
          YOUTUBE_API_KEY: ${{ secrets.YOUTUBE_API_KEY }}
          FORCE_ENRICH: ${{ github.event.inputs.force_enrich || 'false' }}
        run: |
          python src/enrich_videos.py

      - name: Execute Video Portal Generator
        run: |
          export PYTHONPATH=$PYTHONPATH:.
          python src/v2_video_portal.py

      - name: Commit and Push Video Hub Updates
        run: |
          git config --global user.name "Nubenetes Bot"
          git config --global user.email "bot@nubenetes.com"
          git add data/inventory.yaml data/inventory.sql v2-docs/videos/
          if git diff --staged --quiet; then
            echo "No automated changes to commit."
          else
            git commit -m "docs: update Video Hub with high-fidelity metadata"
            # Retry rebase+push to survive concurrent bot pushes to develop.
            for i in {1..5}; do
              git pull origin develop --rebase && git push origin develop && exit 0
              echo "Push attempt $i/5 rejected — retrying..."; sleep $((i * 3))
            done
            echo "::error::Video Hub push failed after 5 attempts."; exit 1
          fi

      - name: Persist Incremental Inventory Cache
        if: always()
        uses: actions/cache/save@v6
        with:
          path: data/inventory.yaml
          key: inventory-v2-${{ github.run_id }}-${{ github.run_attempt }}