failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/tr/getting-started.mdx

@@ -0,0 +1,199 @@
+---
+title: Başlarken
+description: "failproofai yükleyin, politikaları etkinleştirin ve aracılarınızı güvenilir şekilde çalıştırın"
+icon: rocket
+---
+
+## Gereksinimler
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (isteğe bağlı - yalnızca kaynaktan derlemek için gerekli)
+
+---
+
+## Kurulum
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## Hızlı başlangıç
+
+<Steps>
+  <Step title="Politikaları etkinleştirin">
+    Politikalar, her aracı araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli dizi sızıntısını ve hasar oluşturmadan önce diğer hata modlarını yakalarlar.
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    Bu, yüklü aracı CLI'lerinize kanca girdileri yazar (Claude Code'un `~/.claude/settings.json`, OpenAI Codex'in `~/.codex/hooks.json`, GitHub Copilot CLI'nin `~/.copilot/hooks/failproofai.json`, Cursor Agent'ın `~/.cursor/hooks.json`, OpenCode'un `~/.config/opencode/plugins/failproofai.mjs` adresindeki oluşturulan eklenti dolgusuna ve `~/.config/opencode/opencode.json` dosyasının `plugin` dizisindeki kayıt girişine, Pi'nin `~/.pi/agent/settings.json`, Hermes'in `~/.hermes/config.yaml`, OpenClaw'ın `~/.openclaw/openclaw.json`, Factory Droid'in `~/.factory/hooks.json`, Devin CLI'nin `~/.config/devin/config.json`, Antigravity CLI'nin `~/.gemini/config/hooks.json` veya Goose'un `~/.agents/plugins/failproofai/hooks/hooks.json` adresindeki otomatik keşfedilen eklenti dizinine). Birden fazlası mevcut olduğunda sizden seçim istenir; istemi atlamak için `--cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose` (herhangi bir alt küme) geçirin.
+
+    GitHub Copilot CLI, Cursor Agent, OpenCode ve Pi desteği **beta** aşamasındadır — `--cli copilot`, `--cli cursor`, `--cli opencode` veya `--cli pi` ile yükleyin. Hermes (hermes-agent, bir Slack/Telegram ağ geçidi) `--cli hermes` ile kullanıcı kapsamında yüklenir ve **aynı zamanda** çevrimdışı bir denetim kaynağıdır. OpenClaw (openclaw ağ geçidi, kendi barındırılan çok kanallı asistan) `--cli openclaw` ile kullanıcı kapsamında yüklenir — uygulama, işlem içi eklenti kankaları aracılığıyla çalışır (`before_agent_finalize` gerçek bir tur sonu kapısıdır, bu nedenle `require-*-before-stop` yerleşikleri uygular) — ve **aynı zamanda** çevrimdışı bir denetim kaynağıdır. Factory Droid (`droid`) `--cli factory` ile yüklenir (kullanıcı + proje kapsamı) ve **aynı zamanda** çevrimdışı bir denetim kaynağıdır. Devin CLI (`devin`, Cognition) `--cli devin` ile yüklenir (kullanıcı + proje kapsamı) ve **aynı zamanda** çevrimdışı bir denetim kaynağıdır. Antigravity CLI (`agy`) `--cli antigravity` ile yüklenir (kullanıcı + proje kapsamı) ve **aynı zamanda** çevrimdışı bir denetim kaynağıdır. Goose (kod adı goose, Block) `--cli goose` ile yüklenir (kullanıcı + proje kapsamı) — yükleyici yalnızca `~/.agents/plugins/failproofai/` adresine bir eklenti dizini bırakır ve Goose bunu otomatik olarak keşfeder; **aynı zamanda** çevrimdışı bir denetim kaynağıdır.
+
+    ```bash
+    failproofai policies --install --scope project
+    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 hermes --scope user
+    failproofai policies --install --cli openclaw --scope user
+    failproofai policies --install --cli factory --scope project
+    failproofai policies --install --cli devin --scope project
+    failproofai policies --install --cli antigravity --scope project
+    failproofai policies --install --cli goose --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="Doğrulayın">
+    ```bash
+    failproofai policies
+    ```
+
+    Her politikayı, etkin olup olmadığını ve yapılandırılmış parametreleri gösterir.
+  </Step>
+  <Step title="Panoyu başlatın">
+    ```bash
+    failproofai
+    ```
+
+    `http://localhost:8020` adresinde yerel bir pano açar; burada oturumları göz atabilir, araç çağrılarını inceleyebilir ve politikaları yönetebilirsiniz.
+  </Step>
+  <Step title="Aracınızı çalıştırın">
+    Claude Code'u her zamanki gibi başlatın. Aracı riskli bir şey yapmaya çalışırsa, failproofai bunu otomatik olarak keser. Onu çalışır bırakın ve panoda ne olduğunu gözden geçirin.
+  </Step>
+</Steps>
+
+---
+
+## Politikalar nasıl çalışır
+
+Bir aracı her araç çalıştırdığında, Claude Code failproofai'yi bir alt işlem olarak çağırır:
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
+                                                   politikaları değerlendirir
+                                                   stdout'a karar yazar
+```
+
+Her politika üç karardan birini döndürür:
+
+- **allow** - aracı normal şekilde devam eder
+- **deny** - işlem engellenir, aracıya neden engellediği söylenir
+- **instruct** - aracının istemi'ne ekstra bağlam eklenir
+
+<Note>
+Politikalar yerel işleminizde çalışır. Hiçbir şey uzak bir hizmete gönderilmez.
+</Note>
+
+---
+
+## Kural tabanlı politikalar ile takım politikaları ayarlayın
+
+Ekibiniz genelinde kalite standartları oluşturmanın en hızlı yolu `.failproofai/policies/` kuralıdır. Politika dosyalarını bu dizine bırakın ve otomatik olarak yüklenir — bayrak yok, yapılandırma değişikliği yok, kurulum komutu yok.
+
+<Steps>
+  <Step title="Politikalar dizinini oluşturun">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Politika dosyaları ekleyin">
+    Başlangıç örneklerini kopyalayın veya kendininkini yazın:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Veya yeni bir tane oluşturun:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    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("Taahhüt etmeden önce testleri çalıştırın.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git'e taahhüt edin">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Takım kalite politikaları ekleyin"
+    ```
+
+    failproofai yüklü olan her takım üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum yapılması gerekmez.
+  </Step>
+</Steps>
+
+<Tip>
+`.failproofai/policies/` deposuna taahhüt edin; böylece tüm takım aynı standartları paylaşır. Takımınız yeni hata modlarını keşfettikçe, politikalar ekleyin ve gönderin — herkes bir sonraki `git pull` komutunda güncellemeyi alır. Zaman içinde bu politikalar, iyileşmeye devam eden yaşayan bir kalite standartı haline gelir.
+</Tip>
+
+---
+
+## Veri depolama
+
+Tüm yapılandırma ve günlükler makinenizde kalır:
+
+| Yol | Depoladığı şey |
+|------|----------------|
+| `~/.failproofai/policies/local-policies/policies-config.json` | Genel politika yapılandırması |
+| `~/.failproofai/hook-activity/` | Kanca yürütme geçmişi (sayfalı JSONL) |
+| `~/.failproofai/logs/` | Özel kanca hataları için hata ayıklama günlükleri |
+| `.failproofai/policies-config.json` | Proje başına yapılandırma (taahhüt edildi) |
+| `.failproofai/policies-config.local.json` | Kişisel geçersiz kılmalar (gitignored) |
+
+---
+
+## Kaldırılıyor
+
+```bash
+failproofai policies --uninstall
+```
+
+`~/.claude/settings.json` dosyasından kanca girdilerini kaldırır. `~/.failproofai/` dizinindeki yapılandırma dosyaları tutulur.
+
+---
+
+## Sonraki adımlar
+
+<CardGroup cols={2}>
+
+<Card title="Yapılandırma" icon="gear" href="/tr/configuration">
+  Kapsamlar ve yapılandırma dosyası biçimi
+</Card>
+
+<Card title="Yerleşik politikalar" icon="shield" href="/tr/built-in-policies">
+  Parametreler ile tüm 26 politika
+</Card>
+
+<Card title="Özel politikalar" icon="code" href="/tr/custom-policies">
+  JavaScript'te kendi politikalarınızı yazın
+</Card>
+
+<Card title="Aracı monitörü" icon="chart-line" href="/tr/dashboard">
+  Oturumları izleyin ve politika aktivitesini gözden geçirin
+</Card>
+
+</CardGroup>

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

