Öneriler ve öz denetim

Ekip bilgisi zamanla bozulur. Yolların adı değişir, kilometre taşları tamamlanır, bağımlılık sürümleri kayar, bir kural artık hiçbir şeyle eşleşmez olur. Pathrule'un buna yanıtı yenileme görevidir: eskimiş görünen bir hafıza kaydına veya kurala, sade bir dille yazılmış gerekçesiyle birlikte konan ve sizin denetiminizde kendi asistanınızın onardığı bir işaret.

Asıl önemli özellik şu: bir yenileme görevi her zaman yalnızca öneride bulunur. Pathrule hafıza kayıtlarınızı, kurallarınızı veya becerilerinizi hiçbir zaman kendi başına düzenlemez ya da silmez.

Öz denetim neleri kontrol eder

Denetim, kopmanın fark edildiği yerde, yani işin kendisinde gerçekleşir. Kodunuzu okuyan bir asistan, bir hafıza kaydının taşınmış bir dosyayı anlattığını ya da bir kuralın kodun artık yaptığı şeyle çeliştiğini ilk gören olur. Bu, normal çalışması sırasında gerçekleştiğinde asistan kaydı pathrule_request_refresh MCP aracıyla işaretler; hangi hafıza kaydı veya kural olduğunu ve neden yanlış göründüğünü belirtir. Tipik gerekçeler:

• Kopma. Kayıt artık kodla örtüşmeyen bir durumu anlatıyordur; örneğin andığı bir dosya taşınmıştır ya da artık yoktur.
• Kodla çelişme. Kayıt bir şey söyler, kod ise açıkça başka bir şey yapar.
• Yineleme. Başka bir hafıza kaydı veya kural aynı konuyu zaten daha iyi kapsıyordur.
• Fazla dar kapsam. Kayıt yalnızca çoktan ortadan kalkmış bir durum için geçerlidir.
• Belirsizlik. Kaydın ne istediğini anlamak mümkün değildir.

İşaretleme idempotenttir: aynı kaydı iki kez işaretlemek aynı görevi döndürür, böylece tekrarlanan oturumlar yinelenen görevler biriktirmez. Asistanlara yalnızca gerçekten fark ettikleri kopmaları işaretlemeleri, bunları aramaya çıkmamaları söylenir.

Bir yenileme görevinde kaynak kodunuza dair hiçbir şey saklanmaz. Görev yalnızca kaydı adlandırır ve gerekçeyi taşır; daha sonra onu onaran asistan mevcut kodu kendi dosya araçlarıyla okur.

Önerileri inceleme

Yenileme görevi bir eylem değil, karar vermeniz için bir hatırlatmadır. Bir Pathrule Cloud çalışma alanında bunlarla terminalden çalışabilirsiniz:

pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied

list geçerli çalışma alanındaki bekleyen görevleri gösterir, claim tek bir görevin tam özetini döndürür ve onu devam ediyor olarak işaretler, resolve ise görevi applied ya da rejected olarak kapatır. Asistan aynı işlemleri MCP üzerinden pathrule_list_pending_refreshes, pathrule_get_refresh_brief ve pathrule_resolve_refresh ile yapar.

Her görev için düzeltmeyi asistanınıza uygulatabilir (aşağıya bakın), kaydı kendiniz düzenleyebilir ya da kayıt hâlâ doğruysa görevi reddedebilirsiniz.

Asistanınız üzerinden onarım

Pathrule bilgilerinizi otomatik olarak yamalamaz. Asistanınızdan bekleyen yenileme görevlerini tek tek ele almasını isteyin. Asistan şunları yapar:

1. Bekleyen görevleri listeler ve birini üstlenir; bu, görevi devam ediyor olarak işaretler ve başka bir oturumun aynı anda onu almasını engeller.
2. Mevcut kodu ve işaretlenen kaydı kendi dosya erişim araçlarıyla inceler.
3. Güncellemenin taslağını hazırlar ve Pathrule yazma araçlarıyla geri yazar. Güncellemeyle birlikte görev kimliğini iletmek, görevi uygulandı olarak kapatır.
4. Aksi halde görevi açıkça uygulandı ya da reddedildi olarak işaretler.

Her iki uçta da denetim sizdedir: düzeltme kendi asistanınız üzerinden yürür ve değişiklik, inceleyebileceğiniz sıradan bir sürümlü düzenlemedir. Asistanın kullandığı yenileme araçları için MCP araçları referansına bakın.

Hiçbir şey geri dönüşsüz değildir

Onarım, normal bir sürümlü düzenlemedir. Her değişikliğin geçmişi korunur; bir Pathrule Cloud çalışma alanında silinen bir kayıt kalıcı olarak silinene kadar çalışma alanı arşivinde kalır ve bir sahip ya da yönetici onu web konsolu ayarlarından geri yükleyebilir. VS Code'da silme işlemi hemen ardından Undo seçeneği sunar. Bir düzeltmenin yanlış olduğu ortaya çıkarsa, onu da diğer düzenlemeler gibi geri değiştirebilirsiniz.