failproofai 0.0.5 → 0.0.6-beta.0

package/.next/standalone/docs/i18n/README.tr.md

@@ -23,25 +23,25 @@
 
 **Çeviriler**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
 
-AI ajanlarınızı güvenilir, görev odaklı ve otonom şekilde çalışmasını sağlayan politikaları yönetmenin en kolay yolu - **Claude Code** ve **Agents SDK** için.
+AI aracılarınızı güvenilir, odaklanmış ve özerk olarak çalıştırmanızı sağlayan politikaları yönetmenin en kolay yolu - **Claude Code** ve **Agents SDK** için.
 
-- **30 Yerleşik Politika** - Yaygın ajan başarısızlık modlarını hemen tespit edin. Yıkıcı komutları engelleyin, gizli bilgilerin sızmasını önleyin, ajanları proje sınırları içinde tutun, döngüleri tespit edin ve daha fazlası.
-- **Özel Politikalar** - JavaScript'te kendi güvenilirlik kurallarınızı yazın. Kuralları zorunlu kılmak, sürüklenmeyi önlemek, işlemleri kontrol etmek veya harici sistemlerle entegre olmak için `allow`/`deny`/`instruct` API'sini kullanın.
-- **Kolay Yapılandırma** - Herhangi bir politikayı kod yazmadan ayarlayın. İzin listelerini, korumalı dalları, eşikleri proje başına veya küresel olarak ayarlayın. Üç kapsamlı konfigürasyon otomatik olarak birleştirilir.
-- **Ajan İzleyici** - Ajanlarınız uzakta iken ne yaptığını görün. Oturumları göz atın, her araç çağrısını inceleyin ve politikaların tam olarak nerede etkinleştirildiğini gözden geçirin.
+- **30 Hazır Politika** - Hemen kullanıma hazır yaygın ajan başarısızlık durumlarını yakalayın. Zararlı komutları engelleyin, gizli sızıntılarını önleyin, ajanları proje sınırları içinde tutun, döngüleri algılayın ve daha fazlası.
+- **Özel Politikalar** - JavaScript'te kendi güvenilirlik kurallarınızı yazın. Kuralları uygulamak, değişimi önlemek, işlemleri kontrol etmek veya harici sistemlerle entegre olmak için `allow`/`deny`/`instruct` API'sini kullanın.
+- **Kolay Yapılandırma** - Herhangi bir politikayı kod yazmadan ayarlayın. İzin listeleri, korunan dallar, eşikler projeye veya global olarak ayarlayın. Üç kapsam yapılandırması otomatik olarak birleşir.
+- **Ajan İzleyici** - Aracılarınız yokken ne yaptığını görün. Oturumları tarayın, her araç çağrısını inceleyin ve politikaların tam olarak nerede etkinleştiğini gözden geçirin.
 
-Her şey yerel olarak çalışır - hiçbir veri makinenizi terk etmez.
+Her şey yerel olarak çalışır - hiçbir veri makinenizden çıkmaz.
 
 ---
 
 ## Gereksinimler
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (isteğe bağlı - yalnızca geliştirme / kaynaktan oluşturma için gerekli)
+- Bun >= 1.3.0 (isteğe bağlı - yalnızca geliştirme / kaynak koddan derleme için gerekli)
 
 ---
 
-## Kurulum
+## Yükle
 
 ```bash
 npm install -g failproofai
@@ -53,23 +53,23 @@ bun add -g failproofai
 
 ## Hızlı başlangıç
 
-### 1. Politikaları küresel olarak etkinleştirin
+### 1. Politikaları global olarak etkinleştir
 
 ```bash
 failproofai policies --install
 ```
 
-`~/.claude/settings.json` dosyasına hook girişleri yazar. Claude Code artık her araç çağrısından önce ve sonra failproofai'ı çağıracaktır.
+`~/.claude/settings.json` dosyasına kancaya girişler yazar. Claude Code artık her araç çağrısından önce ve sonra failproofai'ı çağıracaktır.
 
-### 2. Pano başlatın
+### 2. Panoyu başlat
 
 ```bash
 failproofai
 ```
 
-`http://localhost:8020` açılır - oturumları göz atın, günlükleri inceleyin, politikaları yönetin.
+`http://localhost:8020` açılır - oturumları tarayın, günlükleri inceleyin, politikaları yönetin.
 
