Dokümanları Güncelle

name: Belgeleri Güncelle

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: Belgeleri 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 "Bir GitHub Actions runner'ında çalışıyorsun.

          GitHub CLI, GH_TOKEN ile kimlik doğrulaması yapılmış `gh` olarak mevcut. Git kullanılabilir. Depo içeriğine yazma iznin var ve pull request'lere yorum yapabilirsin, 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ımlı değişiklikler tarafından yönlendirilen uçtan uca bir belge güncelleme akışı uygula.

          # Gereksinimler:
          1) Orijinal PR'de nelerin değiştiğini belirle ve birden fazla push olduysa, son başarılı belge güncellemesinden bu yana olan artımlı diff'leri hesapla.
          2) Yalnızca bu artımlı değişikliklere göre ilgili belgeleri güncelle.
          3) Bağlamdaki Docs Dal Öneki'ni kullanarak bu PR head'i için kalıcı belge dalını koru. Yoksa oluştur, varsa güncelle ve değişiklikleri origin'e push et.
          4) PR oluşturma iznin YOK. Bunun yerine, belge 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 yorumu (1–2 cümle) gönder veya güncelle.

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

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