Skip to main content
Beta özellik. Denetim, erken geri bildirim toplarken beta olarak sunulmaktadır. Dedektör kataloğu ve rapor formatı, sonraki kararlı sürümden önce değişebilir. Herhangi bir sorun görürseniz lütfen bir sorun açın.
Denetim, geçmiş agent-CLI transkriptlerinizi failproofai’nin politika motoru üzerinden yeniden oynatır ve /audit pano sayfasında paylaşılabilir, görsel bir rapor sunar — aracınızın arketipi, 0–100 puanı ve hangi politikaların hangi durumları yakalamış olacağı tam olarak gösterilir.

Çalıştırın

Üç giriş yolu — hepsi aynı /audit raporuna ulaşır.

Kurulum yok

npx -y failproofai audit failproofai’yi getirir, taramayı çalıştırır ve panoyu sizin için açar — öncesinde kurulum yapmanız gerekmez.

CLI'dan

failproofai audit taramayı terminalinizde çalıştırır, ardından bittiğinde localhost:8020/audit adresini otomatik olarak açar.

Panodan

failproofai komutunu çalıştırın ve navbar’da Audit seçeneğine tıklayın (Policies ve Projects arasında) veya /audit adresini doğrudan açın.
Kullanım bilgilerini görmek için failproofai audit -h (veya --help) komutunu çalıştırın. Denetim tamamen çevrimdışı çalışır — hesap veya ağ bağlantısı gerekli değildir — ve pano Ctrl+C ile durdurana kadar sunmaya devam eder.
Pano, bu makinedeki geçmiş agent CLI transkriptlerini tarar (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) ve aracının failproofai’nin durdurmak için inşa edildiği şeyleri ne sıklıkta yaptığını raporlar — ortam değişkeni kontrolleri, güç şeklinde push’lar, gereksiz cd <cwd> önekleri, uyku-yoklama döngüleri, yeni düzenlenen dosyaları yeniden okuma ve daha fazlası. Her transkript için, her araç-kullanım olayı 39 yerleşik politika ve runtime politikaları tarafından henüz kapsanmayan desenleri yakalayan 8 denetim-yalnızca dedektörü üzerinden yeniden oynatılır. Sayılar tüm oturumlar arasında politika/dedektör başına toplanır.

Ne alacaksınız

/audit sayfası, tek ekranlı, paylaşılabilir bir poster ve ardından dört alt bölümdür:
  1. Poster — aracınızın kimliği bir bakışta: arketipi (8’den biri — optimist, cowboy, explorer, goldfish, paranoid architect, precision builder, hammer, ghost), kişi anahtar sözcükleri, bu arketipin ne kadar nadir olduğu ve 0–100 puanı bir seviye bandı ile (S ila bottom tier). Paylaşmak için tasarlandı — X veya LinkedIn’e gönderin veya PNG olarak indirin.
  2. // strengths — aracınızın zaten iyi yaptığı şeyler, taramadan gelen gerçek sayılar olarak (ör. temiz araç çağrısı %, 0 push-to-main denemesi), yalnızca ilgili politikanın temiz bir rekoru olan yerlerde gösterilir.
  3. // quirks — sıyrılan: failproofai’nin yakalamış olacağı davranışların sıralanmış tablosu — ne zaman en son gerçekleştiği, ne sıyrıldı (ve bunu engellemiş olacak yerleşik), önem derecesi ve ne sıklıkta görüldüğü (new / recurring / N× seen).
  4. // how to improve — önerilen düzeltme listesi: politika başına bir satır failproofai policy add <slug> kopyala-yapıştır ile, artı install all düğmesi, tüm önerileri bir kerede etkinleştirir ve bunu yaparsanız projected score gösterir.
  5. // come back better — alışkanlık inşa edin: yeniden denetim e-posta reminder ayarlayın (3d / 7d / 14d / 30d) veya şimdi yeniden denetim yapın, ve bir arkadaşınızı davet edin kendi denetimini çalıştırmaları (failproof.ai’den gönderilir, Cc sizinle). Reminders ve davetler oturum açma gerektirir.

