Yerel konfigürasyon

Failproof AI, bir deponun commit edebileceği şeyleri — hook bağlantısı, politika parametreleri, özel politikalar — kimlik bilgileri, yüklü paketler ve daemon gibi makine durumundan ayrı tutar.

Bir kapsam seçin

Bir kapsam, hook’ların nerede bağlandığını ve parametreleri ile özel politika yollarını hangi konfigürasyon dosyasına yazacağınızı belirler:

User bu makinede projeler arasında geçerlidir.
Project depoya aittir ve commit edilebilir.
Local bir projeyi bir kullanıcı için geçersiz kılar ve gitignore’da kalmalıdır.

failproofai policies --install --cli claude --scope project   # bu depo için hook'ları bağla
failproofai policies --install --cli claude --scope user      # veya bu makinedeki her proje için
failproofai policies

Her harness yerel kapsamı desteklemez; CLI, seçilen harness’in temsil edemeyeceği bir kapsamı reddeder. Hangi paket politikalarının açık olduğu kapsamlı değildir. Anahtar, yüklü pakettle kaydedilir, bu nedenle failproofai policies add <name> --scope ne derse desin, bir politikayı tüm makine için açar.

Kapsam	Politika konfigürasyon dosyası
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

Politika parametreleri, o politika için parametreleri tanımlayan ilk kapsamı kullanır; proje → yerel → kullanıcı sırasında. Açık özel politika yolları, bunları tanımlayan ilk kapsamı kullanır.

Politika parametrelerini yapılandırın

Dashboard
CLI

Yerel dashboard’da politikayı açın, desteklenen parametrelerini düzenleyin ve seçilen kapsamda kaydedin. Eşleşen ve eşleşmeyen bir ajan eylemini çalıştırın, ardından Observe → policy kısmında kararı inceleyin.

Seçilen kapsamın policies-config.json dosyasını düzenleyin, ardından failproofai policies çalıştırın: bir policyParams girdisinin yüklenmiş hiçbir paket tarafından taşınmayan bir politikayı adlandırması durumunda uyarır. Bir girdinin içindeki anahtarları kontrol etmez, bu nedenle bunları aşağıdaki tabloya göre kontrol edin.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Failproof AI politikalarının kabul ettiği parametreler

Her politika kendi parametre türlerini doğrular.

Politika	Parametre	Tür ve varsayılan
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; girdiler `regex` ve `label` içerir
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Altyapı engelleyicileri	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

İzin verme deseni, bir ajanın yapabileceği şeyleri genişletir. Hedef harness’te tam tokenleştirme ve komut varyantlarını test ettikten sonra bir filo genelinde dağıtın.

Makine dosyalarını anlayın

~/.failproofai farklı güven sınırları için ayrı dosyalar içerir:

Yol	Amaç
`config.json`	Gizli olmayan daemon, denetim ve telemetri ayarları
`credentials.json`	Bulut kimlik bilgileri; yalnızca sahibin izinleriyle depolanır
`policies-config.json`	Kullanıcı kapsamı parametreleri ve açık özel politika yolları
`policies/`	Kullanıcı kural politikaları, yüklü paketler ve bunların politikalarından hangilerinin açık olduğu ve Bulut tarafından yönetilen politika yapıtları
`hook-activity/`	Yerel politika karar günlüğü
`state/`	Daemon spool, sistem sağlığı, duraklatma ve çalışma zamanı durumu

Bir konteyner veya izole edilmiş test için tam makine düzenini yeniden konumlandırmak için FAILPROOFAI_HOME kullanın. Durum dizinlerini bağımsız olarak yeniden konumlandırmayın.

Asla credentials.json commit etmeyin. Proje politika konfigürasyonunu ve proje kural politikalarını yalnızca uygulama kodu olarak inceledikten sonra commit edin.

Connect your agents

Reference

Bir kapsam seçin

Politika parametrelerini yapılandırın

Failproof AI politikalarının kabul ettiği parametreler

Makine dosyalarını anlayın

​Bir kapsam seçin

​Politika parametrelerini yapılandırın

​Failproof AI politikalarının kabul ettiği parametreler

​Makine dosyalarını anlayın

Bir kapsam seçin

Politika parametrelerini yapılandırın

Failproof AI politikalarının kabul ettiği parametreler

Makine dosyalarını anlayın