arama-ustasi

Arama Ustası

Amaç çok sonuç üretmek değil, soruyu kanıtlayan en küçük sonuç kümesini bulmaktır. Metin için rg; sözdizimi önemliyse ve mevcutsa ast-grep kullan.

Arama nizamı

1. Arama sorusunu tek cümleye indir: tanım mı, çağrı mı, dosya mı, kod şekli mi?
2. Önce kapsamı gör: rg --files <hedef> | head -80. Tüm depoyu körlemesine okuma.
3. Metin aramasını dosya türü ve dizinle daralt. Önce dosya sayısını veya ilk 20–50 eşleşmeyi gör; sonra gerekirse genişlet.
4. Regex semantiği ayıramıyorsa AST aramasına geç. Araç yoksa kurma; regex sonucunun yaklaşık olduğunu açıkça söyle.
5. Sonucu dosya:satır → neden ilgili biçiminde özetle. Ham binlerce satırı bağlama taşıma.
6. Değişiklik öncesi etki haritası çıkar: tanım, çağrılar, testler, yapılandırma.

Araç seçimi

command -v rg
command -v ast-grep || true

Bazı sistemlerde sg başka bir programa aittir. Yalnızca sg --version çıktısı gerçekten ast-grep diyorsa onu kullan. Kullanıcı istemeden paket kurma.

Metin araması

rg -n -F "exactSymbol" src/ --type ts --type tsx
rg -l "old_method\(" src/ --type py | head -50
rg -n "TODO|FIXME" . --glob '!{node_modules,dist,build,.git}/**' | head -50

• Kesin sembolde -F, kelimede -w, çevre gerekiyorsa küçük -C kullan.
• .gitignore davranışını varsayılan olarak koru; gizli/ignore edilmiş alanları yalnızca görev gerektiriyorsa bilinçli aç.
• rg varken grep -R veya find ile geniş tarama yapma.

Yapısal arama

Ast-grep deseninin hedef dilde geçerli, parse edilebilir kod olması gerekir. Metadeğişkenleri $NAME, $ARG ve $$$BODY biçiminde kullan.

ast-grep run --lang ts --pattern 'fetch($URL, $$$REST)' src/
ast-grep run --lang py --pattern 'def $NAME($$$ARGS): $$$BODY' app/

Önce tek dosya veya dar dizinde deseni doğrula. Dönüşüm yapmadan önce yalnızca arama çalıştır; otomatik rewrite ayrı kullanıcı kararıdır.

Emniyet ve takdim

• Sır veya kimlik bilgisi araması gerekiyorsa değeri çıktıda gösterme; yalnızca konumu ve bulgu türünü bildir.
• Aktif hata ayıklamada son hata mesajını ve ilgili satırları kesme.
• Teslimde kullanılan komutu, kapsamı, eşleşme sayısını ve önemli dosyaları ver.
• “Hiç eşleşme yok” sonucunda kapsam, ignore kuralları ve dil filtresini kontrol et.