@@ -0,0 +1,57 @@
+---
+title: "Failproof AI"
+description: "FailproofAI, AI aracılarına 39 yerleşik başarısızlık politikası sağlayarak döngüleri, gizli sızdırmaları, yıkıcı araç çağrılarını ve daha pbirçok sorunu tek bir kurulumla yakalar."
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+**AI başarısızlık yönetimi**, **hata kurtarma** ve **LLM güvenilirliği** için kancalar ve politikalar. AI aracılarınızı **Claude Code**, **OpenAI Codex**, **GitHub Copilot**, **Cursor Agent**, **OpenCode**, **Pi**, **Hermes**, **OpenClaw**, **Factory Droid**, **Devin CLI**, **Antigravity CLI** ve **Agents SDK** üzerinde güvenilir ve otonom şekilde çalıştırın.
+
+AI aracıları öngörülebilir şekillerde başarısız olur. Yıkıcı komutlar çalıştırırlar, gizli bilgiler sızdırırlar, görevden sapıyor, döngülerde sıkışırlar veya doğrudan ana dala gönderim yaparlar. Denetimsiz bırakıldığında, küçük başarısızlıklar kesintilere, sızdırılan kimlik bilgilerine ve kaybedilen işlere dönüşebilir.
+
+FailproofAI bunu **politikalar** ile çözer. Bu kurallar her araç çağrısına takılarak **başarısızlıkları tespit eder**, **bunları hafifletir** (engelle, talimat ver, dezenfekte et) ve **dikkat gerektiğinde sizi uyarır**. Yerel bir pano, her araç çağrısını, aracı başarısızlığını ve kurtarma eylemini daha sonra gözden geçirmenizi sağlar.
+
+Transkriptler ve politika değerlendirmesi makinenizde kalır. Veriler yalnızca doğrulanan denetim hatırlatıcıları veya davetler gibi çevrimiçi bir özelliği açıkça kullandığınızda gönderilir.
+
+## Başlayın
+
+<CardGroup cols={2}>
+
+<Card title="39 yerleşik politika" icon="shield" href="/tr/built-in-policies">
+  Yıkıcı komutları engelleyin, gizli sızıntısını önleyin, aracıları proje sınırları içinde tutun ve daha pbirçok şey. Hepsi kutu içinde.
+</Card>
+
+<Card title="Özel politikalar" icon="code" href="/tr/custom-policies">
+  Basit allow / deny / instruct API'si ile JavaScript'te kendi kurallarınızı yazın.
+</Card>
+
+<Card title="Aracı monitörü" icon="chart-line" href="/tr/dashboard">
+  Aracılarınız yokkenken ne yaptığını görün. Oturumları tarayın, araç çağrılarını inceleyin, politikaların nerede etkinleştiğini gözden geçirin.
+</Card>
+
+<Card title="Kolay yapılandırma" icon="gear" href="/tr/configuration">
+  Herhangi bir politikayı kod olmadan ayarlayın. İzin listelerini, korunan dalları veya eşikleri proje başına veya genel olarak ayarlayın.
+</Card>
+
+</CardGroup>
+
+## Hızlı başlangıç
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # politikaları etkinleştir (veya atla — `failproofai` ilk çalıştırmada bunları ayarlamayı teklif edecek)
+failproofai                      # panoyu başlat
+```
+
+Tam yer gösterimler için [Başlangıç](/tr/getting-started) kılavuzuna bakın.

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

@@ -0,0 +1,82 @@
+---
+title: Paket Takma Adları
+description: "Kayıtlı yazım hatası önleme takma adları ve nasıl çalıştıkları"
+icon: copy
+---
+
+## Resmi paket
+
+Kanonik npm paketi **`failproofai`**:
+
+```bash
+npm install -g failproofai
+# or
+bun add -g failproofai
+```
+
+---
+
+## Neden takma ad adlarına sahibiz
+
+Yazım hatası ile kötüye kullanım, bir saldırganın popüler bir paket adından tek tuş kadar uzakta olan bir paket adını kaydettiği yaygın bir tedarik zinciri saldırısıdır. Kurulum komutunu yanlış yazan şüphelenmeyen kullanıcılar, saldırgana ait kod ile tam sistem erişimi sağlanarak çalıştırılır - tam olarak Failproof AI'nin savunmak için tasarlandığı tehdit türüdür.
+
+Bu riski ortadan kaldırmak için, **npm üzerinde `failproofai`'nin tüm yaygın yazım hatalarına ve biçimlendirme varyantlarına proaktif olarak sahibiz**. Bu adlardan hiçbiri üçüncü taraf tarafından kayıtlanamaz. Her biri, gerçek `failproofai` paketini kuran ve ona devredilen ince bir proxy'dir.
+
+---
+
+## Kayıtlı takma adlar
+
+**Biçimlendirme varyantları** - "failproof ai" yazmanın farklı yolları:
+
+| Paket | Durum |
+|---------|--------|
+| `failproof` | ✅ Yayımlandı |
+| `failproof-ai` | ⏳ npm desteği bekleniyor |
+| `fail-proof-ai` | ⏳ npm desteği bekleniyor |
+| `failproof_ai` | ⏳ npm desteği bekleniyor |
+| `fail_proof_ai` | ⏳ npm desteği bekleniyor |
+| `fail-proofai` | ⏳ npm desteği bekleniyor |
+
+**`failprof*` yazım hataları** - "proof" kelimesinden bir `o` eksik:
+
+| Paket | Durum |
+|---------|--------|
+| `failprof` | ✅ Yayımlandı |
+| `failprof-ai` | ✅ Yayımlandı |
+| `failprofai` | ⏳ npm desteği bekleniyor |
+| `fail-prof-ai` | ⏳ npm desteği bekleniyor |
+| `failprof_ai` | ⏳ npm desteği bekleniyor |
+
+**`faliproof*` yazım hataları** - `a` ve `i` yer değişimi:
+
+| Paket | Durum |
+|---------|--------|
+| `faliproof` | ✅ Yayımlandı |
+| `faliproof-ai` | ✅ Yayımlandı |
+| `faliproofai` | ⏳ npm desteği bekleniyor |
+
+> **Neden bekleniyor?** npm'nin spam önleme politikası, noktalama işaretleri çıkarıldıktan sonra ve benzerlik kontrolleri yapıldıktan sonra mevcut bir paket ile aynı dizeye normalleşen adları engeller. Bu adları yazım hatası ile kötüye kullanımı önleme amaçlı rezerve etmek için npm desteğine başvurduk. Onaylandıktan sonra etkinleştirilecektir.
+
+Herhangi bir yayımlanmış takma adın bize ait olduğunu doğrulayabilirsiniz:
+
+```bash
+npm info failproof
+# Bak: maintainers alanında "ExosphereHost Inc."
+```
+
+---
+
+## Takma adlar nasıl çalışır
+
+Her takma ad paketi:
+
+1. `failproofai`'yi bir bağımlılık olarak listeler - böylece gerçek paket kurulur ve onun binary dosyası kullanılabilir hale gelir
+2. Kendi adıyla eşleşen bir binary'yi (örneğin `failprof-ai`) açığa çıkarır ve tüm argümanları `failproofai` binary'sine proxy eder
+
+Proxy, iki satırlık bir Node scriptidir; hiçbir mantık, hiçbir ağ çağrısı ve `failproofai`'nin kendisinin yaptığı şeyden başka veri toplama yoktur.
+
+---
+
+## Kaçırdığımız bir ad bulursanız
+
+[failproofai/failproofai](https://github.com/failproofai/failproofai/issues) adresinde bir issue açın ve biz onu kaydedeceğiz.

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

@@ -0,0 +1,261 @@
+---
+---
+title: Test Etme
+description: "Birim testleri, uçtan uca testleri ve test yardımcıları"
+icon: flask-vial
+---
+
+failproofai iki test paketine sahiptir: **birim testleri** (hızlı, mock edilmiş) ve **uçtan uca testleri** (gerçek alt işlem çağrıları).
+
+---
+
+## Testleri çalıştırma
+
+```bash
+# Tüm birim testlerini bir kez çalıştır
+bun run test:run
+
+# Birim testlerini izleme modunda çalıştır
+bun run test
+
+# E2E testlerini çalıştır (kurulum gerekli - aşağıya bakın)
+bun run test:e2e
+
+# Derleme yapmadan tür kontrolü yap
+bunx tsc --noEmit
+
+# Lint kontrolü
+bun run lint
+```
+
+---
+
+## Birim testleri
+
+Birim testleri `__tests__/` içinde yaşar ve [Vitest](https://vitest.dev) ile `jsdom` kullanır.
+
+```text
+__tests__/
+  hooks/
+    builtin-policies.test.ts      # Her yerleşik ilke için ilke mantığı
+    hooks-config.test.ts          # Konfigürasyon yükleme ve kapsam birleştirme
+    policy-evaluator.test.ts      # Parametre enjeksiyonu ve değerlendirme sırası
+    custom-hooks-registry.test.ts # globalThis kaydı ekle/al/temizle
+    custom-hooks-loader.test.ts   # ESM yükleyici, geçişli içe aktarımlar, hata işleme
+    manager.test.ts               # yükle/kaldır/listele işlemleri
+  components/
+    sessions-list.test.tsx        # Oturum listesi bileşeni
+    project-list.test.tsx         # Proje listesi bileşeni
+    ...
+  lib/
+    logger.test.ts
+    paths.test.ts
+    date-filters.test.ts
+    telemetry.test.ts
+    ...
+  actions/
+    get-hooks-config.test.ts
+    get-hook-activity.test.ts
+    ...
+  contexts/
+    ThemeContext.test.tsx
+    AutoRefreshContext.test.tsx
+```
+
+### İlke birim testi yazma
+
+```typescript
+import { describe, it, expect, beforeEach } from "vitest";
+import { getBuiltinPolicies } from "../../src/hooks/builtin-policies";
+import { allow, deny } from "../../src/hooks/policy-types";
+
+describe("block-sudo", () => {
+  const policy = getBuiltinPolicies().find((p) => p.name === "block-sudo")!;
+
+  it("denies sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo apt install nodejs" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(deny("sudo command blocked by failproofai"));
+  });
+
+  it("allows non-sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "ls -la" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+
+  it("allows patterns in allowPatterns", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo systemctl status nginx" },
+      params: { allowPatterns: ["sudo systemctl status"] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+});
+```
+
+---
+
+## Uçtan uca testleri
+
+E2E testleri gerçek `failproofai` ikilisini alt işlem olarak çağırır, stdin'e bir JSON yükü gönderir ve stdout çıktısı ile çıkış koduna karşı doğrulama yapar. Bu, Claude Code'un kullandığı tam entegrasyon yolunu test eder.
+
+### Kurulum
+
+E2E testleri ikiliyi doğrudan depo kaynağından çalıştırır. İlk çalıştırmadan önce, özel kancı dosyalarının `'failproofai'`'den içe aktarırken kullandığı CJS paketini derleyin:
+
+```bash
+bun build src/index.ts --outdir dist --target node --format cjs
+```
+
+Ardından testleri çalıştırın:
+
+```bash
+bun run test:e2e
+```
+
+Genel kancı API'sini değiştirdikçe (`src/hooks/custom-hooks-registry.ts`, `src/hooks/policy-helpers.ts` veya `src/hooks/policy-types.ts`) `dist/` yeniden derleyin.
+
+### E2E test yapısı
+
+```text
+__tests__/e2e/
+  helpers/
+    hook-runner.ts      # İkiliyi başlat, yük JSON'ını gönder, çıkış kodu + stdout + stderr yakala
+    fixture-env.ts      # Yapılandırma dosyaları ile test başına izole edilmiş geçici dizinler
+    payloads.ts         # Her olay türü için Claude-doğru yük fabrikaları
+  hooks/
+    builtin-policies.e2e.test.ts   # Gerçek alt işlem ile her yerleşik ilke
+    custom-hooks.e2e.test.ts       # Özel kancı yükleme ve değerlendirmesi
+    config-scopes.e2e.test.ts      # Proje/yerel/genel arasında yapılandırma birleştirme
+    policy-params.e2e.test.ts      # Parametreli her ilke için parametre enjeksiyonu
+```
+
+### E2E yardımcılarını kullanma
+
+**`FixtureEnv`** - test başına izole edilmiş ortam:
+
+```typescript
+import { createFixtureEnv } from "../helpers/fixture-env";
+
+const env = createFixtureEnv();
+// env.cwd    - geçici dizin; .failproofai/policies-config.json'ı almak için payload.cwd olarak geçir
+// env.home   - izole edilmiş ev dizini; gerçek ~/.failproofai sızıntısı yok
+
+env.writeConfig({
+  enabledPolicies: ["block-sudo"],
+  policyParams: {
+    "block-sudo": { allowPatterns: ["sudo systemctl status"] },
+  },
+});
+```
+
+`createFixtureEnv()` `afterEach` temizliğini otomatik olarak kaydeder.
+
+**`runHook`** - ikiliyi çağır:
+
+```typescript
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+const result = await runHook(
+  "PreToolUse",
+  Payloads.preToolUse.bash("sudo apt install nodejs", env.cwd),
+  { homeDir: env.home }
+);
+
+expect(result.exitCode).toBe(0);
+expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+```
+
+**`Payloads`** - hazır yük fabrikaları:
+
+```typescript
+Payloads.preToolUse.bash(command, cwd)
+Payloads.preToolUse.write(filePath, content, cwd)
+Payloads.preToolUse.read(filePath, cwd)
+Payloads.postToolUse.bash(command, output, cwd)
+Payloads.postToolUse.read(filePath, content, cwd)
+Payloads.notification(message, cwd)
+Payloads.stop(cwd)
+```
+
+### E2E testi yazma
+
+```typescript
+import { describe, it, expect } from "vitest";
+import { createFixtureEnv } from "../helpers/fixture-env";
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+describe("block-rm-rf (E2E)", () => {
+  it("denies rm -rf", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm -rf /", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+  });
+
+  it("allows non-recursive rm", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm /tmp/file.txt", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toBe("");  // izin ver → boş stdout
+  });
+});
+```
+
+### E2E yanıt şekilleri
+
+| Karar | Çıkış kodu | stdout |
+|----------|-----------|--------|
+| `PreToolUse` reddet | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` |
+| `PostToolUse` reddet | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` |
+| Talimat (Stop dışında) | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` |
+| Stop talimatı | `2` | boş stdout; nedeni stderr'de |
+| İzin ver | `0` | boş dize |
+
+### Vitest yapılandırması
+
+E2E testleri `vitest.config.e2e.mts` ile kullanır:
+
+- `environment: "node"` - tarayıcı globals gerekli değil
+- `pool: "forks"` - gerçek işlem izolasyonu (testler alt işlemler başlatır)
+- `testTimeout: 20_000` - test başına 20s (ikili başlatma + kancı değerlendirmesi)
+
+`forks` havuzu önemlidir: iş parçacığı tabanlı çalışanlar `globalThis` paylaşırlar, bu da alt işlem başlatma testlerini etkileyebilir. İşlem tabanlı forklar bunu önler.
+
+---
+
+## CI
+
+Tam CI çalıştırması (`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`) birleştirmeden önce geçmesi gerekir. E2E paketi paralel olarak ayrı bir CI işi olarak çalışır.
+
+Tam birleştirme öncesi kontrol listesi için [Katkı](../CONTRIBUTING.md)'ya bakın.

package/.next/standalone/docs-old/vi/agenteye/alerts.mdx

@@ -0,0 +1,63 @@
+---
+title: "Cảnh báo"
+description: "Phát hiện ngay khi có vấn đề vượt quá ngưỡng của bạn, trên kênh mà nhóm của bạn đã theo dõi, thay vì nghe từ khách hàng."
+---
+
+
+Phát hiện ngay khi có vấn đề vượt quá ngưỡng của bạn, trên kênh mà nhóm của bạn đã theo dõi, thay vì nghe từ khách hàng. Đặt một quy tắc một lần và Failproof AI Observability kiểm tra nó theo lịch trình, sau đó gửi thông báo cho bạn qua email, Slack, webhook, hoặc ngay trên bảng điều khiển.
+
+![Trang Cảnh báo: một lưới các thẻ quy tắc cảnh báo, mỗi thẻ hiển thị kích hoạt của nó, cửa sổ đánh giá, kênh và một huy hiệu mức độ nghiêm trọng thông tin, cảnh báo hoặc quan trọng](/agenteye/images/alerts.png)
+*Mỗi quy tắc cảnh báo trong một cái nhìn: nó theo dõi cái gì, tần suất bao nhiêu, nơi nó gửi thông báo, và mức độ khẩn cấp như thế nào.*
+
+## Biết về các vấn đề trước khi người dùng của bạn biết
+
+Ngừng làm mới bảng điều khiển hy vọng bắt kịp một lùi. Sử dụng cảnh báo bất cứ khi nào có tín hiệu mà bạn muốn biết ngay cả khi không ai đang theo dõi, và gửi nó đến nơi bạn đã có:
+
+- **Email**, cho bất cứ ai cần biết.
+- **Slack**, một tin nhắn phong phú với nút bấm nhảy thẳng đến sự cố.
+- **Webhook**, một JSON POST cho PagerDuty, Opsgenie, hoặc điểm cuối của riêng bạn, với chữ ký tùy chọn để người nhận có thể tin tưởng nó.
+- **Trên bảng điều khiển**, yên tĩnh theo thiết kế, khi bạn điều chỉnh một quy tắc và không muốn thông báo cho ai cả.
+
+Gắn kết bất kỳ sự kết hợp nào vào một quy tắc duy nhất, và mức độ nghiêm trọng của nó (thông tin, cảnh báo hoặc quan trọng) đi kèm để những quy tắc khẩn cấp trông khẩn cấp.
+
+## Xây dựng quy tắc trong một biểu mẫu, không phải JSON
+
+Bạn mô tả điều gì có nghĩa là "bị hỏng" trong một biểu mẫu, và Failproof AI Observability viết quy tắc cơ bản cho bạn. Thông số kỹ thuật JSON chỉ là những gì biểu mẫu đó tạo ra dưới nắp động cơ, vì vậy bạn có thể đọc nó để hiểu một quy tắc nhưng bạn hiếm khi nhập nó.
+
+![Biểu mẫu cảnh báo mới: tên và mô tả, bộ chuyển đổi bật, và một bộ chọn kích hoạt cung cấp ngưỡng metric, SQL tùy chỉnh, điểm đánh giá, đánh giá compound, và các điều kiện cho mỗi sự kiện](/agenteye/images/alert-new.png)
+*Chọn một kích hoạt và biểu mẫu hoán đổi các trường phù hợp; Lưu viết quy tắc.*
+
+Con đường hạnh phúc là nhanh: đặt tên cho nó, chọn một **kích hoạt** (cái gì cần theo dõi), đặt **ngưỡng và cửa sổ** (tệ như thế nào, trong bao lâu), gắn kết ít nhất một **kênh**, sau đó **Lưu** và nhấn **Kiểm tra** để kích hoạt một thông báo tổng hợp và xác nhận mọi đích đến đã được kết nối. Dưới nắp động cơ điều đó tạo ra một thông số kỹ thuật nhỏ như:
+
+```json
+{ "metric": "p95_latency_ms", "op": ">", "value": 5000, "window_secs": 900 }
+```
+
+Bạn không bị giới hạn ở một loại tín hiệu. Chọn kích hoạt phù hợp với cách bạn nghĩ về lỗi:
+
+| Kích hoạt | Kích hoạt khi |
+|---|---|
+| **Ngưỡng metric** | một metric được định sẵn (tỷ lệ lỗi, độ trễ p95 hoặc p99, số sự kiện hoặc lỗi, chi phí token) vượt quá ngưỡng của bạn trong một cửa sổ |
+| **SQL tùy chỉnh** | truy vấn chỉ đọc của riêng bạn trả về một hàng, hoặc một giá trị nó tính toán vượt quá ngưỡng |
+| **Điểm đánh giá** | trung bình điểm của một người đánh giá (ví dụ, ảo tưởng) vượt quá ngưỡng |
+| **Đánh giá compound** | nhiều kiểm tra điểm kết hợp với bất kỳ, tất cả, hoặc logic ít nhất-N, để bắt một lùi chỉ xuất hiện trên các điểm |
+| **Cho mỗi sự kiện** | một sự kiện khớp đơn lẻ đến: một agent cụ thể, một loại lỗi cụ thể, hoặc một chuỗi con tin nhắn |
+
+Đã staring tại một lỗi trên [trang Lỗi](/vi/agenteye/error-tracking)? Mỗi hàng ở đó có nút **+ alert** mở cùng biểu mẫu này được điền sẵn để bắt lỗi chính xác đó lại, vì vậy sự cố bạn vừa phân loại trở thành sự cố sẽ gửi cho bạn lần tiếp theo.
+
+**Nơi tìm thấy nó:** Cảnh báo nằm ở `/<org-slug>/alerts`. Tạo, chỉnh sửa, xóa và kiểm tra quy tắc cần **`alerts:write`**; `alerts:read` là đủ để xem. Bộ chọn người nhận liệt kê các thành viên của tổ chức bạn theo tên, vì vậy bạn có thể gửi thông báo cho một người mà không cần rời khỏi biểu mẫu.
+
+## Chỉ gửi cho tôi khi nó là thật
+
+Một phép đo xấu không nên làm bạn thức dậy. Bộ lọc nhiễu **M của N** kiểm soát có bao nhiêu trong số những kiểm tra gần đây phải thất bại trước khi cảnh báo thực sự gửi cho bạn. Đặt nó thành **3 của 5** và quy tắc kích hoạt chỉ sau khi nó đã vi phạm ba trong năm kiểm tra gần đây của nó, vì vậy tín hiệu không ổn định sẽ ngừng gây sốt; để nó ở mức mặc định **1 của 1** để kích hoạt khi vi phạm đầu tiên. Bạn cũng chọn tần suất chạy quy tắc, từ các preset của 1m, 5m, 15m và 1h, phù hợp với tốc độ tín hiệu thực sự di chuyển.
+
+## Điều gì xảy ra khi một cảnh báo kích hoạt
+
+Một vi phạm mở một **sự cố** và gửi thông báo cho các kênh của bạn một lần. Từ đó nhóm của bạn xác nhận nó, gán một chủ sở hữu, thảo luận nó, và giải quyết nó, tất cả so với một bản ghi sạch và được ghi. Quy trình phân loại đó có nhà riêng: xem [Sự cố](/vi/agenteye/incidents).
+
+## Liên quan
+
+- [Sự cố](/vi/agenteye/incidents): theo dõi một cảnh báo kích hoạt từ mở đến xác nhận đến đã giải quyết.
+- [Theo dõi lỗi](/vi/agenteye/error-tracking): nhóm các lỗi agent và quảng bá một lỗi thành cảnh báo chỉ bằng một cú nhấp chuột.
+- [Bảng điều khiển](/vi/agenteye/dashboards): theo dõi các bảng chia sẻ mà các ngưỡng bạn cảnh báo đến từ.
+- [CLI và agents](/vi/agenteye/cli-and-agents): tạo cảnh báo và xác nhận sự cố từ terminal của bạn, hoặc script chúng vào CI.