-### 3. Etkin olanları kontrol edin
+### 3. Aktif olanları kontrol et
 
 ```bash
 failproofai policies
@@ -82,18 +82,18 @@ failproofai policies
 ### Kapsamlar
 
 | Kapsam | Komut | Nereye yazar |
-|--------|-------|-------------|
-| Küresel (varsayılan) | `failproofai policies --install` | `~/.claude/settings.json` |
+|--------|-------|--------------|
+| Global (varsayılan) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Proje | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | Yerel | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
-### Belirli politikaları yükleyin
+### Belirli politikaları kur
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 ```
 
-### Politikaları kaldırın
+### Politikaları kaldır
 
 ```bash
 failproofai policies --uninstall
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Yapılandırma
 
-Politika yapılandırması `~/.failproofai/policies-config.json` dosyasında (küresel) veya projenizin `.failproofai/policies-config.json` dosyasında (proje başına) bulunur.
+Politika yapılandırması `~/.failproofai/policies-config.json` (global) veya projenizdeki `.failproofai/policies-config.json` (proje başına) içinde bulunur.
 
 ```json
 {
@@ -120,7 +120,7 @@ Politika yapılandırması `~/.failproofai/policies-config.json` dosyasında (k
   "policyParams": {
     "block-sudo": {
       "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "sudo olmadan doğrudan apt-get kullanın."
+      "hint": "Sudo olmadan apt-get'i doğrudan kullanın."
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
@@ -128,7 +128,7 @@ Politika yapılandırması `~/.failproofai/policies-config.json` dosyasında (k
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API anahtarı" }
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
       ]
     },
     "warn-large-file-write": {
@@ -138,39 +138,39 @@ Politika yapılandırması `~/.failproofai/policies-config.json` dosyasında (k
 }
 ```
 
-**Üç konfigürasyon kapsamı** otomatik olarak birleştirilir (proje → yerel → küresel). Tam birleştirme kuralları için bkz. [docs/configuration.mdx](docs/configuration.mdx).
+**Üç yapılandırma kapsamı** otomatik olarak birleştirilir (proje → yerel → global). Tam birleştirme kuralları için [docs/configuration.mdx](docs/configuration.mdx) bölümüne bakın.
 
 ---
 
-## Yerleşik politikalar
+## Hazır politikalar
 
 | Politika | Açıklama | Yapılandırılabilir |
 |----------|----------|:---:|
-| `block-sudo` | Ajanları ayrıcalıklı sistem komutlarını çalıştırmaktan engelle | `allowPatterns` |
-| `block-rm-rf` | Kazara özyinelemeli dosya silmeyi engelle | `allowPaths` |
-| `block-curl-pipe-sh` | Ajanları güvenilmeyen betikleri kabuğa yöneltmekten engelle | |
-| `block-failproofai-commands` | Kendi kaldırılmasını engelle | |
-| `sanitize-jwt` | JWT belirteçlerinin ajan bağlamına sızmasını durdur | |
+| `block-sudo` | Ajanları ayrıcalıklı sistem komutlarını çalıştırmaktan önle | `allowPatterns` |
+| `block-rm-rf` | Tesadüfi özyinelemeli dosya silmeyi önle | `allowPaths` |
+| `block-curl-pipe-sh` | Ajanları güvenilmez betikleri shell'e yönlendirmekten önle | |
+| `block-failproofai-commands` | Kendi kendine kaldırılmayı önle | |
+| `sanitize-jwt` | JWT jetonlarının ajan bağlamına sızmasını durdur | |
 | `sanitize-api-keys` | API anahtarlarının ajan bağlamına sızmasını durdur | `additionalPatterns` |
 | `sanitize-connection-strings` | Veritabanı kimlik bilgilerinin ajan bağlamına sızmasını durdur | |
-| `sanitize-private-key-content` | Çıktıdan PEM özel anahtar bloklarını gizle | |
-| `sanitize-bearer-tokens` | Authorization Bearer belirteçlerini çıktıdan gizle | |
-| `block-env-files` | Ajanları .env dosyalarını okumaktan engelle | |
-| `protect-env-vars` | Ajanları ortam değişkenlerini yazdırmaktan engelle | |
-| `block-read-outside-cwd` | Ajanları proje sınırları içinde tut | `allowPaths` |
-| `block-secrets-write` | Özel anahtar ve sertifika dosyalarına yazmaları engelle | `additionalPatterns` |
-| `block-push-master` | main/master'a kazara yapılan gönderişleri engelle | `protectedBranches` |
-| `block-work-on-main` | Ajanları korumalı dallardan uzak tut | `protectedBranches` |
-| `block-force-push` | `git push --force` komutunu engelle | |
-| `warn-git-amend` | Ajanları commit'leri düzenlemeden önce uyar | |
-| `warn-git-stash-drop` | Ajanları stash'leri bırakmadan önce uyar | |
-| `warn-all-files-staged` | Kazara `git add -A` komutunu yakala | |
-| `warn-destructive-sql` | DROP/DELETE SQL'i yürütülmeden önce yakala | |
-| `warn-schema-alteration` | ALTER TABLE'ı yürütülmeden önce yakala | |
-| `warn-large-file-write` | Beklenmedik şekilde büyük dosya yazmaları yakala | `thresholdKb` |
-| `warn-package-publish` | Kazara `npm publish` komutunu yakala | |
-| `warn-background-process` | Istenmeyen arka plan işlemi başlatmalarını yakala | |
-| `warn-global-package-install` | Istenmeyen küresel paket yüklemelerini yakala | |
+| `sanitize-private-key-content` | PEM özel anahtar bloklarını çıktıdan gizle | |
+| `sanitize-bearer-tokens` | Çıktıdan Authorization Bearer jetonlarını gizle | |
+| `block-env-files` | Ajanları .env dosyalarını okumaktan tutun | |
+| `protect-env-vars` | Ajanları ortam değişkenlerini yazdırmaktan önle | |
+| `block-read-outside-cwd` | Ajanları proje sınırları içinde tutun | `allowPaths` |
+| `block-secrets-write` | Özel anahtar ve sertifika dosyalarına yazıları önle | `additionalPatterns` |
+| `block-push-master` | Main/master'a tesadüfi itmeleri önle | `protectedBranches` |
+| `block-work-on-main` | Ajanları korunan dallardan uzak tutun | `protectedBranches` |
+| `block-force-push` | `git push --force`'u önle | |
+| `warn-git-amend` | Ajanları commit değiştirmeden önce uyar | |
+| `warn-git-stash-drop` | Ajanları stash bırakmadan önce uyar | |
+| `warn-all-files-staged` | Tesadüfi `git add -A`'yı yakala | |
+| `warn-destructive-sql` | DROP/DELETE SQL'ini yürütmeden önce yakala | |
+| `warn-schema-alteration` | ALTER TABLE'ı yürütmeden önce yakala | |
+| `warn-large-file-write` | Beklenmedik boyutta dosya yazılarını yakala | `thresholdKb` |
+| `warn-package-publish` | Tesadüfi `npm publish`'i yakala | |
+| `warn-background-process` | Istenmeyen arka plan işlem başlatmalarını yakala | |
+| `warn-global-package-install` | Istenmeyen global paket kurulumlarını yakala | |
 | …ve daha fazlası | | |
 
 Tam politika ayrıntıları ve parametre referansı: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
@@ -179,25 +179,25 @@ Tam politika ayrıntıları ve parametre referansı: [docs/built-in-policies.mdx
 
 ## Özel politikalar
 
-Ajanlarınızı güvenilir ve görev odaklı tutmak için kendi politikalarınızı yazın:
+Ajanları güvenilir ve odaklanmış tutmak için kendi politikalarınızı yazın:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
 customPolicies.add({
   name: "no-production-writes",
-  description: "'production' içeren yollara yazmaları engelle",
+  description: "Block writes to paths containing 'production'",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
     const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Production yollarına yazma işlemleri engellendi");
+    if (path.includes("production")) return deny("Writes to production paths are blocked");
     return allow();
   },
 });
 ```
 
-Şu komutla kurun:
+Bunu kurarak yükleyin:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -208,46 +208,46 @@ failproofai policies --install --custom ./my-policies.js
 | İşlev | Etki |
 |-------|------|
 | `allow()` | İşleme izin ver |
-| `allow(message)` | İzin ver ve bilgilendirici bağlam Claude'a gönder |
+| `allow(message)` | İzin ver ve Claude'a bilgisel bağlam gönder |
 | `deny(message)` | İşlemi engelle; ileti Claude'a gösterilir |
-| `instruct(message)` | Claude'un istemine bağlam ekle; engelleme yapmaz |
+| `instruct(message)` | Claude'un istemine bağlam ekle; engelleme |
 
 ### Bağlam nesnesi (`ctx`)
 
 | Alan | Tür | Açıklama |
-|------|-----|---------|
+|------|-----|----------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Çağrılan araç (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | Aracın giriş parametreleri |
-| `payload` | `object` | Tam ham olay yükü |
+| `payload` | `object` | Tam ham etkinlik yükü |
 | `session.cwd` | `string` | Claude Code oturumunun çalışma dizini |
 | `session.sessionId` | `string` | Oturum tanımlayıcısı |
-| `session.transcriptPath` | `string` | Oturum transkript dosyasının yolu |
+| `session.transcriptPath` | `string` | Oturum transkrip dosyasının yolu |
 
-Özel hooklar geçişli yerel içe aktarmaları, async/await'i ve `process.env` erişimini destekler. Hatalar açık başarısızlık modunda yapılır (günlüklenir: `~/.failproofai/hook.log`, yerleşik politikalar devam eder). Tam rehber için bkz. [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
+Özel kancalar geçişli yerel içe aktarmaları, async/await ve `process.env` erişimini destekler. Hatalar başarısız-açık şekilde işlenir (günlükleri `~/.failproofai/hook.log`'a kaydedilir, hazır politikalar devam eder). Tam rehber için [docs/custom-hooks.mdx](docs/custom-hooks.mdx) bölümüne bakın.
 
-### Kural tabanlı politikalar
+### Kurala dayalı politikalar
 
-`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` klasörüne bırakın ve otomatik olarak yüklenir — `--custom` bayrağı veya yapılandırma değişiklikleri gerekmez. Git hook'ları gibi çalışır: bir dosya bırakın, her şey çalışır.
+`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` içine bırakın ve otomatik olarak yüklenir — `--custom` bayrağına veya yapılandırma değişikliklerine ihtiyaç yok. Git kancaları gibi çalışır: dosya bırak, işte oldu.
 
 ```text
-# Proje seviyesi — git'e yürütülen, takım ile paylaşılır
+# Proje seviyesi — git'e işlenir, takımla paylaşılır
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Kullanıcı seviyesi — kişisel, tüm projelere uygulanır
+# Kullanıcı seviyesi — kişisel, tüm projeler için geçerli
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Her iki seviye de yüklenir (birleşim). Dosyalar her dizin içinde alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-`, vb. ile ön ek ekleyin. Hazır kullanılabilir örnekler için bkz. [examples/convention-policies/](examples/convention-policies/).
+Her iki seviye de yüklenir (birleşim). Dosyalar her dizin içinde alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` vb. ile ön ek yapın. Kullanıma hazır örnekler için [examples/convention-policies/](examples/convention-policies/) bölümüne bakın.
 
 ---
 
 ## Telemetri
 
-Failproof AI, özellik kullanımını anlamak için PostHog aracılığıyla anonim kullanım telemetrisi toplar. Oturum içeriği, dosya adları, araç girdileri veya kişisel bilgiler hiçbir zaman gönderilmez.
+Failproof AI, özellik kullanımını anlamak için PostHog aracılığıyla anonim kullanım telemetrisi toplar. Oturum içeriği, dosya adları, araç girişleri veya kişisel bilgiler asla gönderilmez.
 
-Devre dışı bırakmak için:
+Devre dışı bırak:
 
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -259,22 +259,22 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | Rehber | Açıklama |
 |--------|----------|
-| [Başlangıç](docs/getting-started.mdx) | Kurulum ve ilk adımlar |
-| [Yerleşik Politikalar](docs/built-in-policies.mdx) | 30 yerleşik politikanın tümü parametrelerle birlikte |
-| [Özel Politikalar](docs/custom-policies.mdx) | Kendi politikalarınızı yazın |
-| [Yapılandırma](docs/configuration.mdx) | Konfigürasyon dosyası biçimi ve kapsam birleştirme |
-| [Pano](docs/dashboard.mdx) | Oturumları izleyin ve politika etkinliğini gözden geçirin |
-| [Mimari](docs/architecture.mdx) | Hook sistemi nasıl çalışır |
-| [Test Etme](docs/testing.mdx) | Testleri çalıştırın ve yenilerini yazın |
+| [Başlarken](docs/getting-started.mdx) | Kurulum ve ilk adımlar |
+| [Hazır Politikalar](docs/built-in-policies.mdx) | Tüm 30 hazır politika ve parametreleri |
+| [Özel Politikalar](docs/custom-policies.mdx) | Kendi politikalarını yaz |
+| [Yapılandırma](docs/configuration.mdx) | Yapılandırma dosya biçimi ve kapsam birleştirme |
+| [Panel](docs/dashboard.mdx) | Oturumları izle ve politika aktivitesini gözden geçir |
+| [Mimari](docs/architecture.mdx) | Kanva sisteminin nasıl çalıştığı |
+| [Test Etme](docs/testing.mdx) | Testleri çalıştırma ve yenilerini yazma |
 
-### Belgeleri yerel olarak çalıştırın
+### Belgeleri yerel olarak çalıştır
 
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-Mintlify belgeler sitesini `http://localhost:3000` adresinde açar. Belgeler dizinini bağlarsanız kapsayıcı değişiklikleri izler:
+Mintlify belgeler sitesini `http://localhost:3000` adresinde açar. Belgeler dizinini bağlarsanız konteyner değişiklikleri izler:
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -282,17 +282,17 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## failproofai katkıda bulunanları için not
+## failproofai katılımcıları için not
 
-Bu deponun `.claude/settings.json` dosyası standart `npx -y failproofai` komutu yerine `bun ./bin/failproofai.mjs --hook <EventType>` komutunu kullanır. Bunun nedeni, failproofai projesi içinde `npx -y failproofai` çalıştırmanın kendi kendine referans çatışması oluşturmasıdır.
+Bu deponun `.claude/settings.json` dosyası standart `npx -y failproofai` komutunun yerine `bun ./bin/failproofai.mjs --hook <EventType>` kullanır. Bunun nedeni failproofai projesi içinde `npx -y failproofai`'ı çalıştırmanın kendi kendine referanslı bir çatışma oluşturmasıdır.
 
-Diğer tüm depolar için önerilen yaklaşım `npx -y failproofai` komutudur ve şu şekilde yüklenir:
+Diğer tüm depolar için önerilen yaklaşım `npx -y failproofai`'dır ve şu şekilde kurulur:
 
 ```bash
 failproofai policies --install --scope project
 ```
 
-## Katkıda bulunun
+## Katkıda bulun
 
 Bkz. [CONTRIBUTING.md](CONTRIBUTING.md).
 
@@ -304,5 +304,5 @@ Bkz. [LICENSE](LICENSE).
 
 ---
 
-**ExosphereHost: Ajanlarınız için Güvenilirlik Araştırması Laboratuvarı** tarafından inşa edilmiş ve sürdürülmektedir. Ajanlarımız, yazılımımız ve uzmanlığımız aracılığıyla kuruluşların ve startupların AI ajanlarının güvenilirliğini artırmasına yardımcı oluyoruz. [exosphere.host](https://exosphere.host) adresinde daha fazla bilgi edinin.
+**ExosphereHost: Agents için Güvenilirlik Araştırma Laboratuvarı** tarafından inşa edilmiş ve yönetilmektedir. İşletmelerin ve startupların AI ajanlarının güvenilirliğini kendi ajanları, yazılımı ve uzmanlığı aracılığıyla geliştirmelerine yardımcı oluyoruz. [exosphere.host](https://exosphere.host) adresinde daha fazla bilgi edinin.
 ```