failproofai 0.0.6-beta.3 → 0.0.6-beta.5

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

@@ -1,353 +0,0 @@
----
-title: Özel İlkeler
-description: "JavaScript'te kendi ilkelerinizi yazın - kuralları uygulayın, sapmaları önleyin, hataları tespit edin, dış sistemlerle entegre olun"
-icon: code
----
-
-Özel ilkeler, herhangi bir agent davranışı için kurallar yazmanızı sağlar: proje kurallarını uygulayın, sapmaları önleyin, yıkıcı işlemleri kontrol edin, takılı kalmış aracıları tespit edin veya Slack, onay iş akışları ve daha fazlası ile entegre olun. Yerleşik ilkeler ile aynı hook event 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 ilkeleri yüklemenin iki yolu
-
-### Seçenek 1: Kural tabanlı (önerilen)
-
-`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` klasörüne koyun ve otomatik olarak yüklenir — hiçbir bayrak veya yapılandırma değişikliği gerekmez. Bu git hooks gibi çalışır: dosyayı koyun, işte bu kadar.
-
-```
-# Proje düzeyi — git'e kaydedilir, takım ile paylaşılır
-.failproofai/policies/security-policies.mjs
-.failproofai/policies/workflow-policies.mjs
-
-# Kullanıcı düzeyi — kişisel, tüm projeler için geçerli
-~/.failproofai/policies/my-policies.mjs
-```
-
-**Nasıl çalışır:**
-- Hem proje hem de kullanıcı dizinleri taranır (birleşim — ilk kapsam kazanması değil)
-- Dosyalar her klasöre alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` ön ekini kullanın
-- Sadece `*policies.{js,mjs,ts}` ile eşleşen dosyalar yüklenir; diğer dosyalar göz ardı edilir
-- Her dosya bağımsız olarak yüklenir (dosya başına açık başarısızlık)
-- Açık `--custom` ve yerleşik ilkeler ile yan yana çalışır
-
-<Tip>
-Kural tabanlı ilkeler, kuruluşunuz için bir kalite standardı oluşturmanın en kolay yoludur. `.failproofai/policies/` git'e kaydedin ve her takım üyesi otomatik olarak aynı kuralları alır — geliştirici başına kurulum gerekmez. Takımınız yeni hata modları keşfettikçe, bir ilke ekleyin ve gönderin. Zaman içinde bu, her katkıyla iyileşen canlı bir kalite standardı haline gelir.
-</Tip>
-
-### Seçenek 2: Açık dosya yolu
-
-```bash
-# Özel ilkeler dosyası ile yükleyin
-failproofai policies --install --custom ./my-policies.js
-
-# İlkeler dosya yolunu değiştirin
-failproofai policies --install --custom ./new-policies.js
-
-# Yapılandırmadan özel ilkeler yolunu kaldırın
-failproofai policies --uninstall --custom
-```
-
-Çözümlenen mutlak yol, `policies-config.json` içinde `customPoliciesPath` olarak depolanır. Dosya her hook eventinde yeniden yüklenir - eventler arasında önbellekleme yoktur.
-
-### Her ikisini birlikte kullanma
-
-Kural tabanlı ilkeler ve açık `--custom` dosyası birlikte var olabilir. Yükleme sırası:
-
-1. Açık `customPoliciesPath` dosyası (yapılandırıldıysa)
-2. Proje kural tabanlı dosyaları (`{cwd}/.failproofai/policies/`, alfabetik)
-3. Kullanıcı kural tabanlı dosyaları (`~/.failproofai/policies/`, alfabetik)
-
----
-
-## API
-
-### İçe aktar
-
-```js
-import { customPolicies, allow, deny, instruct } from "failproofai";
-```
-
-### `customPolicies.add(hook)`
-
-Bir ilkeyi kaydeder. Aynı dosyada birden fazla ilke için gerektiği kadar çağırın.
-
-```ts
-customPolicies.add({
-  name: string;                         // required - unique identifier
-  description?: string;                 // shown in `failproofai policies` output
-  match?: { events?: HookEventType[] }; // filter by event type; omit to match all
-  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
-});
-```
-
-### Karar yardımcıları
-
-| İşlev | Etki | Ne zaman kullanılır |
-|----------|--------|----------|
-| `allow()` | İşlemi sessizce izin ver | İşlem güvenli, mesaj gerekmez |
-| `deny(message)` | İşlemi engelle | Agent bu işlemi yapmamalı |
-| `instruct(message)` | Bloklama olmaksızın bağlam ekle | Agent'a yolda kalmak için ek bağlam ver |
-
-`deny(message)` - ileti Claude'a `"Blocked by failproofai:"` ön ekiyle görünür. Tek bir `deny` tüm diğer değerlendirmeleri kısa devre yapar.
-
-`instruct(message)` - ileti Claude'un geçerli araç çağrısı için bağlamına eklenir. Tüm `instruct` iletileri birlikte biriktirilir ve gönderilir.
-
-<Tip>
-Kod değişikliği gerekmeksizin `deny` veya `instruct` iletisine ekstra rehberlik ekleyebilirsiniz — `policyParams` içine bir `hint` alanı ekleyerek. Bu özel (`custom/`), proje kural tabanlı (`.failproofai-project/`) ve kullanıcı kural tabanlı (`.failproofai-user/`) ilkeler 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>
-
-### Bilgilendirme amaçlı izin iletileri
-
-`allow(message)` işlemi izin verir **ve** Claude'a bilgilendirici bir ileti geri gönderir. İleti, hook işleyicisinin stdout yanıtında `additionalContext` olarak gönderilir — `instruct` ile aynı mekanizma kullanılır, ancak semantik olarak farklıdır: bu bir uyarı değil, durum güncellemesidir.
-
-| İşlev | Etki | Ne zaman kullanılır |
-|----------|--------|----------|
-| `allow(message)` | İzin ver ve Claude'a bağlam gönder | Bir kontrol başarılı olduğunu onaylayın veya kontrol atlanışını açıklayın |
-
-Kullanım durumları:
-- **Durum onayları:** `allow("All CI checks passed.")` — Claude'a her şeyin yeşil olduğunu söyler
-- **Açık başarısızlık açıklamaları:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude'a kontrol atlanışını açıklar, böylece tam bağlama sahip olur
-- **Birden fazla ileti birikir:** birden fazla ilke her biri `allow(message)` döndürürse, tüm iletiler satırbaşı ile birleştirilir ve birlikte gönderilir
-
-```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.");
-
-    // ... check branch status ...
-    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ç (ör. `"Bash"`, `"Write"`, `"Read"`) |
-| `toolInput` | `Record<string, unknown> \| undefined` | Aracın giriş parametreleri |
-| `payload` | `Record<string, unknown>` | Claude Code'dan gelen tam ham event payload'ı |
-| `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ı yolu |
-
-### Event türleri
-
-| Event | Ne zaman tetiklenir | `toolInput` içeriği |
-|-------|--------------|----------------------|
-| `PreToolUse` | Claude bir araç çalıştırmadan önce | Aracın girdisi (ör. Bash için `{ command: "..." }`) |
-| `PostToolUse` | Bir araç tamamlandıktan sonra | Aracı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 engelleyemezler |
-| `Stop` | Claude oturumu sona erdiğinde | Boş |
-
----
-
-## Değerlendirme sırası
-
-İlkeler şu sırada değerlendirilir:
-
-1. Yerleşik ilkeler (tanım sırasında)
-2. `customPoliciesPath` adresinden açık özel ilkeler (`.add()` sırasında)
-3. Proje `.failproofai/policies/` adresinden kural tabanlı ilkeler (dosyalar alfabetik, içinde `.add()` sırası)
-4. Kullanıcı `~/.failproofai/policies/` adresinden kural tabanlı ilkeler (dosyalar alfabetik, içinde `.add()` sırası)
-
-<Note>
-İlk `deny` tüm sonraki ilkeleri kısa devre yapar. Tüm `instruct` iletileri biriktirilir ve birlikte gönderilir.
-</Note>
-
----
-
-## Geçişli içe aktarmalar
-
-Özel ilke dosyaları, göreceli yollar kullanarak 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öreceli içe aktarmalar çözümlenir. Bu, `from "failproofai"` içe aktarmalarını gerçek dist yoluna yeniden yazarak ve ESM uyumluluğu sağlamak için geçici `.mjs` dosyaları oluşturarak uygulanır.
-
----
-
-## Event türü filtrelemesi
-
-Bir ilkenin ne zaman tetiklendiğini sınırlandırmak için `match.events` kullanın:
-
-```js
-customPolicies.add({
-  name: "require-summary-on-stop",
-  match: { events: ["Stop"] },
-  fn: async (ctx) => {
-    // Sadece oturum sona erdiğinde tetiklenir
-    // ctx.session.transcriptPath tam oturum günlüğünü içerir
-    return allow();
-  },
-});
-```
-
-Her event türüne tetiklenmek için `match` tamamen atlayın.
-
----
-
-## Hata işleme ve başarısızlık modları
-
-Özel ilkeler **açık başarısızlık** modundadır: hatalar yerleşik ilkeleri hiçbir zaman engelleme veya hook işleyiciyi kilitlemez.
-
-| Başarısızlık | Davranış |
-|---------|----------|
-| `customPoliciesPath` ayarlanmamış | Açık özel ilke çalışmaz; kural tabanlı ve yerleşik ilkeler normal şekilde devam eder |
-| Dosya bulunamadı | `~/.failproofai/hook.log` adresine uyarı yazılır; yerleşik ilkeler devam eder |
-| Söz dizimi/içe aktarma hatası (açık) | `~/.failproofai/hook.log` adresine hata yazılır; açık özel ilkeler atlanır |
-| Söz dizimi/içe aktarma hatası (kural tabanlı) | Hata yazılır; bu dosya atlanır, diğer kural tabanlı dosyalar yüklenir |
-| `fn` çalışma zamanında hatanın atılması | Hata yazılır; bu hook `allow` olarak işlem görür; diğer hook'lar devam eder |
-| `fn` 10 saniyeden uzun süre alması | Zaman aşımı yazılır; `allow` olarak işlem görür |
-| Kural tabanlı dizin eksik | Kural tabanlı ilke çalışmaz; hata yok |
-
-<Tip>
-Özel ilke hatalarını ayıklamak için günlük dosyasını izleyin:
-
-```bash
-tail -f ~/.failproofai/hook.log
-```
-</Tip>
-
----
-
-## Tam örnek: birden fazla ilke
-
-```js
-// my-policies.js
-import { customPolicies, allow, deny, instruct } from "failproofai";
-
-// Agent'ın secrets/ dizinine yazmasını engelle
-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'ı yolda tut: commit etmeden ö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();
-  },
-});
-
-// Donma döneminde planlanmamış bağımlılık değişikliklerini engelle
-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ıştırmaya hazır ilke dosyaları içerir:
-
-| Dosya | İçerik |
-|------|----------|
-| `examples/policies-basic.js` | Yaygın agent hata modlarını kapsayan beş başlatıcı ilke |
-| `examples/policies-advanced/index.js` | Gelişmiş desenler: geçişli içe aktarmalar, zaman uyumsuz çağrılar, çıktı kazıyıcıları ve oturum sonu hook'ları |
-| `examples/convention-policies/security-policies.mjs` | Kural tabanlı güvenlik ilkeleri (.env yazımları engelle, git geçmişi yeniden yazımını önle) |
-| `examples/convention-policies/workflow-policies.mjs` | Kural tabanlı iş akışı ilkeleri (test anımsatıcıları, denetim dosya yazımları) |
-
-### 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 gerekmez — dosyalar bir sonraki hook olayında otomatik olarak seçilir.

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

