Yapılandırma

​

Yapılandırma kapsamları

​

Birleştirme kuralları

proje:    ["block-sudo"]
yerel:    ["block-rm-rf"]
genel:    ["block-sudo", "sanitize-api-keys"]

çözüm:    ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← yinelenenden arındırılmış birleşim

proje:    block-sudo → { allowPatterns: ["sudo apt-get update"] }
genel:    block-sudo → { allowPatterns: ["sudo systemctl status"] }

çözüm:    { allowPatterns: ["sudo apt-get update"] }   ← proje kazanır, genel yok sayılır

proje:    (block-sudo girişi yok)
yerel:    (block-sudo girişi yok)
genel:    block-sudo → { allowPatterns: ["sudo systemctl status"] }

çözüm:    { allowPatterns: ["sudo systemctl status"] }  ← genel'e düşer

​

Yapılandırma dosyası formatı

{
  "enabledPolicies": [
    "block-sudo",
    "block-rm-rf",
    "block-push-master",
    "sanitize-api-keys",
    "sanitize-jwt",
    "block-env-files",
    "block-read-outside-cwd"
  ],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release", "prod"]
    },
    "block-rm-rf": {
      "allowPaths": ["/tmp"]
    },
    "block-read-outside-cwd": {
      "allowPaths": ["/shared/data", "/opt/company"]
    },
    "sanitize-api-keys": {
      "additionalPatterns": [
        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
      ]
    },
    "warn-large-file-write": {
      "thresholdKb": 512
    }
  },
  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
}

​

Alan referansı

​

enabledPolicies

​

policyParams

​

hint (çapraz kesme)

{
  "policyParams": {
    "block-force-push": {
      "hint": "Bunun yerine yeni bir dal oluşturmayı deneyin."
    },
    "block-sudo": {
      "allowPatterns": ["sudo apt-get"],
      "hint": "sudo olmadan doğrudan apt-get kullanın."
    },
    "custom/my-policy": {
      "hint": "Önce kullanıcıdan onay isteyin."
    }
  }
}

​

customPoliciesPath

​

Kural tabanlı politikalar

​

llm

{
  "llm": {
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-ant-..."
  }
}

​

CLI’dan yapılandırma yönetimi

