Dokümanları Güncelle

name: Update Docs

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

permissions:
  contents: write
  pull-requests: write

jobs:
  auto-docs:
    if: ${{ !startsWith(github.head_ref, 'docs/') }}
    runs-on: ubuntu-latest
    steps:
      - name: Depoyu checkout et
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Cursor CLI'yi kur
        run: |
          curl https://cursor.com/install -fsS | bash
          echo "$HOME/.cursor/bin" >> $GITHUB_PATH

      - name: Git'i yapılandır
        run: |
          git config user.name "Cursor Agent"
          git config user.email "cursoragent@cursor.com"

      - name: Dokümanları güncelle
        env:
          MODEL: gpt-5
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH_PREFIX: docs
        run: |
          cursor-agent -p "Şu anda bir GitHub Actions runner'ında çalışıyorsun.

          GitHub CLI `gh` olarak mevcut ve `GH_TOKEN` ile kimlik doğrulaması yapılmış. Git mevcut. Depo içeriğine yazma iznin var ve pull request'lere yorum bırakabilirsin, ancak PR oluşturamaz veya düzenleyemezsin.

          # Bağlam:
          - Repo: ${{ github.repository }}
          - Sahip: ${{ github.repository_owner }}
          - PR Numarası: ${{ github.event.pull_request.number }}
          - Base Ref: ${{ github.base_ref }}
          - Head Ref: ${{ github.head_ref }}
          - Docs Dal Öneki: ${{ env.BRANCH_PREFIX }}

          # Amaç:
          - Orijinal PR'deki artımsal değişikliklerle yönlendirilen uçtan uca bir doküman güncelleme akışı uygula.

          # Gereksinimler:
          1) Orijinal PR'de nelerin değiştiğini belirle ve birden fazla push varsa, son başarılı doküman güncellemesinden bu yana artımsal diffları hesapla.
          2) Yalnızca bu artımsal değişikliklere dayalı ilgili dokümanları güncelle.
          3) Bağlamdaki Docs Dal Öneki'ni kullanarak bu PR head'i için kalıcı doküman dalını koru. Yoksa oluştur, varsa güncelle ve değişiklikleri origin'e pushla.
          4) PR oluşturma iznin YOK. Bunun yerine, doküman güncellemelerini kısaca açıklayan ve hızlı PR oluşturmak için satır içi bir karşılaştırma bağlantısı içeren tek bir doğal dil PR yorumunu (1–2 cümle) gönder veya güncelle.

          # Girdiler ve kurallar:
          - Değişiklikleri tespit etmek ve son doküman güncellemesinden bu yana artımsal aralıkları çıkarmak için `gh pr diff` ve git geçmişini kullan.
          - PR'ları doğrudan oluşturmaya ya da düzenlemeye çalışma. Yukarıdaki karşılaştırma bağlantısı formatını kullan.
          - Değişiklikleri minimal tut ve depo stiline uygun kal. Gerekli bir doküman güncellemesi yoksa, hiçbir değişiklik yapma ve yorum bırakma.

          # Güncellemeler olduğunda çıktılar:
          - Bu PR head'i için kalıcı doküman dalına pushlanmış commit'ler.
          - Yukarıdaki satır içi karşılaştırma bağlantısını içeren, orijinal PR üzerinde tek bir doğal dil PR yorumu. Yinelenen yorumlardan kaçın; varsa önceki bot yorumunu güncelle.
          " --force --model "$MODEL" --output-format=text