@@ -1,142 +0,0 @@
----
-title: Dashboard
-description: "Aracı oturumlarını izleyin, araç çağrılarını gözden geçirin ve politikaları yönetin"
-icon: chart-line
----
-
-failproofai dashboard, AI aracı oturumlarınızı izlemek ve politikaları yönetmek için yerel bir web uygulamasıdır. Aracılarınızın yokken ne yaptığını görün.
-
----
-
-## Dashboard'u başlatma
-
-```bash
-failproofai
-```
-
-`http://localhost:8020` adresinde açılır.
-
-Dashboard doğrudan dosya sisteminden okur - Claude Code proje klasörleriniz ve failproofai yapılandırma dosyalarınız. Hiçbir şey uzak bir hizmete yazılmaz.
-
----
-
-## Sayfalar
-
-### Projeler
-
-Makinenizde bulunan tüm Claude Code projelerini listeler. Projeler `~/.claude/projects/` konumundan (veya `CLAUDE_PROJECTS_PATH` tarafından ayarlanan yoldan) keşfedilir.
-
-Her proje şunları gösterir:
-- Proje adı (klasör yolundan türetilmiş)
-- Oturum sayısı
-- En son oturum etkinliğinin tarihi
-
-Oturumlarını görmek için bir projeye tıklayın.
-
-### Oturumlar
-
-Bir proje içindeki tüm oturumları listeler. Her oturum şunları gösterir:
-- Oturum ID'si
-- Başlangıç ve bitiş zaman damgaları
-- Araç çağrısı sayısı
-- Hook etkinlik sayısı (harekete geçen politikalar)
-
-Listeyi daraltmak için tarih aralığı filtresini ve oturum ID'si aramasını kullanın. Oturumlar sayfalandırılmıştır.
-
-Oturum görüntüleyiciyi açmak için bir oturuma tıklayın.
-
-### Oturum görüntüleyici
-
-Oturum görüntüleyici, otonom aracılar için temel soruyu yanıtlar: aracı ne yaptı ve yolunda mı kaldı? Bir oturumda gerçekleşen her şeyin bir zaman çizelgesini gösterir:
-
-- **Mesajlar** - Claude'un metin yanıtları ve kullanıcı istemleri
-- **Araç çağrıları** - Claude'un çağırdığı her araç, girişi ve çıkışıyla birlikte
-- **Politika etkinliği** - Her araç çağrısı için, hangi politikaların harekete geçtiği ve ne karar döndürdükleri
-
-Üstteki istatistik çubuğu oturum süresini, toplam araç çağrılarını ve kanca kararlarının bir özetini (allow / deny / instruct sayıları) gösterir.
-
-İndirme düğmesini kullanarak oturumu ZIP veya JSONL dosyası olarak dışa aktarabilirsiniz.
-
-### Politikalar
-
-Politikaları yönetmek ve etkinliği gözden geçirmek için iki sekmeli bir sayfa.
-
-<Tabs>
-  <Tab title="Politikalar sekmesi">
-  - Tek bir tıklamayla bireysel politikaları açıp kapatın (`~/.failproofai/policies-config.json` dosyasına yazılır)
-  - Parametrelerini yapılandırmak için bir politikayı genişletin (`policyParams` destekleyen politikalar için)
-  - Belirli bir kapsam için kancaları yükleyin veya kaldırın
-  - Özel bir politika dosya yolu ayarlayın
-  </Tab>
-  <Tab title="Etkinlik sekmesi">
-  - Tüm oturumlar arasında harekete geçen her kanca olayının tam sayfalı geçmişi
-  - Politika adı, oturum ID'si, araç adı veya karar ile arayın
-  - Her satır şunları gösterir: zaman damgası, politika adı, karar, araç adı, oturum ID'si ve deny/instruct kararlarının nedeni
-  </Tab>
-</Tabs>
-
----
-
-## Otomatik yenileme
-
-Dashboard'un üst gezintide bir otomatik yenileme geçişi vardır. Etkinleştirildiğinde, geçerli sayfa yeni oturumlar ve politika etkinlikleri görünürken periyodik olarak yenilenir. Uzun süreli otonom aracı oturumlarını izlemek için gereklidir.
-
----
-
-## Sayfaları devre dışı bırakma
-
-Dashboard'un yalnızca bazı bölümlerine ihtiyacınız varsa, `FAILPROOFAI_DISABLE_PAGES` değerini virgülle ayrılmış sayfa adları listesine ayarlayın:
-
-```bash
-FAILPROOFAI_DISABLE_PAGES=policies failproofai
-```
-
-Geçerli değerler: `policies`, `projects`.
-
----
-
-## Tema
-
-Dashboard açık ve koyu modu destekler. Gezinti çubuğundaki düğmeyle geçiş yapın. Tercih, tarayıcınızın yerel depolamada saklanır.
-
----
-
-## Projeler yolunu yapılandırma
-
-Varsayılan olarak, dashboard standart Claude Code projeleri dizininden okur. Özel kurulumlar için bunu geçersiz kılın:
-
-```bash
-CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
-```
-
----
-
-## Localhost dışı bir konaktan erişme
-
-Dashboard **dev modunda** (`npm run dev`) çalıştırılırken ve `localhost` dışında bir ana bilgisayar adından erişilirken - örneğin, özel bir alan adı, uzak bir IP veya tünel içinden geçirilen bir URL - aşağıdaki gibi 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üklemesi) websocket'ine cross-origin erişimi engellemesidir; bu dev-only bir özelliktir. 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 ana bilgisayar 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 dev moduna uygulanır. `failproofai` (production modu) çalıştırılırken HMR websocket'i ve cross-origin dev kaynak sorunu yoktur.
-</Note>