• Ajan CLI ayarları — ajanı her araç kullanımında failproofai --hook <event> çağırması için söyler:
  • Claude Code: ~/.claude/settings.json (kullanıcı), <cwd>/.claude/settings.json (proje), <cwd>/.claude/settings.local.json (yerel)
  • OpenAI Codex: ~/.codex/hooks.json (kullanıcı), <cwd>/.codex/hooks.json (proje) — Codex yerel kapsamı yok
  • GitHub Copilot CLI (beta): ~/.copilot/hooks/failproofai.json (kullanıcı), <cwd>/.github/hooks/failproofai.json (proje) — Copilot yerel kapsamı yok. Hook girdileri Copilot’un OS anahtarlı bash/powershell komut alanlarını timeoutSec ile kullanır; dosya üst düzey version: 1 işaretçisini taşır. Copilot CLI desteği beta durumundadır ve events.jsonl kayıt şemasını (halk belgeleri belirtmez) daha fazla gerçek dünya oturumuna karşı doğrularız.
  • Cursor Agent (beta): ~/.cursor/hooks.json (kullanıcı), <cwd>/.cursor/hooks.json (proje) — Cursor yerel kapsamı yok. Hook girdileri Claude şeklinde {type, command, timeout} formunu kullanır (bash/powershell bölümü yok) ancak camelCase olay anahtarları (preToolUse, beforeSubmitPrompt, …) altında depolanır, Cursor’un hooks şemasına göre düz dizi halinde; dosya üst düzey version: 1 işaretçisini taşır. İşleyici, CURSOR_EVENT_MAP aracılığıyla camelCase → PascalCase’i kanonikleştirir, böylece mevcut yerleşik politikalar değişmeden çalışır. Cursor Agent desteği beta durumundadır ve Cursor’un disk üzerindeki transkripti (açık belgelerde belirtilmez) daha fazla gerçek dünya kurulumuna karşı doğrularız.
  • OpenCode (beta): ~/.config/opencode/opencode.json + ~/.config/opencode/plugins/failproofai.mjs (kullanıcı), <cwd>/.opencode/opencode.json + <cwd>/.opencode/plugins/failproofai.mjs (proje) — OpenCode yerel kapsamı yok. Diğer beş CLI’den farklı olarak, OpenCode harici komut hook sistemi olmaz: plugin: [] dizisi aracılığıyla açıkça kaydedilen işlem içi JS/TS eklentilerini yükler (opencode.json içinde) (.opencode/plugins/ dan otomatik keşif opencode v1.14.33’de eklentilerin nasıl yüklendiği değildir). Kurulum, ikili failproofai’yi subprocess olarak çağıran ve ikili’nin Claude şekli JSON yanıtını eklenti semantiğine geri çeviren küçük bir oluşturulan eklenti parçacığını bırakır: araç olayı reddi için throw new Error() (araç çağrısını iptal eder), instruct VE Stop / SubagentStop reddi için client.session.prompt(...) (reddi nedeni bir sonraki kullanıcı iletisi olarak gönderir — session.idle yalnızca bildirimdir ve bundan atmak no-op olduğundan tek zorla yeniden deneme kanalı), allow için no-op. Parçacık hem araç adlarını (küçük harf → PascalCase, OPENCODE_TOOL_MAP aracılığıyla) hem de araç giriş arg anahtarlarını (camelCase → snake_case, OPENCODE_TOOL_INPUT_MAP aracılığıyla Read / Write / Edit için, örn. filePath → file_path, oldString → old_string) kanonikleştirir, ikili’ye iletmeden önce, yol kontrol yerleşikleri gibi block-read-outside-cwd, block-env-files ve block-secrets-write OpenCode araç çağrılarında değişmeden çalışır. Oturumlar opencode’un SQLite DB’sinde yaşar ~/.local/share/opencode/opencode.db; pano’nun oturum görüntüleyicisi onları opencode db --format json ve opencode export <id> aracılığıyla okur. OpenCode desteği beta durumundadır ve sürümler arasında ve daha fazla gerçek dünya oturumlarına karşı davranışı doğrularız. OpenCode eklentileri belgeleri başlıklı sayfaya bakın.
  • Pi (beta): ~/.pi/agent/settings.json (kullanıcı), <cwd>/.pi/settings.json (proje) — Pi yerel kapsamı yok. Pi başlangıçta TypeScript uzantı paketlerini yükler; ayarlar dosyası düz dize dizisidir {"packages": ["./relative/path", …]}. failproofai, paketlenmiş pi-extension/ dizinine işaret eden tek bir packages-dizisi girişi yazar. Uzantı dahili olarak Pi’nin tool_call / user_bash / input / session_start olaylarına abone olur ve failproofai --hook <Event> --cli pi’ye shell çıkışı verir; işleyici underscore_lower_snake_case → PascalCase’i PI_EVENT_MAP aracılığıyla kanonikleştirir, böylece mevcut yerleşik politikalar değişmeden çalışır. Araç giriş argları da PI_TOOL_INPUT_MAP aracılığıyla kanonikleştirilir (Pi’nin Read / Write / Edit file_path yerine path iletir; üst düzey anahtarı eşlemek block-env-files ve block-secrets-write’in çalışmasını sağlar — block-read-outside-cwd zaten bir path geri dönüşü içeriyordu). Pi desteği beta durumundadır, Pi’nin uzantı API’si ve oturum günlüğü düzeni stabilize olurken.
  • Hermes (hermes-agent): ~/.hermes/config.yaml (yalnızca kullanıcı kapsamı — Hermes proje/yerel yapılandırması yok). Hermes bir Slack/Telegram ağ geçididir, bu nedenle bir kurulum her platformdan (Slack/Telegram/cli/cron) araç çağrılarını ve iç alt ajanları yakalar. Hook girdileri, Hermes’in snake_case olayları (pre_tool_call / post_tool_call / on_session_start / on_session_end / subagent_stop) tarafından anahtarlanan hooks: eşlemesi altında {command, timeout} çiftidir; işleyici HERMES_EVENT_MAP aracılığıyla olayları ve HERMES_TOOL_MAP aracılığıyla araç adlarını kanonikleştirir, böylece yerleşik politikalar değişmeden çalışır. Yapılandırma, yorum koruyan YAML Document turuna göre düzenlendiğinden işletmenin diğer ayarları kalır ve kurulum, başsız ağ geçidinin (TTY yok) hookları onay istemi olmadan çalıştırması için hooks_auto_accept: true ayarlar. Değerlendirici Hermes’in {"decision":"block","reason"} stdout sözleşmesini yayar (Hermes çıkış kodlarını yok sayar). Sınırlamalar: Hermes’in bir Stop olay sonu yoktur, bu nedenle require-*-before-stop yerleşikleri bunun için hiçbir zaman çalışmaz (uygulanamaz, kırık değil); instruct izin-not-ile-günlüğe-kaydedil’e degrades (ek bağlam kanalı yok); ve çıkış gizli redaksiyonu (sanitize-*) shell-hook sözleşmesi üzerinde araç çıkışını yeniden yazamaz. Hermes aynı zamanda çevrimdışı bir denetim kaynağıdır — pano, ağ geçidi oturumlarını doğrudan ~/.hermes/state.db’den okur.
• policies-config.json — failproofai’ye hangi politikaları değerlendireceğini ve hangi parametrelerle (tüm ajan CLI’ler arasında paylaşılan) söyler

failproofai policies --install --cli codex --scope project
failproofai policies --install --cli copilot --scope project
failproofai policies --install --cli cursor --scope project
failproofai policies --install --cli opencode --scope project
failproofai policies --install --cli pi --scope project
failproofai policies --install --cli hermes --scope user
failproofai policies --install --cli claude codex copilot cursor opencode pi

• Bir CLI algılandı — sor olmadan o CLI’yi otomatik seçer.
• Etkileşimli bir terminalde birden fazla CLI algılandı — Detected (N) bölümüne gruplandırılmış ok tuşu tek seçim istemi gösterir (algılanan tüm CLI’ler için bir Tüm N tespit edileni yükle toplu satırı + her algılanan CLI bireysel olarak) ve her desteklenen CLI’nin yüklenmemiş olan listesini gösteren Yüklü olmayan (M) · hookları önceden kurma bölümü (↑↓ taşımak, Enter seçmek, ^C bırakmak için). Kaldırma akışı yalnızca Algılanan bölümü gösterir.
• Etkileşimli olmayan çalıştırmada birden fazla CLI algılandı (CI, TTY yok) — sor olmadan tüm algılanan CLI’ler için yükler.
• Hiçbiri algılanmadı — claude’ye geri döner, PATH’de ajan ikili bulunamadığı konusunda bir uyarı ile; hook komutu hala yazılır, böylece biri yüklendiğin anda etkinleşir.

​

Örnek: takım varsayılanları ile proje düzeyinde yapılandırma

{
  "enabledPolicies": [
    "block-sudo",
    "block-rm-rf",
    "block-push-master",
    "sanitize-api-keys",
    "block-env-files"
  ],
  "policyParams": {
    "block-push-master": {
      "protectedBranches": ["main", "release", "hotfix"]
    }
  }
}