failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/tr/dashboard.mdx

@@ -0,0 +1,152 @@
+---
+---
+title: Pano
+description: "Ajan oturumlarını izleyin, araç çağrılarını gözden geçirin ve politikaları yönetin"
+icon: chart-line
+---
+
+failproofai panosu, AI ajan oturumlarınızı izlemek ve politikaları yönetmek için tasarlanmış yerel bir web uygulamasıdır. Ajanlarınız sizin yokken neler yaptığını görün.
+
+---
+
+## Panoyu başlatma
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` adresinde açılır.
+
+Pano, proje, oturum ve failproofai yapılandırma verilerini doğrudan dosya sisteminden okur. Denetim hatırlatıcıları ve davetler gibi isteğe bağlı kimlik doğrulamalı özellikler, bu istekler için gereken bilgileri (e-posta adresleri dahil) uzak API'lere gönderir.
+
+---
+
+## Sayfalar
+
+### Projeler
+
+Makinenizde bulunan tüm Claude Code, OpenAI Codex, GitHub Copilot CLI _(beta)_, Cursor Agent _(beta)_, OpenCode _(beta)_, Pi _(beta)_, Hermes, OpenClaw, Factory Droid, Devin, Antigravity ve Goose projelerini listeler. Claude projeleri `~/.claude/projects/` konumundan keşfedilir (`CLAUDE_PROJECTS_PATH` tarafından ayarlanan yol); Codex projeleri `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` konumundaki her transkripti tarayarak ve her oturumun ilk kaydında kayıtlı `cwd` ile gruplandırılarak keşfedilir; Copilot CLI projeleri `~/.copilot/session-state/<sessionId>/workspace.yaml` konumundan (`COPILOT_HOME` aracılığıyla yapılandırılabilir) taranarak ve `cwd` alanı ile gruplandırılarak keşfedilir; Cursor Agent projeleri `~/.cursor/agent-sessions/<sessionId>/` konumundaki oturum başına meta veriler taranarak (`CURSOR_HOME` aracılığıyla yapılandırılabilir, `conversations/` ve `sessions/` yedek olarak kullanılır) `meta.json` / `session.json` / `workspace.yaml` içinde `cwd` skaleri aranarak keşfedilir; OpenCode projeleri `~/.local/share/opencode/opencode.db` konumundaki SQLite DB'sine `opencode db --format json` aracılığıyla sorgu yapılarak keşfedilir (`session` ve `project` tabloları okunur ve `project_id` ile gruplandırılır); Pi projeleri `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` konumundaki oturum başına JSONL transkriptleri tarayarak (`PI_SESSIONS_DIR` aracılığıyla yapılandırılabilir) her oturumun ilk kaydından `cwd` çekerek keşfedilir; Hermes ağ geçidi oturumları her profilin SQLite deposundan doğrudan okunur — `~/.hermes/state.db` artı `~/.hermes/profiles/<name>/state.db` (`HERMES_HOME` veya tek bir veritabanı için `HERMES_DB_PATH` ile geçersiz kılınabilir) — ve `hermes-<profile>-<source>` projelerine profil ve `source` (Slack/Telegram/cli/cron — ağ geçidi oturumlarının cwd'si yoktur) ile gruplandırılır; OpenClaw ağ geçidi oturumları `~/.openclaw/agents/<agentId>/sessions/*.jsonl` konumundan okunur ve `openclaw-<agentId>-<channel>` projelerine ajan ve kanal ile gruplandırılır (ayrıca cwd'si yoktur); Factory Droid projeleri `~/.factory/sessions/<encoded-cwd>/*.jsonl` konumundaki JSONL transkriptlerinden keşfedilir ve cwd ile gruplandırılır; Devin projeleri `~/.local/share/devin/cli/sessions.db` konumundaki SQLite DB'sinden (her oturumun `working_directory` ile gruplandırılır); Antigravity projeleri `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` konumundaki JSONL transkriptlerinden keşfedilir ve cwd ile gruplandırılır; ve Goose projeleri `~/.local/share/goose/sessions/sessions.db` konumundaki SQLite DB'sinden (her oturumun `working_dir` ile gruplandırılır). Birden fazla CLI tarafından kullanılan bir proje, tüm eşleşen rozetler ile tek satır olarak gösterilir. Belirli bir ajan CLI'sına göre filtrelemek için tablonun üzerindeki **CLI** açılır menüsünü kullanın; URL seçiminizi `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose` olarak saklar.
+
+Hermes ve OpenClaw kullanıcı kapsamlıdır ve gruplandırılacak çalışma dizini olmadığından **daraltılabilir klasör ağacı** olarak gösterilir — üst düzeyden profil (veya ajan), altında kanalları — diğer tüm cwd tabanlı CLI'ler düz satır olarak kalır. Klasör satırları, altındaki her şeyin oturum sayısını ve en son etkinliğini toplayır, daraltılan klasörler ziyaretler arasında hatırlanır ve anahtar sözcük araması eşleştirdiklerini genişletir.
+
+Her proje şunları gösterir:
+- Proje adı (klasör yolundan türetilmiş)
+- CLI rozeti — `Claude Code` (turuncu), `OpenAI Codex` (mor), `GitHub Copilot` (mavi), `Cursor Agent` (zümrüt yeşili), `OpenCode` (kehribar), `Pi` (pembe), ve/veya `Hermes` (indigo)
+- En son oturum etkinliğinin tarihi
+
+Oturumlarını görmek için bir projeye tıklayın.
+
+### Oturumlar
+
+Bir projedeki tüm oturumları listeler. Her oturum şunları gösterir:
+- Oturum kimliği
+- Başlangıç ve bitiş zaman damgaları
+- Araç çağrısı sayısı
+- Hook etkinlik sayısı (ateşlenen politikalar)
+
+Listeyi daraltmak için tarih aralığı filtresini ve oturum kimliği aramasını kullanın. Oturumlar sayfalandırılmıştır.
+
+Oturum görüntüleyicisini açmak için bir oturuma tıklayın.
+
+### Oturum görüntüleyici
+
+Oturum görüntüleyici, otonom ajanlar için ana soruyu yanıtlar: ajan ne yaptı ve yolundan sapmadı mı? Başlık yanındaki CLI rozeti, oturumun Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity veya Goose transkripti olup olmadığını gösterir. Bir oturumda gerçekleşen her şeyin zaman çizelgesini gösterir:
+
+- **Mesajlar** - Claude'un metin yanıtları ve kullanıcı istemleri
+- **Araç çağrıları** - Claude'un çağırdığı her araç, girdisi ve çıktısı ile
+- **Politika etkinliği** - Her araç çağrısı için, hangi politikaların ateşlendiği ve hangi kararı döndürdüğü
+
+Üstteki istatistik çubuğu, oturum süresini, toplam araç çağrılarını ve hook kararlarının özetini (allow / deny / instruct sayıları) gösterir.
+
+Oturumu dışa aktarmak için **Günlükleri İndir** düğmesine tıklayın. Claude Code, Codex, Copilot, Cursor ve Pi oturumları için orijinal diskte JSONL transkriptini bayt-bayt olarak alırsınız; OpenCode oturumları için (oturumlar diskte değil SQLite'da yaşadığından) temel `session` / `messages` / `parts` tablolarını yansıtan bir JSON belgesi alırsınız.
+
+### Denetim
+
+Ajanınızın geçmiş oturumlar arasında gerçekten nasıl davrandığının kişiliği yönüyle raporlaması. `failproofai audit` CLI ile aynı taraması çalıştırır ancak bunu tek ekranlı paylaşılabilir bir poster + dört aşağıda kalan bölüm olarak işler:
+
+1. **Poster** — ilk viewport'u doldurur. failproof_ai sözcük işareti + denetim etiketi · tip indeksi (`№ NN of 08`) + denetim tarihi · sayısal puan (0–100) + yüzdelik sıralama hapı (`top 15%`) · tip adı (`the optimist`, `the cowboy`, `the explorer`, `the goldfish`, `the paranoid architect`, `the precision builder`, `the hammer`, `the ghost` birinden) + 3 anahtar sözcük şeridi · `// only N% of agents are this archetype` nadirlik satırı · 8×8 piksel sigil döşemesi · `audit yours → failproof.ai` altbilgi içeren kendi başına yeterli PNG yakalama bölgesi. Üç paylaşma düğmesi yakalama kutusunun dışında yer alır: `post your archetype` (X intent), `share on linkedin`, `download poster`. Yakalama `html-to-image` aracılığıyla çalışır, böylece PNG ekranda görünen işlemeyle piksel-piksel eşleşir (kesik çizgili kenarlıklar, SVG logo maskesi, degradeler, yazı tipi ölçütleri — tümü korunur).
+2. **Güçlü Yönler** — sakin ✓ satır listesi, ajanınızın zaten doğru yaptığı davranışlar, canlı denetim verilerinden türetilmiş (temiz araç çağrı oranı, ana kola doğrudan hiçbir push, sıfır kimlik bilgisi sızıntısı, sıfır yeniden deneme fırtınaları) — ilgili politika denetim penceresi genelinde temiz kayıtlara sahip olduğu zaman her biri ortaya çıkarılır.
+3. **Tuhaflıklar** — sıyrıldığı şeylerin tablosu, ciddiyet tarafından sıralanmış: `when · what slipped + the policy that would've caught it · severity pill · seen`, tekrar okuması `new` (bir kez), `N× seen` (2–9 kez) veya `recurring` (10+).
+4. **Nasıl İyileştirilir** — sakin satır listesi, önerilen her politika başına birer tane: politika adı beyazda, tek satır açıklama, sağ tarafta yükleme komutu + kopyala düğmesi. Bölüm başlığı `enable all N → projected <score> · <tier>` okur (her düzeltme uygulandığında ulaşacağınız puan) ve onun `[install all]` düğmesi, her önerilen politika için birleşik `failproofai policy add a b c …` komutunu kopyalar.
+5. **Daha İyi Geri Dön** — yan yana iki kart. Sol: hatırlatıcı ayarla (`3d` / `7d` / `14d` / `30d` temposu seçici; kimlik doğrulandıktan sonra `/api/auth/reminder` aracılığıyla kalıcı). Sağ: failproof avantajlarının kilidini açın — `invite a friend` virgül/boşluk/yeni satır ile ayrılmış bir arkadaş e-postası listesini alan bir modal açar (gönderim başına maksimum 10), onları `/api/audit/invite` konumuna POST eder, bu da api-sunucusunun `POST /v0/invite` konumuna iletilir. Api-sunucusu, gönderici Cc'ye sahip ve `Reply-To` ayarlanmış şekilde `invite@failproof.ai` konumundan her alıcı için bir e-posta gönderir, böylece alıcı onları kimin davet ettiğini görür ve gönderici gelen kutularında bir kopya alır. Anonim kullanıcılar, davetler gönderilmeden önce gönderenin e-postası bilinir diye `AuthDialog` aracılığıyla yönlendirilir. Hak / avantaj yerine getirme sonraki bir aşamadır.
+
+`failproofai audit` çalışma zamanı tarafından yönlendirilir — temel tarama motoru, desteklenen bayraklar ve per-transkript önbellek değişmezleri için [Denetim CLI](/tr/cli/audit) konusuna bakın. Pano, en son sonucu `~/.failproofai/audit-dashboard.json` konumunda önbelleğe alır (mod `0600`, tek yuva, yeni çalıştırmalar üzerine yazar) böylece yeniden ziyaretler anlıktır; **hem per-transkript hem de tam sonuç önbellekleri okunduklarında 7 günü aştıklarında reddedilir** böylece pano hiçbir zaman bir haftaya kadar eski bir sonucu sessizce sunmaz — TTL geçtikten sonra `/audit` boş durumuna düşer ve yeni bir çalıştırma isteminden geçer. Raporun alt kısmında `[ re-audit now ]` düğmesine tıklamak `/api/audit/run` konumuna `noCache: true` ile POST gönderir — yeniden denetim per-transkript önbelleğini atlar ve her transkripti sessizce önbelleğe alınan sonucu döndürmek yerine sıfırdan yeniden tarar — ve pano çalıştırma bitene kadar `/api/audit/status` konumunu 1Hz'de yoklar; yapışkan pembe ilerleme şeridi çalışma sırasında viewport'un üstüne tutturulur ve geçen bir zamanlayıcı ile başarıda yeni sonuç yerine değiştirilir (tam sayfa yeniden yüklemesi yok; başarısız yeniden denetim önceki raporu sağlam bırakır). Başarısızlıkta şerit, `RerunError.kind` ('timeout' / 'network' / 'post_failed') konusunda anahtar kopyayla kırmızıya döner. Boş durum (önbellek yok veya süresi dolmuş) ve sıfır oturum durumu (önbellek var ancak tarama transkript bulamadı) ayrı olarak ortaya çıkarılır.
+
+### Politikalar
+
+Politikaları yönetmek ve etkinliği gözden geçirmek için iki sekmeli sayfa.
+
+<Tabs>
+  <Tab title="Politikalar sekmesi">
+  - failproofai'ın tek bir panelden koruduğu ajan CLI'lerini çoklu seçin — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ve Hermes'in tümü yükleme durumu (`Active` / `Detected` / `Inactive`), kullanıcı kapsamı ayarları yolu ve marka renkli aksan içeren bir satır alır. İstediğiniz CLI'leri işaretleyin veya işaretini kaldırın ve tek adımda farkı yüklemek/kaldırmak için `Apply changes` düğmesine tıklayın. PATH'ta ikili tespit edilen CLI'ler önceden işaretlidir.
+  - Bireysel politikaları tek tıklamayla açın veya kapatın (bunu `~/.failproofai/policies-config.json` konumuna yazar — tüm yüklü CLI'ler arasında paylaşılır)
+  - Bir politikayı genişleterek parametrelerini yapılandırın (`policyParams` destekleyen politikalar için)
+  - Özel politikalar dosyası yolunu ayarlayın
+  </Tab>
+  <Tab title="Etkinlik sekmesi">
+  - Tüm oturumlar arasında ateşlenen her hook olayının tam sayfalandırılmış geçmişi
+  - Kararı, olay türünü, CLI'yi (Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose), politika adını veya oturum kimliğini filtreyin
+  - Her satır şunları gösterir: zaman damgası, politika adı, karar, CLI rozeti (turuncu = Claude Code, mor = OpenAI Codex, mavi = GitHub Copilot, zümrüt yeşili = Cursor Agent, kehribar = OpenCode, pembe = Pi, indigo = Hermes, turkuaz = OpenClaw, gül = Factory Droid, menekşe = Devin, cyan = Antigravity, yeşilimsi = Goose), araç adı, oturum kimliği ve deny/instruct kararlarının nedeni
+  - Transkriptini açmak için bir oturum kimliğine tıklayın — görüntüleyici hangi CLI'nin hook'u ateşlediğini otomatik olarak algılar (Claude `~/.claude/projects/…`, Codex `~/.codex/sessions/…`, Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`, Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`, OpenCode `~/.local/share/opencode/opencode.db`, Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`, Hermes `~/.hermes/state.db`, OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`, Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`, Devin `~/.local/share/devin/cli/sessions.db`, Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`, Goose `~/.local/share/goose/sessions/sessions.db`) ve başlıkta eşleşen CLI rozetini işler
+  </Tab>
+</Tabs>
+
+---
+
+## Otomatik yenileme
+
+Pano üst gezintide otomatik yenileme açma/kapatma düğmesine sahiptir. Etkinleştirildiğinde, geçerli sayfa yeni oturumlar ve politika etkinliği göstermek için periyodik olarak yenilenir. Uzun süren otonom ajan oturumlarının izlenmesi için gereklidir.
+
+---
+
+## Sayfaları devre dışı bırakma
+
+Pano'nun yalnızca bazı bölümlerine ihtiyacınız varsa, `FAILPROOFAI_DISABLE_PAGES` ortam değişkenini virgülle ayrılmış sayfa adlarının bir listesine ayarlayın:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+Geçerli değerler: `policies`, `projects`, `audit`.
+
+---
+
+## Proje yolunu yapılandırma
+
+Pano, varsayılan olarak standart Claude Code projeleri dizininden okur. Özel kurulumlar için geçersiz kılın:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## Localhost olmayan bir konaktan erişim
+
+Panoyu **geliştirme modu**'nda (`npm run dev`) çalıştırırken ve buna `localhost` dışında bir ana bilgisayar adından erişirken - örneğin, özel etki alanı, uzak IP veya tünel yapılmış URL - şöyle bir uyarı görebilirsiniz:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+Bu, Next.js'nin HMR (sıcak modül yeniden yükleme) web soketine çapraz kaynaklı erişimi engellemesi, bu da yalnızca geliştirme özelliğidir. Ana bilgisayarınıza izin vermek için `--allowed-origins` bayrağını kullanın:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+Birden fazla konak veya IP için virgülle ayrılmış bir liste geçirin:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+Bunun yerine `FAILPROOFAI_ALLOWED_DEV_ORIGINS` ortam değişkenini de ayarlayabilirsiniz:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+Bu yalnızca geliştirme moduna uygulanır. `failproofai` çalıştırırken (üretim modu), HMR web soketi ve çapraz kaynaklı dev kaynak sorunu yoktur.
+</Note>

package/.next/standalone/docs-old/tr/examples.mdx

@@ -0,0 +1,307 @@
+---
+title: Örnekler
+description: "Claude Code ve Agents SDK için hook'ları nasıl ayarlayacağınız"
+icon: book-open
+---
+
+Yaygın senaryolar için hazır örnekler. Her biri kurulumun nasıl yapılacağını ve neyi bekleyeceğinizi gösterir.
+
+---
+
+## Claude Code için hook'ları ayarlama
+
+Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/docs/claude-code/hooks) aracılığıyla entegre olur. `failproofai policies --install` komutunu çalıştırdığınızda, Claude Code'un `settings.json` dosyasına her araç çağrısında tetiklenen hook komutlarını kaydeder.
+
+<Steps>
+  <Step title="failproofai'ı yükleyin">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="Tüm yerleşik politikaları etkinleştirin">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="Hook'ların kaydedildiğini doğrulayın">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    `PreToolUse`, `PostToolUse`, `Notification` ve `Stop` olayları için hook girdilerini görmüş olmalısınız.
+  </Step>
+  <Step title="Claude Code'u çalıştırın">
+    ```bash
+    claude
+    ```
+
+    Politikalar şimdi her araç çağrısında otomatik olarak çalışır. Claude'dan `sudo rm -rf /` komutunu çalıştırmasını istemeyi deneyin - bloke edilecektir.
+  </Step>
+</Steps>
+
+---
+
+## Agents SDK için hook'ları ayarlama
+
+[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) ile geliştiriyorsanız, aynı hook sistemi programlı olarak kullanılabilir.
+
+<Steps>
+  <Step title="failproofai'ı projenize yükleyin">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="Ajanınızda hook'ları yapılandırın">
+    Ajan işlemi oluştururken hook komutlarını geçin. Hook'lar Claude Code'daki gibi çalışır - stdin/stdout JSON aracılığıyla:
+
+    ```bash
+    failproofai --hook PreToolUse   # her araçtan önce çağrılır
+    failproofai --hook PostToolUse  # her araçtan sonra çağrılır
+    ```
+  </Step>
+  <Step title="Ajanınız için özel bir politika yazın">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Özel politikayı yükleyin">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## Yıkıcı komutları bloke etme
+
+En yaygın kurulum - ajanların geri döndürülemez hasara neden olmasını önlemek.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+Bunu ne yapar:
+- `block-sudo` - tüm `sudo` komutlarını bloke eder
+- `block-rm-rf` - özyinelemeli dosya silmeyi bloke eder
+- `block-force-push` - `git push --force` komutunu bloke eder
+- `block-curl-pipe-sh` - uzak betikleri shell'e yönlendirmeyi bloke eder
+
+---
+
+## Gizli bilgi sızıntısını önleme
+
+Ajanların kimlik bilgilerini görmesini veya araç çıktısında sızdırmasını engelleyin.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+Bunlar `PostToolUse` etkinliğinde çalışır - bir araç çalıştıktan sonra, ajan bunu görmeden önce çıktıyı temizlerler.
+
+---
+
+## Ajanlar ilgilenilmesi gerektiğinde Slack uyarıları alın
+
+Bildirim hook'unu kullanarak boş bekleme uyarılarını Slack'e gönderin.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // never block the agent if Slack is unreachable
+    }
+
+    return allow();
+  },
+});
+```
+
+Yükleyin:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## Ajanları bir dal üzerinde tutun
+
+Ajanların dal değiştirmesini veya korumalı dallara push etmesini engelleyin.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Commit öncesi test gerekli kıl
+
+Ajanları commit etmeden önce test çalıştırmaya hatırlatın.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Production deposunu kilitle
+
+Proje düzeyinde bir yapılandırma commit edin, böylece ekibinizin her geliştirici aynı politikaları alır.
+
+Deponuzda `.failproofai/policies-config.json` oluşturun:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+Sonra commit edin:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+failproofai yüklü olan her ekip üyesi bu kuralları otomatik olarak alacaktır.
+
+---
+
+## Konvention politikaları ile kuruluş çapında kalite standardı oluşturun
+
+En etkili kurulum: projenize commit edin `.failproofai/policies/` ve politikalarınızı projenize uygun hale getirin. Her ekip üyesi bunları otomatik olarak alır — kurulum komutlarına gerek yok, yapılandırma değişikliklerine gerek yok.
+
+<Steps>
+  <Step title="Dizini oluşturun ve politika ekleyin">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git'e commit edin">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="İyileştirmeye devam edin">
+    Ekibiniz yeni hata modlarıyla karşılaştıkça, politika ekleyin ve push edin. Herkes bir sonraki `git pull` yapışında güncellemeleri alır. Bu politikalar, ekibinizle birlikte büyüyen canlı bir kalite standardı haline gelir.
+  </Step>
+</Steps>
+
+---
+
+## Daha fazla örnek
+
+Depolardaki [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) dizini şunları içerir:
+
+| Dosya | Ne gösterir |
+|------|---------------|
+| `policies-basic.js` | Başlangıç politikaları - production yazısını, force-push'ı, piped betikleri bloke eder |
+| `policies-notification.js` | Boş bildirimler ve oturum sonu için Slack uyarıları |
+| `policies-advanced/index.js` | Geçişli içeri aktarımlar, eşzamansız hook'lar, PostToolUse çıktı temizleme, Stop etkinliği yönetimi |

package/.next/standalone/docs-old/tr/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "Ajanlar için"
+description: "Failproof AI bilgisini kodlama ajanınıza tek komutla ekleyin. Claude Code, Cursor, Windsurf ve daha fazlasıyla çalışır."
+---
+
+Failproof AI başvuru rehberinin tamamını kodlama ajanınıza tek komutla ekleyin. Claude Code, Cursor, Windsurf ve beceri desteği olan diğer tüm ajanlarla çalışır.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` hangi ajanları yüklü olduğunu tespit eder ve beceriyi her biri için doğru biçimde otomatik olarak ekler.
+
+## Beceri neyi kapsar
+
+| Alan | İçindekiler |
+|------|------------|
+| Politikalar | Yerleşik politika adları, olay türleri, parametreler, etkinleştirme/devre dışı bırakma |
+| Özel politikalar | `customPolicies.add()`, eşleşme filtreleri, `allow`/`deny`/`instruct` API |
+| Context nesnesi | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Yapılandırma | `policies-config.json` yapısı, kapsam birleştirme, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, kapsamlar |
+| Dashboard | Oturum görüntüleyicisi, politika aktivitesi, ortam değişkenleri |
+| Mimari | Hook işleyici akışı, çıkış kodları, stdin/stdout sözleşmesi |
+
+## Beceri tam mı?
+
+Mintlify, `llms.txt` dosyasını gezintideki tüm sayfalardan oluşturur. Failproof AI dokümanları tam API'yi kapsar - her politika, seçenek ve örnek dahil edilmiştir. Eksik bir şey bulursanız, kaynak `https://docs.befailproof.ai/llms-full.txt` konumundadır.
+
+Hedeflenen içerik için doğrudan belirli bir sayfaya bağlantı verin:
+
+```bash
+# Yalnızca özel politikalar API'si
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# Yalnızca yerleşik politikalar
+npx skills add https://docs.befailproof.ai/built-in-policies
+```