Perspica: Kod Farklarına Semantik Bakış

📰 Hikayesi ve Doğuşu

Yapay zekâ kodlama asistanlarının (Claude Code, GitHub Copilot, Codex) hızla benimsenmesiyle birlikte yazılım ekipleri daha önce görülmemiş büyüklükte PR (Pull Request) yığınlarıyla karşılaşmaya başladı. Bağımsız geliştirici sshah03, yüzlerce satırlık yapay zekâ kodlarını GitHub arayüzünde incelerken yorulup sırf karmaşıklıktan kaçmak için körü körüne onay verme refleksine girdiğini fark etti. Standart Git diff araçlarının satır satır sunduğu kırmızı-yeşil karmaşası; yeniden adlandırmaları, boşluk değişikliklerini ve asıl iş mantığını aynı kefeye koyuyordu. Geliştirici, insan zihninin kod okuma biçimini taklit eden ve yapay zekânın yazdığı kodların ne kadarının kullanıcının isteminden, ne kadarının modelin kendi tercihinden kaynaklandığını ayrıştıran Perspica projesini bu ihtiyaçtan doğurdu.

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

Perspica'nın çekirdek gücü herhangi bir harici yapay zekâ modeline bağımlı olmadan çalışabilmesidir. Rust tabanlı tek bir ikili (binary) dosya olarak derlenen sistem, tree-sitter soyut sözdizimi ağacı (AST) ayrıştırıcısını kullanarak her iki kod sürümünü karşılaştırır. Fonksiyon taşımaları, parametre değişiklikleri ve salt isim revizyonları gibi mekanik operasyonları gürültü filtresine alarak gizler; buna karşın artık var olmayan değişken referansları veya güncellenmemiş çağrılar gibi gizli hataları anında yüzeye çıkarır. TypeScript, JavaScript, Python, Rust, Go, Java ve C dillerini yerel olarak anlar. İsteğe bağlı olarak devreye giren LLM katmanı (Claude Code, Ollama veya OpenAI API) ise değişiklikleri amacına ve risk seviyesine göre gruplar. Özellikle Claude Code veya Codex ile oluşturulan dallarda, geliştiricinin prompt geçmişini okuyarak hangi satırların prompt ile talep edildiğini, hangi satırların model tarafından otonom eklendiğini açıkça işaretler.

💡 Neden Radarımıza Girdi?

Günümüz yazılım dünyasında 'AI slop' olarak tabir edilen plansız ve kontrolsüz yapay zekâ kod çıktılarının kod depolarını ele geçirmesini engelleyecek en zarif araçlardan biri. Buluta bağımlı olmadan, yerel makinede milisaniyeler içinde deterministik analiz sunması büyük bir mühendislik başarısı. Ayrıca terminalde, web tarayıcısında veya Perforce tarzı yan yana diff formatında incelenebilmesi geliştirici deneyimini üst seviyeye taşıyor. Perspica, AI çağında kod kalitesini korumak isteyen kıdemli mühendislerin radarında olmayı fazlasıyla hak ediyor.

🚀 Nasıl Denenir & Kaynaklar

Perspica'yı Rust kurulu sistemlerde cargo install perspica komutuyla saniyeler içinde yükleyebilirsiniz. Mevcut git deponuzda tarayıcı arayüzüyle inceleme yapmak için perspica --web, doğrudan açık bir GitHub PR'ını analiz etmek için ise GitHub CLI destekli perspica --pr 123 --web komutunu çalıştırmanız yeterli. Kaynak kodlarına ve hazır ikili paketlere projenin GitHub deposu üzerinden ulaşabilirsiniz.