Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<proje>/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ı).
Expand Down
21 changes: 14 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand All @@ -55,25 +56,25 @@ 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.

### Ç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.
Expand All @@ -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.
Expand Down Expand Up @@ -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 |
Expand Down
Binary file removed docs/screenshots/acik-tema.png
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/acik-tema.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/birlesmis-pr-detay.png
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/birlesmis-pr-detay.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/cakisma-studyosu.png
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/cakisma-studyosu.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/hata-radari.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/kokpit-turu.png
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/kokpit-turu.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/kokpit.png
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/kokpit.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 18 additions & 0 deletions docs/screenshots/koruma.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/kuyruk-isleniyor.webp
Binary file not shown.
18 changes: 18 additions & 0 deletions docs/screenshots/kuyruk.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 18 additions & 0 deletions docs/screenshots/mcp.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/ust-cubuk-ve-cipler.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/yerel-dal-ve-kalinti.webp
Binary file not shown.
52 changes: 52 additions & 0 deletions scripts/ekran-cercevesi.py
Original file line number Diff line number Diff line change
@@ -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, <img> 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'''<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="{W}" height="{H}" viewBox="0 0 {W} {H}">
<defs>
<filter id="g" x="-10%" y="-10%" width="120%" height="125%"><feDropShadow dx="0" dy="10" stdDeviation="14" flood-color="#000" flood-opacity="0.35"/></filter>
<clipPath id="c"><rect x="{x}" y="{y}" width="{w}" height="{h + bar}" rx="{r}"/></clipPath>
</defs>
<rect x="{x}" y="{y}" width="{w}" height="{h + bar}" rx="{r}" fill="#0d1117" filter="url(#g)"/>
<g clip-path="url(#c)">
<rect x="{x}" y="{y}" width="{w}" height="{bar}" fill="#1f2630"/>
<rect x="{x}" y="{y + bar - 1}" width="{w}" height="1" fill="#30363d"/>
<circle cx="{x + 22}" cy="{y + bar / 2}" r="6" fill="#ff5f57"/>
<circle cx="{x + 42}" cy="{y + bar / 2}" r="6" fill="#febc2e"/>
<circle cx="{x + 62}" cy="{y + bar / 2}" r="6" fill="#28c840"/>
<rect x="{x + w / 2 - 170}" y="{y + 8}" width="340" height="{bar - 16}" rx="{(bar - 16) / 2}" fill="#0d1117" stroke="#30363d"/>
<text x="{x + w / 2}" y="{y + bar / 2 + 4.5}" text-anchor="middle" font-family="ui-monospace,Menlo,Consolas,monospace" font-size="13" fill="#8b949e">🔒 {address}</text>
<image x="{x}" y="{y + bar}" width="{w}" height="{h}" xlink:href="data:image/png;base64,{b64}"/>
</g>
<rect x="{x}" y="{y}" width="{w}" height="{h + bar}" rx="{r}" fill="none" stroke="#30363d"/>
</svg>
'''


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))
7 changes: 6 additions & 1 deletion tests/e2e/cdp.mjs
Original file line number Diff line number Diff line change
@@ -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';

Expand Down Expand Up @@ -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) {
Expand Down
43 changes: 43 additions & 0 deletions tests/e2e/ekran-goruntuleri.mjs
Original file line number Diff line number Diff line change
@@ -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ü> <sim-url>
// 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');
5 changes: 3 additions & 2 deletions web/tasarim.css
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down
Loading