failproofai 0.0.6-beta.2 → 0.0.6-beta.4

package/.next/standalone/docs/tr/cli/install-policies.mdx

@@ -1,47 +0,0 @@
----
-title: Politikaları Yükle
-description: "Politikaları etkinleştirin, böylece her aracı çağrısında çalışırlar"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Claude Code'un `settings.json` dosyasına kanca girişleri yazarak failproofai'nin araç çağrılarını kesintiye uğratmasını sağlar.
-
-Takma adlar: `failproofai p -i`
-
-## Seçenekler
-
-| Bayrak | Açıklama |
-|------|-------------|
-| `--scope user` | `~/.claude/settings.json` içine yükle (varsayılan - tüm oturumlar) |
-| `--scope project` | Mevcut dizindeki `.claude/settings.json` içine yükle |
-| `--scope local` | Mevcut dizindeki `.claude/settings.local.json` içine yükle |
-| `--custom <path>` / `-c` | Özel kanca politikaları içeren JS dosyasının yolu |
-
-## Davranış
-
-- **Politika adı yok** - politika seçmek için etkileşimli bir istem açar
-- **Belirli adlar** - bu politikaları etkinleştirir (zaten etkinleştirilmiş olanlar eklenir)
-- **`all`** - mevcut tüm politikaları etkinleştirir
-
-Yükleme toplamsal işlemdir: `--install` komutunu tekrar çalıştırmak mevcut olanları kaldırmadan yeni politikaları ekler.
-
-## Örnekler
-
-```bash
-# Tüm varsayılan politikaları genel olarak yükle (etkileşimli)
-failproofai policies --install
-
-# Mevcut proje için belirli politikaları yükle
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Tüm politikaları birden etkinleştir
-failproofai policies --install all
-
-# Özel politikalar dosyası ile yükle
-failproofai policies --install --custom ./my-policies.js
-```
-
-`--custom <path>` sağlandığında, dosya hemen doğrulanır - en az bir kez `customPolicies.add()` çağrısı yapması gerekir. Çözülen yol, `customPoliciesPath` olarak `policies-config.json` içine kaydedilir.

package/.next/standalone/docs/tr/cli/list-policies.mdx

@@ -1,31 +0,0 @@
----
-title: Politikaları listele
-description: "Hangi politikaların etkin olduğunu, parametrelerini ve özel politikaları görün"
----
-
-```bash
-failproofai policies
-```
-
-Tüm politikaları durumları, yapılandırılmış parametreleri ve özel politikaları ile birlikte gösterir.
-
-## Örnek çıktı
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-`policyParams` içindeki bilinmeyen anahtarlar burada işaretlenir, böylece yazım hatalarını erken yakalayabilirsiniz.

package/.next/standalone/docs/tr/cli/remove-policies.mdx

@@ -1,44 +0,0 @@
----
----
-title: Politikaları Kaldır
-description: "Claude Code'un ayarlarından hook girişlerini kaldırın"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-failproofai hook girişlerini Claude Code'un `settings.json` dosyasından kaldırır.
-
-Takma adlar: `failproofai p -u`
-
-## Seçenekler
-
-| Bayrak | Açıklama |
-|------|-------------|
-| `--scope user` | Genel ayarlardan kaldırın (varsayılan) |
-| `--scope project` | Proje ayarlarından kaldırın |
-| `--scope local` | Yerel ayarlardan kaldırın |
-| `--scope all` | Tüm kapsamlardan aynı anda kaldırın |
-| `--custom` / `-c` | Yapılandırmadan `customPoliciesPath` temizleyin |
-
-## Davranış
-
-- **Policy adı belirtilmezse** - ayarlar dosyasındaki tüm failproofai hook girişlerini kaldırır
-- **Belirli adlar** - bu politikaları devre dışı bırakır ancak kurulu hook'ları tutmaya devam eder
-
-## Örnekler
-
-```bash
-# Tüm hook'ları global olarak kaldır
-failproofai policies --uninstall
-
-# Belirli bir politikayı devre dışı bırak (kurulu hook'ları tutar)
-failproofai policies --uninstall block-sudo
-
-# Hook'ları her kapsamdan kaldır
-failproofai policies --uninstall --scope all
-
-# Özel politikalar yolunu temizle
-failproofai policies --uninstall --custom
-```

