Jev Review: Tip Güvenli Kod İncelemesi

📰 Hikayesi ve Doğuşu

Geliştiricilerin yapay zekâ destekli kod inceleme araçlarında en sık karşılaştığı sorun, modellerin sınırları belirsiz gevezelikler üretmesi ve her çalıştırmada tutarsız, doğrulanamayan kararlar vermesidir. Açık kaynak geliştiricisi devagrawal09, orkestrasyonun tamamen kod tabanında kaldığı, LLM'in ise yalnızca yapılandırılmış ve tip güvenli kararlar üretmek için devreye girdiği deterministik bir akış inşa etmek amacıyla jev-review projesini hayata geçirdi.

⚡ Nasıl Çalışıyor & Mimari Detaylar

Sistem, TypeSafe Jev platformunun sağladığı tipli karar mekanizmalarını (Choice ve Score) aşamalı bir boru hattında yürütür. Süreç, risk matrisi değerlendirmesiyle başlar; ilgili dosya profilleri seçilir, somut diff parçaları (diff hunks) ve kaynak alanları kanıt olarak izole edilir. Ardından hata mekanizması sınıflandırılır, ciddiyet puanlanır ve gerekirse koşullu gözden geçirme yönlendirmesi yapılır. Kod tabanı {cli, dashboard} -> review -> adapters -> domain yönünde katı bir bağımlılık kuralına göre ayrılmıştır; katmanlar asla yukarı doğru import yapamaz. Yerel HTTP sunucusu yalnızca 127.0.0.1:4317 portuna bağlanır ve .env gibi hassas ortam dosyalarını kesinlikle dışarı sızdırmaz.

💡 Neden Radarımıza Girdi?

Yapay zekâ kod asistanlarının çoğu devasa bağlamları tek bir serbest isteme (prompt) yığarken, jev-review orkestrasyonu koda emanet edip modeli sadece sınırlandırılmış yargılar (bounded judgments) için çağırıyor. Değişen test dosyalarını bağlam olarak kullanabilmesi, doğruluk, güvenlik, güvenilirlik ve test kapsamı gibi net filtrelere odaklanması ve sonuçları uzak bir buluta göndermek yerine tamamen yerel bir panoda toplanabilir bölümler halinde sunması projeyi teknik disiplin açısından öne çıkarıyor.

🚀 Nasıl Denenir & Kaynaklar

Projeyi çalıştırmak için Node.js 24+, Git ve bir TypeSafe API anahtarı gerekiyor. Depoyu klonladıktan sonra npm install ile paketleri yükleyip .env dosyasına anahtarınızı eklemeniz yeterli. Aktif Git diff analizini kaydetmek için npm run review:changes:save -- /proje/yolu komutunu çalıştırabilir, ardından npm run dashboard ile yerel arayüzü http://127.0.0.1:4317 üzerinden açabilirsiniz. Projenin kaynak kodlarına ve bağımlılık kontrol betiklerine GitHub reposu üzerinden erişebilirsiniz.