Planlanan denetimler

failproofaid daemon komutunu çalıştırırsanız (bkz. failproofai config), bu, denetimi sizin için bir programa göre yeniden çalıştırabilir ve /audit raporunu arka planda yenileyebilir. Varsayılan olarak kapalıdır, çünkü tarama, bu makinedeki her agent oturumu transkriptinin içeriğini okur — bir zamanlayıcıda hiçbir şey taranamaz, siz bunu istemediğiniz sürece. Bunu ~/.failproofai/config.toml dosyasında açın:
  • Zamanlama duvar saati tabanlıdır, bu nedenle askı ve yeniden başlatmayı ayakta tutar: zamanı geçmiş bir dizüstü bilgisayar bir kez uyandığında çalışır, hiçbir zaman bir yedek değildir.
  • Her çalıştırma ayrı, düşük öncelikli (nice 19) bir işlemdir — hiçbir zaman daemon’un hook yolu değildir, bu da araç çağrılarını cevaplamaya boş kalır.
  • failproofai audit veya pano yeniden çalıştırması zaten uçuştaysa bir tarama atlanır; başarısızlık olarak değil de kısa bir süre sonra yeniden denenir.
  • İlerleme ~/.failproofai/state/audit-schedule.json dosyasına yazılır (son çalıştırma, sonraki gözlemle). Daemon bu dosyaya sahiptir — kadansı config.toml dosyasında değiştirin.
Bunu daha eski failproofai tarafından kurulan bir makinede etkinleştirdiyseniz, failproofai config komutunu bir kez çalıştırın. Daemon’un hizmet tanımı, CLI’yi başlatabilmesi için ek bir giriş gerektirir ve yenileme bu komutun bir parçasıdır.

Denetim-yalnızca dedektörleri

Bunlar, gerçek zamanlı olarak (henüz) uygulanmayan “aptalca davranış” desenlerini algılar. Yalnızca denetim sırasında çalışırlar ve hiçbir zaman canlı araç çağrısını engellemezler.

Önbellekler

  • Per-transcript cache ~/.failproofai/cache/audit/<sha1>.json konumunda (mtime, size, engineVersion, detectorVersion) ile anahtarlanmış — transkript veya politika/dedektör kodu değiştiğinde otomatik olarak geçersiz kılınır. Her giriş ayrıca TTL metaveri olarak bir cachedAt zaman damgası depolar (önbellek anahtarının parçası değil); 7 günden eski girişler, uzun süreli sonuçlar gelişen dedektör amacından daha uzun yaşanmasın diye okunmada reddedilir.
  • Whole-result cache ~/.failproofai/audit-dashboard.json konumunda (mode 0600). Pano, yeniden çalıştırmadan navigasyon üzerinde anında işlenmesini sağlar. Ayrıca 7 günlük TTL geçtikten sonra okunmada reddedilir — /audit daha sonra boş durumuna döner ve yeni bir çalıştırma istenir. Raporun alt kısmı yakınında [ re-audit now ] seçeneğini tıklayarak yenileyin — yeniden denetim noCache: true gönderir, bu nedenle per-transcript önbelleğini atlar ve her transkripti yeniden tarar; çalıştırma yapışkan üst şerit üzerinden ilerlemeyi akışla iletir ve başarıda sonucu yerinde değiştirir (sayfa yeniden yükleme yok; başarısız bir yeniden denetim önceki raporu tutar).

Notlar

  • Mutasyon yok. Denetim salt okunur modda oynatılır. warn-repeated-tool-calls atlanır, çünkü oturum başına yan araç aksi takdirde değiştirilir.
  • Workflow policies atlandı. require-*-before-stop politikaları yalnızca Stop olaylarında ve canlı git durumuna karşı execSync öğesinde ateş eder — “2025’te ne olmuş olurdu” anlamı yoktur, bu nedenle denetim sayılarında görünmezler.
  • Özel politikalar atlandı. Kullanıcı tarafından sağlanan özel hook’lar yeniden oynatılmaz (orijinal oturumdan bu yana değişmiş olabilir).