diff --git a/README.md b/README.md index 3e88723..98a0aa1 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,30 @@ Dallar kalabalıklaştıkça şerit sayısı sınırsız artar, omurga düğüml ## Öne çıkanlar +### Merge kuyruğu: korumalı repoda birden çok PR'ı tek onayla birleştirme +Korumalı `main`'de ("dal güncel olmalı" + zorunlu CI) AI ajanlarının veya ekibin açtığı birçok PR'ı tek tek güncelleyip beklemek yorucudur. `🚦 Kuyruk` penceresi bunu üç kademede çözer: + +1. **Plan (salt okunur):** Seçtiğiniz PR'ları sırayla `main`'e birleştirilmiş gibi bellekte simüle eder (`git merge-tree`); çalışma ağacınıza, indekse ve ref'lere dokunmaz. Hangi PR'ın çakıştığını, kuyruğun nerede durduğunu ve tahmini CI tur sayısını söyler. +2. **Adım adım:** Sıradaki PR için `update` (dalı `main`'e göre güncelle, uzak PR dalına push) / `merge` / `wait` / `blocked` kararını gösterir; siz onaylayınca TEK adımı uygular. +3. **Otomatik koşu:** Planı onaylarsanız sunucu arka planda her PR için güncelle → CI yeşil olana kadar bekle → `--match-head-commit` ile birleştir → sıradakine geç. **İlk sorunda durur** (çakışma, kırmızı CI, inceleme engeli, dışarıdan değişen dal ucu, zaman aşımı). GitArc kapanırsa koşu kendiliğinden devam etmez. + +Kartlarda koşudaki PR'lar `🚦 Kuyrukta 2/5` / `⏳ İşleniyor · CI bekleniyor` etiketi taşır; işlenen PR'a sarı kesik bir "birleşecek" oku çizilir. CI bilinmiyorsa yeşil **varsayılmaz**; koruma atlatılmaz (`--admin` yok). + +![Kuyruk koşusu: işlenen PR'da etiket ve "birleşecek" hedef çizgisi](docs/screenshots/kuyruk-isleniyor.webp) + +**Tekil PR için de aynı yol:** `⏳ CI Bitince Merge Et` artık sunucuda 1 PR'lık bir koşu başlatır (sayfayı yenileseniz de sürer; ikinci tıklama durdurur). Dal `main`'in gerisinde kaldıysa düğme `↻ Güncelle & Birleştir` olur ve aynı 1 PR'lık koşuyu planlar. Koşu yalnızca **merge commit** yapar. + +### Dal koruması (`main Korumalı`) +`🛡 main Korumalı` düğmesi korumanın durumunu (`Aktif` / `Korumasız` / `Bilinmiyor`) ayrı ayrı gösterir; okunamayan koruma "yok" sayılmaz. Plan **yalnızca güçlendirir**, yönetmediği alanları korur, parmak iziyle onaylanınca uygular. + +### Yerel kalıntılar ve yeni yerel dallar +Pushlanmamış yeni dal alt yarı-kürede mor kesikli yay olarak durur (`Yarım Parabol · Local`, `🚀 Push & PR`). Uzakta birleşmiş ama yerelde duran dallar `💻 Local` rozetiyle ve `🧹` düğmesiyle kalıntı olarak işaretlenir; tamamen temiz yeşil kapsüllerde temizleme düğmesi gösterilmez. + +![Yerel yarım parabol, Push & PR ve yerel kalıntı kapsülü](docs/screenshots/yerel-dal-ve-kalinti.webp) + +### Son İşlemler ve işlem hataları +Alt çekmecedeki **Son İşlemler** sekmesi başarıyla tamamlanan işlemleri, **Hata Radarı** ise reddedilen yazan işlemleri (ör. `Merge başarısız`) kapatılabilir kartlar olarak, tekrar sayacıyla gösterir. Kuyruk koşusunun durması kritik karttır. + ### Hata Radarı ve alt çekmece CI hatası, çakışma, Cross-PR dosya çarpışması ve `origin: gone` kalıntıları tam genişlikte kartlarla listelenir. Kartlar etkilenen dosyaları, ayıklanmış CI hata logunu, kopyalanabilir terminal komutunu ve tek tıkla eylemleri (`CI Hatasını Gör`, `Çakışma Stüdyosu`, `Dalı Temizle`) içerir. @@ -58,7 +82,7 @@ Birleşmiş bir dalı seçince GitHub'daki gerçek PR başlığı, açıklaması - **Hata geçirmezlik:** Ön koşulları kullanıcıya yüklemez, güvenli olduğunda kendisi çözer (silinecek dal aktifse `main`'e geçer, kirli ağaçla `Push & PR` basılırsa önce commit atar). Boş dalı GitHub'a göndermeden önce yerelde durdurur. - **Taze yerel dal ayrımı:** `main`'e göre commit'i olmayan yeni dallar yanlışlıkla "silinmiş kalıntı" sayılmaz, `🌱 Yeni Yerel Dal` olarak gösterilir. - **Konsolsuz commit & PR:** Kirli çalışma ağacını yeni dala alıp commit mesajı, PR başlığı ve açıklamasıyla tek tıkla push + PR açar. -- **CI çalışırken merge kuyruğu:** `CI: RUNNING` iken Merge'e basılırsa dal kuyruğa alınır, CI geçince otomatik birleşir, başarısız olursa iptal edilir. +- **CI çalışırken otomatik merge:** `CI: RUNNING` iken `⏳ CI Bitince Merge Et` sunucuda 1 PR'lık koşu başlatır (yukarıdaki Merge kuyruğu); CI başarısız olursa koşu durur. - **Merge stratejileri:** `Merge`, `Squash`, `Rebase` ve `--auto` (Merge Queue). - **PR başlık/açıklama ve son commit mesajı düzenleme** (`gh pr edit`, `git commit --amend --only`). - **Mega-repo ölçekleme:** SHA-bazlı değerlendirme önbelleği, 40 dallık sıralı pencere, ters indeksli Cross-PR motoru, `👤 Benim Dallarım`, klasör/dosya merceği. @@ -66,6 +90,26 @@ Birleşmiş bir dalı seçince GitHub'daki gerçek PR başlığı, açıklaması - **Çoklu proje:** Yerel Git depolarını ekleyip üst çubuktan seçebilirsiniz (`~/.gitarc/projects.json`). - **Sunucusuz çalışma:** `web/index.html` doğrudan tarayıcıda açılırsa yerleşik `LocalFallbackEngine` ile simülasyon modunda çalışır. +## Kullanım senaryoları + +**1. Günlük tek geliştirici akışı.** Klasörde `./gitarc` çalıştırın. Kirli dosyalarla bir dal açıp commit mesajı, PR başlığı ve açıklamasıyla `Push & PR` basın; GitArc önce commit atar, `go vet` gibi yerel doğrulamayı çalıştırır, boş dalı göndermez. PR'ın CI'ı sürerken `⏳ CI Bitince Merge Et` deyip başka işe geçin; CI yeşil olunca birleşir. + +**2. AI ajanları PR yağdırıyor (korumalı repo).** Ajanlar 5 PR açtı; her biri `main`'in gerisinde ve CI bekliyor. `🚦 Kuyruk` → PR'ları seçin → planı okuyun (çakışan varsa nedeniyle birlikte görünür) → `▶ Kuyruğu çalıştır` ve onaylayın. Sunucu sırayla günceller, CI'ı bekler, birleştirir; çakışma ya da kırmızı CI'da durup Hata Radarı'nda size söyler. Siz sadece planı onaylarsınız. + +**3. Tek bir PR geride kaldı.** Başka bir PR birleşince sizin PR'ınız "dal güncel olmalı" yüzünden birleşemez. Kartta `↻ Güncelle & Birleştir` çıkar: tek onayla dal `main`'e göre güncellenir, CI beklenir, birleştirilir. + +**4. Çakışma çıktı.** `Çakışma Stüdyosu`'nu açın: dosya türüne göre önerilen strateji (`union`/`ours`/`theirs`/elle) seçilir, çözüm izole bir worktree'de hazırlanır ve çalışma ağacınıza dokunmadan doğrulanıp pushlanır. + +**5. Temizlik.** Birleşen PR'lardan arta kalan yerel/uzak dalları `🧹 Temizle` ile tek tıkla silin; uzun ömürlü dallar (`develop`, `release/*`) korunur, sahte konuma çizilen parabol yoktur (`🗂 Geçmiş`). + +**6. Kaç PR'ın hangi aşamada olduğuna bakmak.** Üst çubuktaki `main CI`, `main Korumalı` ve süzgeç çipleri ile Hata Radarı; CI'ı kırmızı olanı, çakışanı ve iki PR'ın aynı dosyaya dokunduğu Cross-PR çarpışmasını tek bakışta gösterir. + +**7. AI ajanından yönetmek (MCP).** `gitarc -mcp` ile ajanınız durumu okur (`gitarc_status`), planı çıkarır (`gitarc_queue_run_plan`) ve size gösterir. Geri alınması zor işlemler (`gitarc_queue_run`, `gitarc_update_branch`, `gitarc_resolve_conflict`, koruma) varsayılan KAPALIDIR; ilgili `GITARC_MCP_ALLOW_*` ortam değişkeni ve plan `fingerprint`'i olmadan çalışmaz. + +**8. Paylaşılan sunucu.** `gitarc -team` ile paylaşılan `HEAD`'i değiştiren işlemler (dal değiştirme, amend, commit) kilitlenir; izole worktree çözümü ve PR işlemleri çalışır. + +**9. Denemek ve öğrenmek.** Gerçek depoya dokunmadan `./gitarc -repo sim` ile demo verisi açın. Kuyruğu gerçek GitHub'da güvenle denemek için kendi boş bir deneme deponuzda `scripts/deneme-pr.sh` ile istediğiniz sayıda deneme dalı/PR üretin (`-m local` yalnızca yerel dal, `-m remote` push + PR; betik yalnızca adında `gitarc-kuyruk-deneme` geçen depoda çalışır). + ## Hızlı başlangıç Gereksinimler: Go (sürüm `go.mod` içinde), `git`. GitHub özellikleri (PR, CI, branch protection) için [`gh` CLI](https://cli.github.com/) kurulu ve oturum açılmış olmalıdır; `gh` yoksa (veya uzak depo GitHub değilse) PR/CI/koruma bilgisi gösterilmez, yerel Git özellikleri çalışmaya devam eder. diff --git a/docs/screenshots/kuyruk-isleniyor.webp b/docs/screenshots/kuyruk-isleniyor.webp new file mode 100644 index 0000000..71c3cc5 Binary files /dev/null and b/docs/screenshots/kuyruk-isleniyor.webp differ diff --git a/docs/screenshots/yerel-dal-ve-kalinti.webp b/docs/screenshots/yerel-dal-ve-kalinti.webp new file mode 100644 index 0000000..a5ffe71 Binary files /dev/null and b/docs/screenshots/yerel-dal-ve-kalinti.webp differ diff --git a/scripts/deneme-pr.sh b/scripts/deneme-pr.sh new file mode 100755 index 0000000..39a8cd9 --- /dev/null +++ b/scripts/deneme-pr.sh @@ -0,0 +1,62 @@ +#!/usr/bin/env bash +# GitArc deneme deposuna istediğin kadar deneme dalı/PR üretir. +# Yerelde aç : yalnızca yerel dal + commit (push YOK; GitArc'ta "Yeni Yerel Dal" görünür) +# Uzakta aç : dal push edilir + GitHub'da PR açılır (merge ETMEZ) +# Kullanım: ./scripts/deneme-pr.sh (sorar) +# ./scripts/deneme-pr.sh -n 5 -m remote (m: local | remote) +# REPO=/baska/yol ./scripts/deneme-pr.sh +set -euo pipefail + +REPO="${REPO:-$HOME/Developer/gitarc-kuyruk-deneme}" +N=""; MODE="" +while getopts "n:m:h" o; do + case $o in + n) N="$OPTARG" ;; + m) MODE="$OPTARG" ;; + *) sed -n '2,9p' "$0"; exit 0 ;; + esac +done + +cd "$REPO" || { echo "Depo bulunamadı: $REPO" >&2; exit 1; } +# Yanlışlıkla gerçek bir depoya PR yağdırmamak için yalnızca deneme deposunda çalışır. +if ! git remote get-url origin | grep -q "gitarc-kuyruk-deneme"; then + echo "Bu betik yalnızca gitarc-kuyruk-deneme deposu için. origin: $(git remote get-url origin)" >&2; exit 1 +fi +if [ -n "$(git status --porcelain)" ]; then + echo "Çalışma ağacı kirli; önce commit/stash edin." >&2; exit 1 +fi + +if [ -z "$N" ]; then read -r -p "Kaç PR/dal? " N; fi +case "$N" in ''|*[!0-9]*) echo "Geçerli bir sayı girin." >&2; exit 1 ;; esac +[ "$N" -ge 1 ] || { echo "En az 1." >&2; exit 1; } +if [ -z "$MODE" ]; then + echo "1) Yerelde aç (push yok)"; echo "2) Uzakta aç (push + PR)" + read -r -p "Seçim [1/2]: " c + case "$c" in 1) MODE=local ;; 2) MODE=remote ;; *) echo "1 ya da 2." >&2; exit 1 ;; esac +fi +case "$MODE" in local|remote) ;; *) echo "-m local ya da remote olmalı." >&2; exit 1 ;; esac +if [ "$MODE" = remote ]; then command -v gh >/dev/null || { echo "gh gerekli." >&2; exit 1; }; fi + +git fetch -q origin +START="$(git rev-parse --abbrev-ref HEAD)" +STAMP="$(date +%m%d-%H%M%S)" +made=0 +for i in $(seq 1 "$N"); do + ID="d${STAMP}-${i}" + BR="feat/${ID}" + # Her dal ayrı bir dosyayı değiştirir: dallar birbiriyle çakışmaz. + git checkout -q -b "$BR" origin/main + echo "$ID" > "deneme-${ID}.txt" + git add "deneme-${ID}.txt" + git commit -q -m "feat: deneme-${ID} ekle" + if [ "$MODE" = remote ]; then + git push -q -u origin "$BR" 2>/dev/null + URL="$(gh pr create --base main --head "$BR" --title "feat: deneme-${ID} ekle (deneme)" --body "GitArc deneme PR'ı (otomatik üretildi).")" + echo "✓ $BR → $URL" + else + echo "✓ $BR (yerel)" + fi + made=$((made+1)) +done +git checkout -q "$START" +echo "Bitti: $made $([ "$MODE" = remote ] && echo 'PR açıldı' || echo 'yerel dal oluşturuldu')."