Hata ayıklama

Ne zaman

• "Form gönderilmiyor", "sayfa 500 veriyor", "test kırmızı", "derleme sunucuda düşüyor" gibi bildirimler.
• Argus'un PR incelemesinde ya da test planında açtığı hata görevi; Juno'nun log kanıtıyla açtığı kod görevi.
• Kullanılmaz: yeni davranış istemek (ozellik-gelistirme), paket açığı ya da sürüm yükseltmesi (bagimlilik-guncelleme). Sunucu ayakta değilse önce Juno bakar; kod değişikliği gerekiyorsa görev sana gelir.

Girdi

• Hatanın tarifi: ne yapıldı, ne bekleniyordu, ne oldu; adres, ekran görüntüsü, log satırı.
• Repo ve dal. Hata bir PR'daysa o PR'ın dalı.
• Görevde Yayın: satırı (yazmıyorsa direkt).
• Yeniden üretme adımı yoksa tek soruda iste: hangi sayfa, hangi tıklama, ne zamandan beri.

Adımlar

1. recall "<proje> hata" ile aynı hatanın daha önce görülüp görülmediğine bak; vault'ta kök neden notu varsa oku.
2. Repoyu al: checkout_repo({repo}); PR'daki hata için pr_view ile dalı bul, checkout_repo({repo, branch}).
3. Yeniden üret. Hatayı yerelde gösteren en kısa yolu bul:
   • test hatası: yalnız o testi koş, çıktıyı sakla;
   • derleme hatası: temiz node_modules ile Dockerfile komutlarını sırayla koş (npm ci, npm run build);
   • arayüz hatası: /opt/skills/webapp-testing/SKILL.md adımlarıyla sayfayı aç, adımları tekrarla, konsol ve ağ hatalarını oku.
   • Kullanıcının bilgisayarındaki projeyse device_read ile oku, device_act run_command ile koş.
4. Üretemiyorsan dur: neyi denediğini yaz, eksik bilgiyi send_message ile iste, outcome "blocked". Üretemediğin hatayı "düzelttim" deme.
5. Daralt. Hatayı yakalayan küçük bir test yaz; şu an KIRMIZI olmalı. Girdiyi küçült, son çalışan sürümle karşılaştır, şüpheli satırların etrafına geçici günlük koy.
6. Kök nedeni bul. Kanıtı tek cümleyle yaz: "X fonksiyonu Y boş gelince Z döndürüyor (satır N)". Belirtiyi değil sebebi düzelt.
7. "Ara sıra oluyor", "flake", "ortam sorunu" diye geçme. Zamanlama, sıra, önbellek, saat dilimi, platform (sunucu ARM64), ağ zaman aşımı gibi sebepleri tek tek ele. Sebep gerçekten dışarıdaysa (servis, ağ) kanıtını yaz ve Juno'ya send_message ile ilet.
8. Düzelt. En küçük değişikliği yap; ilgisiz yeniden düzenleme yok. Geçici günlükleri kaldır.
9. 5. adımdaki test artık YEŞİL; tüm testleri ve derlemeyi koş. Derleme hatasıysa temiz npm ci + npm run build tekrar. Lock dosyasını elle düzenleme, --force/--legacy-peer-deps kullanma.
10. Yayın yolunu uygula: direkt push_main({repo, message}); önizlemeli open_pr + Juno'ya send_message ile dal adı. Canlıyı bozan son commit'se ve kullanıcı geri alma isterse revert_main({repo}).
11. Kök neden tekrar edebilecek türdense memory_write ile knowledge/ altındaki proje notuna iki satır ekle (belirti, sebep, düzeltme).
12. update_task ile kanıtı ver (commit ya da PR adresi), turu özetle bitir.

Kontrol listesi

• Hata yerelde üretildi (adım ve çıktı özette).
• Önce kırmızı, sonra yeşil olan bir regresyon testi var.
• Kök neden tek cümleyle ve kanıtla yazıldı; "flake" denmedi.
• Düzeltme küçük; ilgisiz değişiklik yok, geçici günlükler silindi.
• Tüm testler ve temiz yayın derlemesi geçti.
• Log ya da hata çıktısındaki secret görünümlü değerler özete kopyalanmadı.

Çıktı

## Hata
<belirti, tek cümle; nerede görüldü>

## Yeniden üretme
1. <adım>
Sonuç: <hata çıktısı ya da gözlem, kısaltılmış>

## Kök neden
<dosya:satır — ne oluyor ve neden>

## Düzeltme
- <dosya>: <ne değişti>
- Regresyon testi: <test adı> (önce kırmızı, şimdi yeşil)

## Doğrulama
- `npm test`: <geçti>
- `npm ci && npm run build` (temiz): <geçti>

## Yayın
- <direkt: commit <sha>, geri alma `revert_main` | önizlemeli: PR <adres>, dal <ad>>

Bitti sayılır

• Hata üretildi, kök neden yazıldı, regresyon testi yeşil, derleme geçti.
• Düzeltme yayın yolunda; görev kanıtla güncellendi.
• Üretilemediyse: denenenler yazıldı, eksik bilgi istendi, outcome "blocked".