Yapılandırma

​

Yapılandırma kapsamları

​

Birleştirme kuralları

project:  ["block-sudo"]
local:    ["block-rm-rf"]
global:   ["block-sudo", "sanitize-api-keys"]

resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← çıkartılmış birleşim

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

resolved: { allowPatterns: ["sudo apt-get update"] }   ← project kazanır, global yoksayılır

project:  (block-sudo girişi yok)
local:    (block-sudo girişi yok)
global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }

resolved: { allowPatterns: ["sudo systemctl status"] }  ← global'e düşer

​

Config dosya 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 (enlemesine)

{
  "policyParams": {
    "block-force-push": {
      "hint": "Bunun yerine yeni bir dal oluşturmayı deneyin."
    },
    "block-sudo": {
      "allowPatterns": ["sudo apt-get"],
      "hint": "sudo olmadan apt-get'i doğrudan 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’den yapılandırma yönetimi

• Agent CLI ayarları — agent’e her tool kullanımında failproofai --hook <event> çağırmasını söyler:
  • Claude Code: ~/.claude/settings.json (user), <cwd>/.claude/settings.json (project), <cwd>/.claude/settings.local.json (local)
  • OpenAI Codex: ~/.codex/hooks.json (user), <cwd>/.codex/hooks.json (project) — Codex’in local kapsamı yok
  • GitHub Copilot CLI (beta): ~/.copilot/hooks/failproofai.json (user), <cwd>/.github/hooks/failproofai.json (project) — Copilot’un local kapsamı yok. Hook girişleri Copilot’un OS anahtarlı bash/powershell komut alanlarını timeoutSec ile kullanır; dosya üst düzey version: 1 işaretiyle taşınır. Copilot CLI desteği beta’dır çünkü events.jsonl kayıt şemasını (halk dokümanları belirtmiyor) daha fazla gerçek dünya oturumuna karşı doğrulanıyoruz.
  • Cursor Agent (beta): ~/.cursor/hooks.json (user), <cwd>/.cursor/hooks.json (project) — Cursor’un local kapsamı yok. Hook girişleri Claude biçimli {type, command, timeout} formunu kullanır (no bash/powershell split), ancak Cursor’un hooks şeması başına düz bir dizide camelCase olay anahtarları (preToolUse, beforeSubmitPrompt, …) altında depolanır; dosya üst düzey version: 1 işaretiyle taşınır. İşleyici CURSOR_EVENT_MAP aracılığıyla camelCase → PascalCase’yi normalizedir, böylece mevcut yerleşik politikalar değişmeden ateşlenir. Cursor Agent desteği beta’dır çünkü Cursor’un disk üzerindeki transkriptini (genel doklarda belirtilmemiş) daha fazla gerçek kuruluma karşı doğrulanıyoruz.
  • OpenCode (beta): ~/.config/opencode/opencode.json + ~/.config/opencode/plugins/failproofai.mjs (user), <cwd>/.opencode/opencode.json + <cwd>/.opencode/plugins/failproofai.mjs (project) — OpenCode’un local kapsamı yok. Diğer altı CLI’den farklı olarak, OpenCode’un dış komut hook sistemi yok: opencode.json’daki plugin: [] dizisi aracılığıyla açıkça kayıtlı işlem içi JS/TS eklentilerini yükler (.opencode/plugins/ otomatik keşfi, opencode v1.14.33’te eklentilerin nasıl yüklediği değildir). Yükleme, failproofai ikilisini subprocess çağıran ve ikilinin Claude biçimli JSON yanıtını eklenti semantiğine çeviren küçük bir oluşturulan eklenti başlığını bırakır: tool olayı deny için throw new Error() (tool çağrısını iptal eder), instruct VE Stop / SubagentStop deny için client.session.prompt(...) (deny nedenini sonraki kullanıcı mesajı olarak gönderir — session.idle bildirim yalnız olduğu ve bundan atmanın no-op olması nedeniyle tek force-retry kanalı), ve allow için no-op. Başlık, ikili iletişime iletmeden önce hem tool adlarını (lowercase → PascalCase via OPENCODE_TOOL_MAP) hem de tool giriş arg anahtarlarını (camelCase → snake_case via OPENCODE_TOOL_INPUT_MAP for Read / Write / Edit, ör. filePath → file_path, oldString → old_string) normalleştirir, bu nedenle block-read-outside-cwd, block-env-files ve block-secrets-write gibi yol kontrol yerleşikleri OpenCode tool çağrılarında değişmeden ateşlenir. Oturumlar opencode’un ~/.local/share/opencode/opencode.db adresindeki SQLite DB’sinde yaşar; panonun oturum görüntüleyicisi opencode db --format json ve opencode export <id> aracılığıyla okur. OpenCode desteği beta’dır çünkü sürümler arasında ve daha fazla gerçek dünya oturumuna karşı davranış doğrulanıyoruz. OpenCode eklentileri doklara bakın.
  • Pi (beta): ~/.pi/agent/settings.json (user), <cwd>/.pi/settings.json (project) — Pi’nin local kapsamı yok. Pi, başlangıçta TypeScript uzantı paketlerini yükler; ayarlar dosyası düz bir dize dizini {"packages": ["./relative/path", …]}. failproofai, bundled pi-extension/ dizinine işaret eden tek packages-array girişini yazar. Uzantı dahili olarak Pi’nin tool_call / user_bash / input / session_start olaylarına abone olur ve failproofai --hook <Event> --cli pi adresine shells; işleyici PI_EVENT_MAP aracılığıyla underscore_lower_snake_case → PascalCase’yi normalleştirir, böylece mevcut yerleşik politikalar değişmeden ateşlenir. Tool giriş args de PI_TOOL_INPUT_MAP aracılığıyla normalleştirilir (Pi’nin Read / Write / Edit, file_path yerine path teslim eder; üst düzey anahtarı eşleştirmek block-env-files ve block-secrets-write ateşine izin verir — block-read-outside-cwd zaten path geri dönüşüne sahipti). Pi desteği beta’dır çünkü Pi’nin uzantı API’si ve oturum günlüğü düzeni kararlı hale gelirken.
  • Gemini CLI (beta): ~/.gemini/settings.json (user), <cwd>/.gemini/settings.json (project) — Gemini’nin local kapsamı yok (failproofai’nin açığa çıkarmadığı /etc/gemini-cli/settings.json adresinde bir system kapsamını belgeler). Hook girişleri, Claude’un {type, command, timeout} formunu, Gemini’nin {matcher, hooks: [...]} eşleştirici şemasında matcher: "*" ile varsayılan olarak sarmalanmış şekilde kullanır. Olaylar PascalCase (SessionStart, BeforeAgent, AfterAgent, BeforeModel, AfterModel, BeforeToolSelection, BeforeTool, AfterTool, PreCompress, Notification, SessionEnd); işleyici GEMINI_EVENT_MAP aracılığıyla Claude kanonik adlarına eşler. Tool adları snake_case (run_shell_command, read_file, write_file, replace, …) — işleyici GEMINI_TOOL_MAP aracılığıyla normalleştirir, böylece mevcut yerleşik politikalar değişmeden ateşlenir. Politika değerlendiricisi, Gemini’nin düz {decision: "deny", reason} şeklini (Gemini’nin “Golden Rule” exit-0 sözleşmesine göre tercih edilen), BeforeAgent / AfterTool / SessionStart üzerinde bağlam enjeksiyonu için {hookSpecificOutput: {hookEventName, additionalContext}} ve force-retry semantiği için AfterAgent’de {decision: "block", reason} yayar. Gemini CLI desteği beta’dır çünkü gerçek dünya kapsamını genişletiyoruz. Gemini CLI hooks doklarına bakın.
• policies-config.json — failproofai’ye hangi politikaları değerlendireceğini ve hangi parametrelerle değerlendireceğini söyler (tüm agent CLI’leri arasında paylaşılır)

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 gemini --scope project
failproofai policies --install --cli claude codex copilot cursor opencode pi gemini

• Bir CLI algılandı — söylemeden bu CLI’yi otomatik seçer.
• Etkileşimli terminalde birden çok CLI algılandı — Detected (N) bölümüne gruplandırılmış ok tuşu tek seçim istemi gösterir (Detected (N) aggregate aggregate row + algılanan her CLI) ve Not installed (M) · install hooks ahead of time` bölümünde her algılanmayan desteklenen CLI’yi ileri yükleme seçeneği olarak listeler (↑↓ taşı, Enter seç, ^C çık). Kaldırma akışı yalnızca Algılanan bölümü gösterir.
• Etkileşimli olmayan çalıştırmada birden çok CLI algılandı (CI, TTY yok) — sorulmadan tüm algılanan CLI’ler için kurar.
• Hiç algılanmadı — claude’a geri döner ve PATH’da agent ikilisinin bulunmadığına dair bir uyarıyla; hook komutu yine de yazılır, böylece bir tane kurduğunuz anda etkinleşir.

​

Örnek: takım varsayılanlarıyla 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"]
    }
  }
}