failproofai 0.0.2-beta.8 → 0.0.2-beta.9

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

@@ -0,0 +1,31 @@
+---
+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

@@ -0,0 +1,45 @@
+---
+---
+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.
+
+Diğer 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` değerini temizleyin |
+| `--beta` | Yalnızca beta politikaları yapılandırmadan kaldırın |
+
+## Davranış
+
+- **Politika adı yok** - ayar dosyasındaki tüm failproofai hook girişlerini kaldırır
+- **Belirli adlar** - bu politikaları devre dışı bırakır ancak kurulu hook'ları korur
+
+## Örnekler
+
+```bash
+# Tüm hook'ları genel kapsamdan kaldır
+failproofai policies --uninstall
+
+# Belirli bir politikayı devre dışı bırak (kurulu hook'ları korur)
+failproofai policies --uninstall block-sudo
+
+# Hook'ları tüm kapsamlardan kaldır
+failproofai policies --uninstall --scope all
+
+# Özel politikalar yolunu temizle
+failproofai policies --uninstall --custom
+```

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

@@ -0,0 +1,12 @@
+---
+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

@@ -0,0 +1,223 @@
+---
+---
+title: Yapılandırma
+description: "Yapılandırma dosyası biçimi, üç 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 yapılandırma dosyalarını kullanır. Yapılandırma, takımınızla paylaşmak için kolay olacak şekilde tasarlanmıştır - bunu deponuza gönderin ve her geliştirici aynı agent güvenlik ağını alır.
+
+---
+
+## Yapılandırma kapsamları
+
+Üç yapılandırma kapsamı vardır ve öncelik sırasına göre değerlendirilirler:
+
+| Kapsam | Dosya yolu | Amaç |
+|-------|-----------|---------|
+| **project** | `.failproofai/policies-config.json` | Depo başına ayarlar, sürüm kontrolüne gönderilir |
+| **local** | `.failproofai/policies-config.local.json` | Kişisel depo başına geçersiz kılmalar, gitignore'da |
+| **global** | `~/.failproofai/policies-config.json` | Tüm projeler genelindeki kullanıcı düzeyindeki varsayılanlar |
+
+failproofai bir hook olayı aldığında, geçerli çalışma dizini için var olan üç dosyanın tümünü 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 etkindir.
+
+```text
+project:  ["block-sudo"]
+local:    ["block-rm-rf"]
+global:   ["block-sudo", "sanitize-api-keys"]
+
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← tekilleştirilmiş birleşim
+```
+
+**`policyParams`** - belirli bir politika için parametreleri tanımlayan ilk kapsam tamamen kazanır. Bir politikanın parametreleri içinde derin birleştirme 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 girdisi yok)
+local:    (block-sudo girdisi yok)
+global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
+
+resolved: { allowPatterns: ["sudo systemctl status"] }  ← global'e düşer
+```
+
+**`customPoliciesPath`** - onu tanımlayan ilk kapsam kazanır.
+
+**`llm`** - onu tanımlayan ilk kapsam kazanır.
+
+---
+
+## Yapılandırma dosyası biçimi
+
+```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 başvurusu
+
+### `enabledPolicies`
+
+Tür: `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 girdileri olsa bile etkin değildir.
+
+### `policyParams`
+
+Tür: `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) içinde belgelemir.
+
+Bir politikanın parametreleri varsa ancak bunları belirtmezseniz, politikanın yerleşik varsayılanları kullanılır. `policyParams` yapılandırırmayan kullanıcılar önceki sürümlerle aynı davranışı alırlar.
+
+Bir politikanın params 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)
+
+Tür: `string` (isteğe bağlı)
+
+Bir politika `deny` veya `instruct` döndürdüğünde nedene eklenen bir ileti. Bunu, politikanın kendisini değiştirmeden Claude'a işlem yapılabilir rehberlik sağlamak 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 apt-get'i doğrudan kullanın."
+    },
+    "custom/my-policy": {
+      "hint": "Önce kullanıcıdan onay alın."
+    }
+  }
+}
+```
+
+`block-force-push` reddettiğinde, Claude şunu görür: *"Zorla push yapmak engelleniyor. Bunun yerine yeni bir dal oluşturmayı deneyin."*
+
+String olmayan değerler ve boş diziler sessizce yoksayılır. `hint` ayarlanmazsa, davranış değişmez (geriye dönük uyumlu).
+
+### `customPoliciesPath`
+
+Tür: `string` (mutlak yol)
+
+Özel hook politikalarını içeren JavaScript dosyasının yolu. Bu, `failproofai policies --install --custom <path>` tarafından otomatik olarak ayarlanır (yol depolanmadan önce mutlak olarak çözülür).
+
+Dosya her hook olayında yeniden yüklenir - önbelleğe alma yoktur. Yazma ayrıntıları için [Özel Politikalar](/tr/custom-policies) bölümüne bakın.
+
+### Kural tabanlı politikalar (v0.0.2-beta.7+)
+
+Açık `customPoliciesPath` öğesine ek olarak, failproofai `.failproofai/policies/` dizinlerinden policy dosyalarını otomatik olarak keşfeder ve yükler:
+
+| Düzey | Dizin | Kapsam |
+|-------|-----------|-------|
+| Proje | `.failproofai/policies/` | Sürüm kontrolü aracılığıyla takımla paylaşılır |
+| Kullanıcı | `~/.failproofai/policies/` | Kişisel, tüm projelere uygulanır |
+
+**Dosya eşleştirmesi:** 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.
+
+**Yapılandırma gerekli değil:** Kural politikaları `policies-config.json` içinde girdiler gerektirmez. Dosyaları dizine bırakın ve sonraki hook olayında seçilecektir.
+
+**Birleşim yükleme:** Hem proje hem de kullanıcı kural dizinleri taranır. Her iki düzeydeki tüm eşleşen dosyalar yüklenir (`customPoliciesPath` ilk kapsam kazanır'ı kullandığından farklı olarak).
+
+Daha fazla ayrıntı ve örnek için [Özel Politikalar](/tr/custom-policies) bölümüne bakın.
+
+### `llm`
+
+Tür: `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ğil.
+
+```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 yazarken (hook giriş noktaları), `policies-config.json` doğrudan yönettiğiniz dosyadır. İkisi ayrıdır:
+
+- **`settings.json`** - Claude Code'a her tool kullanımında `failproofai --hook <event>` çağırmasını söyler
+- **`policies-config.json`** - failproofai'ye hangi politikaları değerlendireceğini ve hangi parametrelerle değerlendireceğini söyler
+
+`policies-config.json` dosyasını herhangi bir zamanda doğrudan düzenleyebilirsiniz; değişiklikler yeniden başlatmaya gerek kalmadan sonraki hook olayında geçerli olur.
+
+---
+
+## Örnek: takım varsayılanları ile proje düzeyindeki yapılandırma
+
+`.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"]
+    }
+  }
+}
+```
+
+Ardından her geliştirici, takım arkadaşlarını etkilemeden kişisel geçersiz kılmalar için `.failproofai/policies-config.local.json` (gitignore'da) oluşturabilir.

package/.next/standalone/docs/tr/custom-policies.mdx

@@ -0,0 +1,357 @@
+---
+title: Özel Politikalar
+description: "JavaScript'te kendi politikalarınızı yazın - kuralları uygulayın, sapmayı önleyin, hataları algılayın, harici sistemlerle entegre olun"
+icon: code
+---
+
+Özel politikalar, herhangi bir agent davranışı için kurallar yazmanıza izin verir: proje kurallarını uygulayın, sapmayı önleyin, yıkıcı işlemleri engelle, sıkışmış aracıları algılayın veya Slack, onay iş akışları ve daha fazlasıyla entegre olun. Yerleşik politikalarla aynı hook etkinliği sistemini ve `allow`, `deny`, `instruct` kararlarını kullanırlar.
+
+---
+
+## Hızlı örnek
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) {
+      return deny("Writes to production paths are blocked");
+    }
+    return allow();
+  },
+});
+```
+
+Yükleyin:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+---
+
+## Özel politikaları yüklemenin iki yolu
+
+### Seçenek 1: Kural tabanlı (önerilen, v0.0.2-beta.7+)
+
+`.failproofai/policies/` dizinine `*policies.{js,mjs,ts}` dosyalarını bırakın ve otomatik olarak yüklenirler — hiçbir bayrak veya yapılandırma değişikliğine gerek yoktur. Bu git hook'ları gibi çalışır: bir dosya bırakın ve çalışır.
+
+```
+# Proje düzeyi — git'e kaydedilir, ekiple paylaşılır
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Kullanıcı düzeyi — kişisel, tüm projelere uygulanır
+~/.failproofai/policies/my-policies.mjs
+```
+
+**Nasıl çalışır:**
+- Hem proje hem de kullanıcı dizinleri taranır (birleşim — ilk-kapsam-kazanır değil)
+- Dosyalar her dizin içinde alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` ile önekleyin
+- Yalnızca `*policies.{js,mjs,ts}` ile eşleşen dosyalar yüklenir; diğer dosyalar yoksayılır
+- Her dosya bağımsız olarak yüklenir (dosya başına açık-fail)
+- Açık `--custom` ve yerleşik politikalarla birlikte çalışır
+
+<Tip>
+Kural politikaları, politikaları bir ekip genelinde paylaşmanın en kolay yoludur. `.failproofai/policies/` öğesini git'e işleyin ve her takım üyesi otomatik olarak bunları alır.
+</Tip>
+
+### Seçenek 2: Açık dosya yolu
+
+```bash
+# Özel politika dosyasıyla yükleyin
+failproofai policies --install --custom ./my-policies.js
+
+# Politika dosyasının yolunu değiştirin
+failproofai policies --install --custom ./new-policies.js
+
+# Yapılandırmadan özel politika yolunu kaldırın
+failproofai policies --uninstall --custom
+```
+
+Çözümlenen mutlak yol, `policies-config.json` içinde `customPoliciesPath` olarak depolanır. Dosya her hook etkinliğinde yeniden yüklenir - olaylar arasında önbellekleme yoktur.
+
+### Her ikisini birlikte kullanma
+
+Kural politikaları ve açık `--custom` dosyası birlikte varolabilir. Yükleme sırası:
+
+1. Açık `customPoliciesPath` dosyası (yapılandırılmışsa)
+2. Proje kural dosyaları (`{cwd}/.failproofai/policies/`, alfabetik)
+3. Kullanıcı kural dosyaları (`~/.failproofai/policies/`, alfabetik)
+
+---
+
+## API
+
+### İçe aktarma
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+```
+
+### `customPolicies.add(hook)`
+
+Bir politikayı kaydeder. Aynı dosyada birden çok politika için gerektiği kadar çağırın.
+
+```ts
+customPolicies.add({
+  name: string;                         // zorunlu - benzersiz tanımlayıcı
+  description?: string;                 // `failproofai policies` çıktısında gösterilir
+  match?: { events?: HookEventType[] }; // etkinlik türüne göre filtrele; tümünü eşleştirmek için atlayın
+  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
+});
+```
+
+### Karar yardımcıları
+
+| İşlev | Etki | Ne zaman kullanılır |
+|----------|--------|----------|
+| `allow()` | İşleme sessizce izin ver | İşlem güvenli, mesaj gerekmez |
+| `deny(message)` | İşlemi engelle | Agent bu işlemi yapmamalı |
+| `instruct(message)` | Bloklamadan bağlam ekle | Agent'a yolunda kalması için ekstra bağlam ver |
+
+`deny(message)` - ileti Claude'a `"Blocked by failproofai:"` ön eki ile görünür. Tek bir `deny` tüm diğer değerlendirmeleri kısaltır.
+
+`instruct(message)` - ileti, Claude'un geçerli araç çağrısı için bağlamına eklenir. Tüm `instruct` iletileri biriktirilir ve birlikte iletilir.
+
+<Tip>
+`policyParams` içinde `hint` alanı ekleyerek herhangi bir `deny` veya `instruct` iletisine ekstra rehberlik ekleyebilirsiniz — kod değişikliğine gerek yoktur. Bu özel (`custom/`), proje kural (`.failproofai-project/`) ve kullanıcı kural (`.failproofai-user/`) politikaları için de çalışır. Ayrıntılar için [Yapılandırma → hint](/tr/configuration#hint-cross-cutting) bölümüne bakın.
+</Tip>
+
+### Bilgilendirici izin iletileri (beta)
+
+<Note>
+`allow(message)` v0.0.2-beta.3'ten beri mevcut olan bir beta özelliğidir. API gelecek sürümlerde değişebilir. Önceki sürümler yalnızca `allow()` öğesini argümanlar olmadan destekler.
+</Note>
+
+`allow(message)` işleme izin verir **ve** Claude'a bilgilendirici bir ileti gönderir. İleti, hook işleyicisinin stdout yanıtında `additionalContext` olarak iletilir — `instruct` tarafından kullanılan mekanizmayla aynı, ancak anlamsal olarak farklı: bir uyarı değil, bir durum güncellemesidir.
+
+| İşlev | Etki | Ne zaman kullanılır |
+|----------|--------|----------|
+| `allow(message)` | İzin ver ve Claude'a bağlam gönder | Bir kontrol geçmesini onaylayın veya bir kontrol neden atlandığını açıklayın |
+
+Kullanım örnekleri:
+- **Durum onayları:** `allow("All CI checks passed.")` — Claude'a her şeyin yeşil olduğunu söyler
+- **Fail-open açıklamaları:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude'a bir kontrol neden atlandığını söyler, böylece tam bağlama sahiptir
+- **Birden çok ileti birikir:** birden çok politika `allow(message)` döndürürse, tüm iletiler yeni satırlarla birleştirilir ve birlikte iletilir
+
+```js
+customPolicies.add({
+  name: "confirm-branch-status",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    const cwd = ctx.session?.cwd;
+    if (!cwd) return allow("No working directory, skipping branch check.");
+
+    // ... branch durumunu kontrol et ...
+    if (allPushed) {
+      return allow("Branch is up to date with remote.");
+    }
+    return deny("Unpushed changes detected.");
+  },
+});
+```
+
+### `PolicyContext` alanları
+
+| Alan | Tür | Açıklama |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string \| undefined` | Çağrılan araç (örn. `"Bash"`, `"Write"`, `"Read"`) |
+| `toolInput` | `Record<string, unknown> \| undefined` | Aracının giriş parametreleri |
+| `payload` | `Record<string, unknown>` | Claude Code'dan tam ham olay yükü |
+| `session` | `SessionMetadata \| undefined` | Oturum bağlamı (aşağıya bakın) |
+
+### `SessionMetadata` alanları
+
+| Alan | Tür | Açıklama |
+|-------|------|-------------|
+| `sessionId` | `string` | Claude Code oturum tanımlayıcısı |
+| `cwd` | `string` | Claude Code oturumunun çalışma dizini |
+| `transcriptPath` | `string` | Oturumun JSONL transkript dosyasının yolu |
+
+### Etkinlik türleri
+
+| Etkinlik | Ne zaman ateşlenir | `toolInput` içeriği |
+|-------|--------------|----------------------|
+| `PreToolUse` | Claude bir aracı çalıştırmadan önce | Aracının girdisi (örn. Bash için `{ command: "..." }`) |
+| `PostToolUse` | Bir araç tamamlandıktan sonra | Aracının girdisi + `tool_result` (çıktı) |
+| `Notification` | Claude bir bildirim gönderdiğinde | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hook'lar her zaman `allow()` döndürmelidir, bildirimleri bloklamaz |
+| `Stop` | Claude oturumu sona erdiğinde | Boş |
+
+---
+
+## Değerlendirme sırası
+
+Politikalar şu sırayla değerlendirilir:
+
+1. Yerleşik politikalar (tanım sırasında)
+2. `customPoliciesPath` öğesinden açık özel politikalar (`.add()` sırasında)
+3. Proje `.failproofai/policies/` öğesinden kural politikaları (dosyalar alfabetik, içinde `.add()` sırası)
+4. Kullanıcı `~/.failproofai/policies/` öğesinden kural politikaları (dosyalar alfabetik, içinde `.add()` sırası)
+
+<Note>
+İlk `deny` tüm sonraki politikaları kısaltır. Tüm `instruct` iletileri biriktirilir ve birlikte iletilir.
+</Note>
+
+---
+
+## Geçişli içe aktarmalar
+
+Özel politika dosyaları göreli yolları kullanan yerel modülleri içe aktarabilir:
+
+```js
+// my-policies.js
+import { isBlockedPath } from "./utils.js";
+import { checkApproval } from "./approval-client.js";
+
+customPolicies.add({
+  name: "approval-gate",
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const approved = await checkApproval(ctx.toolInput?.command, ctx.session?.sessionId);
+    return approved ? allow() : deny("Approval required for this command");
+  },
+});
+```
+
+Giriş dosyasından erişilebilen tüm göreli içe aktarmalar çözülür. Bu, `from "failproofai"` içe aktarmalarını gerçek dist yoluna yeniden yazarak ve ESM uyumluluğunu sağlamak için geçici `.mjs` dosyaları oluşturarak uygulanır.
+
+---
+
+## Etkinlik türü filtrelemesi
+
+Bir politikanın ne zaman ateşlendiğini sınırlamak için `match.events` öğesini kullanın:
+
+```js
+customPolicies.add({
+  name: "require-summary-on-stop",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    // Yalnızca oturum sona erdiğinde ateşlenir
+    // ctx.session.transcriptPath tam oturum günlüğünü içerir
+    return allow();
+  },
+});
+```
+
+Her etkinlik türünde ateşlemek için `match` öğesini tamamen atlayın.
+
+---
+
+## Hata işleme ve başarısızlık modları
+
+Özel politikalar **açık başarısızlık**: hatalar hiçbir zaman yerleşik politikaları bloklamaz veya hook işleyicisini çökmez.
+
+| Başarısızlık | Davranış |
+|---------|----------|
+| `customPoliciesPath` ayarlanmadı | Açık özel politika çalışmaz; kural politikaları ve yerleşikler normal şekilde devam eder |
+| Dosya bulunamadı | Uyarı `~/.failproofai/hook.log` öğesine kaydedilir; yerleşikler devam eder |
+| Sözdizimi/içe aktarma hatası (açık) | Hata `~/.failproofai/hook.log` öğesine kaydedilir; açık özel politikalar atlanır |
+| Sözdizimi/içe aktarma hatası (kural) | Hata kaydedilir; bu dosya atlanır, diğer kural dosyaları yine de yüklenir |
+| `fn` çalışma zamanında hatası | Hata kaydedilir; bu hook `allow` olarak kabul edilir; diğer hook'lar devam eder |
+| `fn` 10 saniyeden uzun sürerse | Zaman aşımı kaydedilir; `allow` olarak kabul edilir |
+| Kural dizini eksik | Kural politikası çalışmaz; hata yoktur |
+
+<Tip>
+Özel politika hatalarını ayıklamak için günlük dosyasını izleyin:
+
+```bash
+tail -f ~/.failproofai/hook.log
+```
+</Tip>
+
+---
+
+## Tam örnek: birden çok politika
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+// Agent'i secrets/ dizinine yazmaktan önle
+customPolicies.add({
+  name: "block-secrets-dir",
+  description: "Prevent agent from writing to secrets/ directory",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("secrets/")) return deny("Writing to secrets/ is not permitted");
+    return allow();
+  },
+});
+
+// Agent'i yolunda tut: işleme atmadan önce testleri doğrula
+customPolicies.add({
+  name: "remind-test-before-commit",
+  description: "Keep the agent on track: verify tests pass before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Verify all tests pass before committing. Run `bun test` if you haven't already.");
+    }
+    return allow();
+  },
+});
+
+// Dondurma döneminde plansız bağımlılık değişikliklerini önle
+customPolicies.add({
+  name: "dependency-freeze",
+  description: "Prevent unplanned dependency changes during freeze period",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    const isInstall = /^(npm install|yarn add|bun add|pnpm add)\s+\S/.test(cmd);
+    if (isInstall && process.env.DEPENDENCY_FREEZE === "1") {
+      return deny("Package installs are frozen. Unset DEPENDENCY_FREEZE to allow.");
+    }
+    return allow();
+  },
+});
+
+export { customPolicies };
+```
+
+---
+
+## Örnekler
+
+`examples/` dizini çalışmaya hazır politika dosyalarını içerir:
+
+| Dosya | İçerik |
+|------|----------|
+| `examples/policies-basic.js` | Ortak agent başarısızlık modlarını kapsayan beş başlatıcı politika |
+| `examples/policies-advanced/index.js` | Gelişmiş desenleri: geçişli içe aktarmalar, eşzamansız çağrılar, çıktı temizleme ve oturum sonu hook'ları |
+| `examples/convention-policies/security-policies.mjs` | Kural tabanlı güvenlik politikaları (.env yazılarını blokla, git geçmişini yeniden yazmayı önle) |
+| `examples/convention-policies/workflow-policies.mjs` | Kural tabanlı iş akışı politikaları (test hatırlatmaları, dosya yazma denetimi) |
+
+### Açık dosya örneklerini kullanma
+
+```bash
+failproofai policies --install --custom ./examples/policies-basic.js
+```
+
+### Kural tabanlı örnekleri kullanma
+
+```bash
+# Proje düzeyine kopyala
+mkdir -p .failproofai/policies
+cp examples/convention-policies/*.mjs .failproofai/policies/
+
+# Veya kullanıcı düzeyine kopyala
+mkdir -p ~/.failproofai/policies
+cp examples/convention-policies/*.mjs ~/.failproofai/policies/
+```
+
+Yükleme komutu gerekli değildir — dosyalar sonraki hook etkinliğinde otomatik olarak seçilir.