package/.next/standalone/docs/tr/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: Sürümü kontrol et
-description: "Yüklü failproofai sürümünü yazdır"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-Yüklü sürüm numarasını yazdırır.

package/.next/standalone/docs/tr/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: Yapılandırma
-description: "Konfigürasyon dosyası formatı, üç kapsamlı sistem ve birleştirme kuralları"
-icon: gear
----
-
-failproofai, hangi politikaların aktif olduğunu, nasıl davrandıklarını ve özel politikaların nereden yüklendiğini kontrol etmek için JSON konfigürasyon dosyalarını kullanır. Yapılandırma, ekibinizle paylaşmak için tasarlanmıştır - bunu deponuza gönderin ve her geliştirici aynı aracı güvenlik ağını alır.
-
----
-
-## Yapılandırma kapsamları
-
-Üç yapılandırma kapsamı vardır ve öncelik sırasına göre değerlendirilir:
-
-| Kapsam | Dosya yolu | Amaç |
-|-------|-----------|---------|
-| **project** | `.failproofai/policies-config.json` | Depo başına ayarlar, sürüm kontrolüne kaydedilir |
-| **local** | `.failproofai/policies-config.local.json` | Kişisel depo başına geçersiz kılmalar, gitignored |
-| **global** | `~/.failproofai/policies-config.json` | Tüm projeler genelinde kullanıcı düzeyinde varsayılanlar |
-
-failproofai bir hook olayı aldığında, mevcut çalışma dizini için var olan üç dosyayı da yükler ve birleştirir.
-
-### Birleştirme kuralları
-
-**`enabledPolicies`** - üç kapsamın tümünün birleşimi. Herhangi bir düzeyde etkinleştirilen bir politika aktiftir.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← yinelenenden arındırılmış birleşim
-```
-
-**`policyParams`** - verilen bir politika için parametreleri tanımlayan ilk kapsam tamamen kazanır. Bir politikanın parametreleri içindeki değerlerin derin birleştirilmesi yoktur.
-
-```text
-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
-```
-
-```text
-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'a düşer
-```
-
-**`customPoliciesPath`** - onu tanımlayan ilk kapsam kazanır.
-
-**`llm`** - onu tanımlayan ilk kapsam kazanır.
-
----
-
-## Konfigürasyon dosyası formatı
-
-```json
-{
-  "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`
-
-Tip: `string[]`
-
-Etkinleştirilecek politika adlarının listesi. Adlar, `failproofai policies` tarafından gösterilen politika tanımlayıcılarıyla tam olarak eşleşmelidir. Tam liste için [Yerleşik Politikalar](/tr/built-in-policies) bölümüne bakın.
-
-`enabledPolicies` içinde olmayan politikalar, `policyParams` içinde girişleri olsa bile inaktiftir.
-
-### `policyParams`
-
-Tip: `Record<string, Record<string, unknown>>`
-
-Politika başına parametre geçersiz kılmaları. Dış anahtar politika adıdır; iç anahtarlar politikaya özgüdür. Her politika, mevcut parametrelerini [Yerleşik Politikalar](/tr/built-in-policies) bölümünde belgeler.
-
-Bir politikanın parametreleri varsa ancak bunları belirtmezseniz, politikanın yerleşik varsayılanları kullanılır. `policyParams`'ı hiç yapılandırmayan kullanıcılar, önceki sürümlerle aynı davranışı alırlar.
-
-Bir politikanın parametreleri bloğu içindeki bilinmeyen anahtarlar, hook tetiklendiğinde sessizce yoksayılır ancak `failproofai policies` çalıştırdığınızda uyarılar olarak işaretlenir.
-
-#### `hint` (çapraz kesme)
-
-Tip: `string` (isteğe bağlı)
-
-Bir politika `deny` veya `instruct` döndürdüğünde nedene eklenen bir mesaj. Politikanın kendisini değiştirmeden Claude'a işlenebilir rehberlik vermek için kullanın.
-
-Herhangi bir politika türüyle çalışır — yerleşik, özel (`custom/`), proje kuralı (`.failproofai-project/`) veya kullanıcı kuralı (`.failproofai-user/`).
-
-```json
-{
-  "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."
-    }
-  }
-}
-```
-
-`block-force-push` reddettiğinde, Claude şunu görür: *"Force-pushing bloke edildi. Bunun yerine yeni bir dal oluşturmayı deneyin."*
-
-String olmayan değerler ve boş dizeler sessizce yoksayılır. `hint` ayarlanmamışsa, davranış değişmez (geriye dönük uyumlu).
-
-### `customPoliciesPath`
-
-Tip: `string` (mutlak yol)
-
-Özel hook politikaları içeren JavaScript dosyasının yolu. Bu, `failproofai policies --install --custom <path>` tarafından otomatik olarak ayarlanır (yol depolanmadan önce mutlaka çözülür).
-
-Dosya her hook olayında yeniden yüklenir - önbelleğe alma yoktur. Yazma detayları için [Özel Politikalar](/tr/custom-policies) bölümüne bakın.
-
-### Kural tabanlı politikalar
-
-Açık `customPoliciesPath` ek olarak, failproofai `.failproofai/policies/` dizinlerinden politika dosyalarını otomatik olarak keşfeder ve yükler:
-
-| Düzey | Dizin | Kapsam |
-|-------|-----------|-------|
-| Proje | `.failproofai/policies/` | Sürüm kontrolü aracılığıyla ekiple paylaşılır |
-| Kullanıcı | `~/.failproofai/policies/` | Kişisel, tüm projeler için geçerli |
-
-**Dosya eşleştirme:** Yalnızca `*policies.{js,mjs,ts}` ile eşleşen dosyalar yüklenir (ör. `security-policies.mjs`, `workflow-policies.js`). Dizindeki diğer dosyalar yoksayılır.
-
-**Config gerekmez:** Kural politikaları `policies-config.json` içinde giriş gerektirmez. Dosyaları dizine bırakın ve sonraki hook olayında alınırlar.
-
-**Birleşim yüklemesi:** Hem proje hem de kullanıcı kural dizinleri taranır. Her iki düzeyden de eşleşen tüm dosyalar yüklenir (`customPoliciesPath` ilk kapsam kazanır kullanan aksine).
-
-Daha fazla ayrıntı ve örnekler için [Özel Politikalar](/tr/custom-policies) bölümüne bakın.
-
-### `llm`
-
-Tip: `object` (isteğe bağlı)
-
-AI çağrıları yapan politikalar için LLM istemci yapılandırması. Çoğu kurulum için gerekli değildir.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## CLI'dan yapılandırmayı yönetme
-
-`policies --install` ve `policies --uninstall` komutları Claude Code'un `settings.json` dosyasına (hook giriş noktaları) yazarken, `policies-config.json` doğrudan yönettiğiniz dosyadır. İkisi ayrıdır:
-
-- **`settings.json`** - Claude Code'a her araç kullanımında `failproofai --hook <event>` çağırmasını söyler
-- **`policies-config.json`** - failproofai'ye hangi politikaları değerlendireceğini ve ne parametre ile değerlendireceğini söyler
-
-`policies-config.json` dosyasını dilediğiniz zaman doğrudan düzenleyebilirsiniz; değişiklikler yeniden başlatmaya gerek olmadan sonraki hook olayında etkilenir.
-
----
-
-## Örnek: takım varsayılanları ile proje düzeyi config
-
-`.failproofai/policies-config.json` dosyasını deponuza gönderin:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Her geliştirici, ekip arkadaşlarını etkilemeden kişisel geçersiz kılmalar için `.failproofai/policies-config.local.json` (gitignored) oluşturabilir.