diff --git a/CHANGELOG.md b/CHANGELOG.md index 0e3ce68..9ff32a5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,12 @@ Bu proje [Keep a Changelog](https://keepachangelog.com/tr/1.0.0/) biçimini ve S ## [Yayımlanmamış] +### Belgeler +- **README görselleri yenilendi:** Tüm ekran görüntüleri güncel arayüzle (demo verisiyle) yeniden çekildi ve tarayıcı penceresi çerçevesine alınmış tek dosyalık SVG oldu (`scripts/ekran-cercevesi.py`; çekim: `tests/e2e/ekran-goruntuleri.mjs`). Eski `.webp` görüntüler kişisel tarayıcı sekmelerini/yer imlerini gösteriyordu; kaldırıldı. Merge Kuyruğu, Dal koruması ve MCP pencereleri için yeni görseller; "Kuyrukta biri kırmızı yandı" senaryosu eklendi. + +### Düzeltilenler +- **Sürüm rozeti başlığı yukarı itiyordu:** `topbar.js` düğmenin `className`'ini yeniden yazdığı için `.brand-ver` sınıf kuralı hiç uygulanmıyordu (rozet 28 px, başlık çubuğun kenarına yapışıyordu); kural konuma (`.brand-sub-row > button`) bağlandı. + ### Değişenler - **Üst çubuk kompakt:** Başlık `GitArc` (Arc yeşil, "SVG" kaldırıldı); sürüm rozeti başlığın altına taşındı; `Proje Ekle`, `Birleşmiş Paraboller`, `Tur` kısaltıldı: 1280 px'te sığar. - **MCP penceresi artık gerçek yapılandırmayı üretir:** `command` açık projenin klasörü yerine çalışan GitArc ikilisinin yolu (`RepoMeta.execPath`) olur (eskiden başka bir proje açıkken var olmayan `/gitarc` yazılıyordu); uzağa yazan 5 aracın her biri için onay kutusu var, işaretlenenler yapılandırmaya `env` olarak girer (varsayılan hepsi kapalı). diff --git a/README.md b/README.md index 98a0aa1..0938c72 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ **GitArc**, düz `git log` ağaçları yerine Git ve GitHub yaşam döngüsünü **parabolik ray topolojisiyle** gösteren, sıfır bağımlılıklı bir yerel kokpittir. Yerel dallarınızı (`HEAD`, uncommitted dosyalar, `origin` farkları) ile GitHub Remote, Pull Request, Review ve GitHub Actions CI durumlarını tek bir SVG tuvalinde birleştirir. [KeyLab (`sshpocket`)](https://github.com/syhgorath/keylab) tasarım ve güvenlik DNA'sını paylaşan bağımsız bir kardeş projedir. -![GitArc kokpiti: parabolik raylar, KPI çipleri ve alt çekmece](docs/screenshots/kokpit.png) +![GitArc kokpiti: parabolik raylar, KPI çipleri ve alt çekmece](docs/screenshots/kokpit.svg) ## Parabolik metafor @@ -32,17 +32,18 @@ Korumalı `main`'de ("dal güncel olmalı" + zorunlu CI) AI ajanlarının veya e 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) +![Merge Kuyruğu penceresi: plan, çakışma ve CI durumu PR başına](docs/screenshots/kuyruk.svg) **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. +![Dal koruması penceresi: Şu an → Profil → Değişecekler](docs/screenshots/koruma.svg) + ### 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. @@ -55,7 +56,7 @@ CI hatası, çakışma, Cross-PR dosya çarpışması ve `origin: gone` kalınt ### Birleşmiş PR'ın tam detayı ve dosya dosya diff Birleşmiş bir dalı seçince GitHub'daki gerçek PR başlığı, açıklaması ve yazarı görünür; **Değişen Dosyalar** kartı her dosyayı durumu (`A`/`M`/`D`) ve `+eklenen / -silinen` satırlarıyla listeler. Bir dosyaya tıklamak, birleşme commit'inin getirdiği değişiklikleri dosya dosya gösteren tam diff penceresini açar (dal çoktan silinmiş olsa bile). -![Birleşmiş PR detayı ve değişen dosyalar](docs/screenshots/birlesmis-pr-detay.png) +![Birleşmiş PR detayı ve değişen dosyalar](docs/screenshots/birlesmis-pr-detay.svg) ### Merge sonrası `main` testleri Üst çubuktaki `main CI` rozeti, birleştirdikten sonra omurgada çalışan testin sonucunu gösterir (`⏳ koşuyor` / `✓` / `❌ kırık`). Kırılırsa Hata Radarı'nda kritik bir kart belirir. Veri okunamıyorsa rozet gizlenir; GitArc hiçbir yerde sahte yeşil göstermez. @@ -63,17 +64,17 @@ Birleşmiş bir dalı seçince GitHub'daki gerçek PR başlığı, açıklaması ### Çakışma Çözüm Stüdyosu Çakışan dosyalar sol tarafta (**şu an olan**) gerçek 3 yollu `git merge-file` blokları, sağ tarafta (**olacak olan**) canlı önizleme olarak yan yana gösterilir. Dosya türüne göre `★ ÖNERİLEN` strateji sunulur: `union`, `ours`, `theirs` veya elle/AI düzenleme. Çözüm, çalışma ağacınıza dokunmadan geçici bir `git worktree` içinde uygulanır; `go.mod` varsa `go vet ./...` geçmeden pushlanmaz. -![Çakışma Çözüm Stüdyosu](docs/screenshots/cakisma-studyosu.png) +![Çakışma Çözüm Stüdyosu](docs/screenshots/cakisma-studyosu.svg) ### Etkileşimli tur `🎓 Tur` düğmesi, kokpitin bölümlerini adım adım tanıtan 5 adımlı bir rehber açar. -![Kokpit turu](docs/screenshots/kokpit-turu.png) +![Kokpit turu](docs/screenshots/kokpit-turu.svg) ### Açık ve koyu tema `◐` düğmesi temayı değiştirir; tüm paneller, stüdyo ve terminal kutuları iki temada da okunur. -![Açık tema](docs/screenshots/acik-tema.png) +![Açık tema](docs/screenshots/acik-tema.svg) ### Diğer yetenekler - **Omurga dalı seçimi:** Varsayılan dal `origin/HEAD`'den bulunur (git-flow'da `develop` olabilir); yanlışsa `⚙` ile elle seçilir ve projeye kaydedilir. @@ -96,6 +97,8 @@ Birleşmiş bir dalı seçince GitHub'daki gerçek PR başlığı, açıklaması **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. +**2b. Kuyrukta biri kırmızı yandı.** Koşu o PR'a sıra gelince durur (öncekiler zaten birleşmiştir); `Kuyruk` penceresi nedeni yazar, Hata Radarı'nda kritik kart düşer. `🔍 CI Hatasını Gör` ile ayıklanmış log ve yerel repro komutunu görün (AI ajanında `gitarc_ci_failure_digest`), kırmızı PR'ın dalına geçip düzeltmeyi push edin (ya da geçici bir hataysa GitHub'da CI'ı yeniden çalıştırın). Sonra `🚦 Kuyruk`'u açın: düzelttiyseniz PR seçili kalsın; beklemeden devam etmek istiyorsanız kutusunu kaldırıp kalanlarla `▶ Kuyruğu çalıştır`. Her birleşme sonrası sıradaki PR `main`'in gerisinde kalıp yeniden güncellenir ve CI yeniden koşar; kırmızı PR güncelleyince yeşile dönebilir. + **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. @@ -141,6 +144,10 @@ Demo verisi yalnızca bilerek istenince açılır: `./gitarc -repo sim`. Demo de ## MCP entegrasyonu (AI ajanları) +Arayüzdeki `🔌 MCP` düğmesi yapılandırmayı (çalışan GitArc ikilisinin yoluyla) üretir; uzağa yazan araçları onay kutusuyla açıp `env` olarak ekleyebilirsiniz: + +![MCP penceresi: yapılandırma ve araç grupları](docs/screenshots/mcp.svg) + `./gitarc -mcp -repo .` komutu, sıfır bağımlılıklı bir `stdio` JSON-RPC 2.0 sunucusu açar (Claude Code, Cursor, Antigravity vb.): | Araç | Ne yapar | diff --git a/docs/screenshots/acik-tema.png b/docs/screenshots/acik-tema.png deleted file mode 100644 index b4fd85c..0000000 Binary files a/docs/screenshots/acik-tema.png and /dev/null differ diff --git a/docs/screenshots/acik-tema.svg b/docs/screenshots/acik-tema.svg new file mode 100644 index 0000000..86fe8f0 --- /dev/null +++ b/docs/screenshots/acik-tema.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/birlesmis-pr-detay.png b/docs/screenshots/birlesmis-pr-detay.png deleted file mode 100644 index 3800a97..0000000 Binary files a/docs/screenshots/birlesmis-pr-detay.png and /dev/null differ diff --git a/docs/screenshots/birlesmis-pr-detay.svg b/docs/screenshots/birlesmis-pr-detay.svg new file mode 100644 index 0000000..56f0c0c --- /dev/null +++ b/docs/screenshots/birlesmis-pr-detay.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/cakisma-studyosu.png b/docs/screenshots/cakisma-studyosu.png deleted file mode 100644 index b4df655..0000000 Binary files a/docs/screenshots/cakisma-studyosu.png and /dev/null differ diff --git a/docs/screenshots/cakisma-studyosu.svg b/docs/screenshots/cakisma-studyosu.svg new file mode 100644 index 0000000..bf58782 --- /dev/null +++ b/docs/screenshots/cakisma-studyosu.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/hata-radari.png b/docs/screenshots/hata-radari.png index 425f9cb..472eb1e 100644 Binary files a/docs/screenshots/hata-radari.png and b/docs/screenshots/hata-radari.png differ diff --git a/docs/screenshots/kokpit-turu.png b/docs/screenshots/kokpit-turu.png deleted file mode 100644 index 54627a9..0000000 Binary files a/docs/screenshots/kokpit-turu.png and /dev/null differ diff --git a/docs/screenshots/kokpit-turu.svg b/docs/screenshots/kokpit-turu.svg new file mode 100644 index 0000000..01125dd --- /dev/null +++ b/docs/screenshots/kokpit-turu.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/kokpit.png b/docs/screenshots/kokpit.png deleted file mode 100644 index 9b0029e..0000000 Binary files a/docs/screenshots/kokpit.png and /dev/null differ diff --git a/docs/screenshots/kokpit.svg b/docs/screenshots/kokpit.svg new file mode 100644 index 0000000..1595f41 --- /dev/null +++ b/docs/screenshots/kokpit.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/koruma.svg b/docs/screenshots/koruma.svg new file mode 100644 index 0000000..def35fa --- /dev/null +++ b/docs/screenshots/koruma.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/kuyruk-isleniyor.webp b/docs/screenshots/kuyruk-isleniyor.webp deleted file mode 100644 index 71c3cc5..0000000 Binary files a/docs/screenshots/kuyruk-isleniyor.webp and /dev/null differ diff --git a/docs/screenshots/kuyruk.svg b/docs/screenshots/kuyruk.svg new file mode 100644 index 0000000..80ee5d8 --- /dev/null +++ b/docs/screenshots/kuyruk.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/mcp.svg b/docs/screenshots/mcp.svg new file mode 100644 index 0000000..c3b6084 --- /dev/null +++ b/docs/screenshots/mcp.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + 🔒 127.0.0.1:7432 + + + + diff --git a/docs/screenshots/ust-cubuk-ve-cipler.png b/docs/screenshots/ust-cubuk-ve-cipler.png index 5df1a20..7ecb4d9 100644 Binary files a/docs/screenshots/ust-cubuk-ve-cipler.png and b/docs/screenshots/ust-cubuk-ve-cipler.png differ diff --git a/docs/screenshots/yerel-dal-ve-kalinti.webp b/docs/screenshots/yerel-dal-ve-kalinti.webp deleted file mode 100644 index a5ffe71..0000000 Binary files a/docs/screenshots/yerel-dal-ve-kalinti.webp and /dev/null differ diff --git a/scripts/ekran-cercevesi.py b/scripts/ekran-cercevesi.py new file mode 100755 index 0000000..ba5143c --- /dev/null +++ b/scripts/ekran-cercevesi.py @@ -0,0 +1,52 @@ +#!/usr/bin/env python3 +"""README için: bir ekran görüntüsünü (PNG) tarayıcı penceresi çerçevesine alıp tek dosyalık SVG yapar. +GitHub, ile gösterilen SVG içindeki gömülü (data:) görüntüyü çizer; dış dosya yüklemez, bu yüzden PNG gömülür. +Kullanım: scripts/ekran-cercevesi.py girdi.png cikti.svg [adres] (varsayılan adres: 127.0.0.1:7432) +Yalnızca standart kütüphane.""" +import base64 +import struct +import sys + + +def png_size(data: bytes): + if data[:8] != b"\x89PNG\r\n\x1a\n": + raise SystemExit("girdi bir PNG değil") + return struct.unpack(">II", data[16:24]) + + +def frame(png: bytes, address: str) -> str: + w, h = png_size(png) + pad, bar, r = 28, 40, 12 + W, H = w + 2 * pad, h + bar + 2 * pad + b64 = base64.b64encode(png).decode() + x, y = pad, pad + return f''' + + + + + + + + + + + + + 🔒 {address} + + + + +''' + + +if __name__ == "__main__": + if len(sys.argv) < 3: + raise SystemExit(__doc__) + src, dst = sys.argv[1], sys.argv[2] + addr = sys.argv[3] if len(sys.argv) > 3 else "127.0.0.1:7432" + with open(src, "rb") as f: + data = f.read() + with open(dst, "w", encoding="utf-8") as f: + f.write(frame(data, addr)) diff --git a/tests/e2e/cdp.mjs b/tests/e2e/cdp.mjs index 78d9bd6..f9ce6da 100644 --- a/tests/e2e/cdp.mjs +++ b/tests/e2e/cdp.mjs @@ -1,7 +1,7 @@ // Küçük, sıfır bağımlılıklı Chrome DevTools Protocol sürücüsü (yalnızca geliştirme/test için; uygulamaya GÖMÜLMEZ). // Node'un yerleşik WebSocket'ini kullanır: npm paketi yok. Chrome bulunamazsa launch() `null` döndürür. import { spawn, spawnSync } from 'node:child_process'; -import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs'; +import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'; import { tmpdir } from 'node:os'; import { join } from 'node:path'; @@ -66,6 +66,11 @@ export async function launch({ width = 1500, height = 950 } = {}) { const api = { errors, + // Ekran görüntüsü (README için; tests/e2e/ekran-goruntuleri.mjs). clip: { x, y, width, height } ya da tüm görünüm. + async shot(path, clip) { + const r = await send('Page.captureScreenshot', { format: 'png', ...(clip ? { clip: { ...clip, scale: 1 } } : {}) }); + writeFileSync(path, Buffer.from(r.result.data, 'base64')); + }, sleep: (ms) => new Promise((r) => setTimeout(r, ms)), async goto(url) { const t0 = Date.now(); errors.length = 0; await send('Page.navigate', { url }); await api.sleep(1200); if (process.env.E2E_TRACE) console.log(` goto ${((Date.now() - t0) / 1000).toFixed(1)}s`); }, async eval(expr) { diff --git a/tests/e2e/ekran-goruntuleri.mjs b/tests/e2e/ekran-goruntuleri.mjs new file mode 100644 index 0000000..93e8cd1 --- /dev/null +++ b/tests/e2e/ekran-goruntuleri.mjs @@ -0,0 +1,43 @@ +// README ekran görüntülerini (demo/simülasyon verisiyle) üretir. Kullanım: node tests/e2e/ekran-goruntuleri.mjs <çıktı-klasörü> +// Sonra tam pencere olanları: scripts/ekran-cercevesi.py girdi.png cikti.svg (tarayıcı penceresi çerçevesi). Yalnızca geliştirme için. + +import { launch } from './cdp.mjs'; +const OUT = process.argv[2], URL = process.argv[3]; +const b = await launch({ width: 1500, height: 940 }); +const click = (sel) => b.eval(`(()=>{const e=document.querySelector(${JSON.stringify(sel)}); if(!e) throw new Error('yok: ${'${sel}'}'); e.click(); return true;})()`); +const wait = (c, t = 8000) => b.waitFor(c, t); +await b.goto(URL); await b.sleep(1500); +await wait(`document.querySelectorAll('#rail-svg .fo-capsule').length > 2`); +// 1 kokpit +await b.shot(`${OUT}/kokpit.png`); +// 2 üst çubuk + çipler (kırpma) +await b.shot(`${OUT}/ust-cubuk-ve-cipler.png`, { x: 0, y: 0, width: 1500, height: 150 }); +// 3 hata radarı (alt çekmece kırpma) +const dock = await b.eval(`(()=>{const r=document.getElementById('bottom-dock').getBoundingClientRect(); return {x:r.x,y:r.y,width:r.width,height:r.height}})()`); +await b.shot(`${OUT}/hata-radari.png`, dock); +// 4 kuyruk +await click('#btn-queue'); await wait(`!!document.querySelector('#queue-candidates .queue-row')`); await b.sleep(800); +await b.shot(`${OUT}/kuyruk.png`); await click('#queue-close'); await b.sleep(300); +// 5 koruma +await click('#btn-protect-branch'); await wait(`document.querySelectorAll('#prot-now .prot-now-row').length > 3`); await b.sleep(600); +await b.shot(`${OUT}/koruma.png`); await click('#sec-close'); await b.sleep(300); +// 6 mcp +await click('#btn-mcp-connect'); await b.sleep(500); +await b.shot(`${OUT}/mcp.png`); await click('#mcp-close'); await b.sleep(300); +// 7 çakışma stüdyosu +await b.eval(`[...document.querySelectorAll('.radar-card button')].find((x) => x.textContent.includes('Çakışma Stüdyosu'))?.click()`); +await wait(`!document.getElementById('conflict-studio-modal').hidden`); await b.sleep(900); +await b.shot(`${OUT}/cakisma-studyosu.png`); await click('#studio-close'); await b.sleep(300); +// 8 birleşmiş PR detayı +await b.eval(`(async()=>{const m=await import('/modules/state.js'); const app=await import('/app.js'); const t=m.state.snapshot.branches.find((x)=>x.state==='merged'); app.selectBranch(t.id);})()`); +await wait(`document.querySelectorAll('.merged-file-row').length > 0`); await b.sleep(600); +await b.shot(`${OUT}/birlesmis-pr-detay.png`); +await b.eval(`(async()=>{const app=await import('/app.js'); app.selectBranch(null);})()`).catch(()=>{}); +// 9 tur +await click('#btn-start-tour'); await b.sleep(700); +await b.shot(`${OUT}/kokpit-turu.png`); await click('#tour-close-btn'); await b.sleep(300); +// 10 açık tema +await click('#btn-theme'); await b.sleep(700); +await b.shot(`${OUT}/acik-tema.png`); +b.close(); +console.log('tamam'); diff --git a/web/tasarim.css b/web/tasarim.css index b6460ea..4e75b71 100644 --- a/web/tasarim.css +++ b/web/tasarim.css @@ -251,8 +251,9 @@ body { } /* Sürüm düğmesi başlığın altında, küçük bir rozet gibi durur (sürüm/güncelleme/Team penceresini açar). */ -.brand-sub-row .brand-ver { - height: auto; +.brand-copy .brand-sub-row > button { /* topbar.js sınıf adını yeniden yazar: sınıfa değil konuma bağla */ + height: 15px; + min-height: 0; padding: 0 5px; font-size: 9.5px; line-height: 14px;