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

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

@@ -1,307 +0,0 @@
-> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
-
-[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | **🇯🇵 日本語** | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
-
----
-
-```
-    ______      _ __                       ____   ___    ____
-   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
-  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
- / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
-/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
-               /_/
-```
-
-# Failproof AI
-
-[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
-[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
-[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
-[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
-[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
-
-**翻訳**: [简体中文](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エージェントを安定稼働させ、タスクに集中させ、自律的に動かし続けるためのポリシー管理ツール — **Claude Code** と **Agents SDK** に対応。
-
-- **30種類の組み込みポリシー** - よくあるエージェントの障害パターンをすぐに検出。破壊的なコマンドのブロック、シークレット漏洩の防止、プロジェクト境界内への制限、ループ検出など。
-- **カスタムポリシー** - JavaScriptで独自の信頼性ルールを記述。`allow`/`deny`/`instruct` APIを使って規約の強制、ドリフトの防止、操作のゲート制御、外部システムとの連携が可能。
-- **シンプルな設定** - コードを書かずにどのポリシーも調整できます。許可リスト、保護ブランチ、しきい値をプロジェクト単位またはグローバルに設定。3スコープの設定が自動マージされます。
-- **エージェントモニター** - 離席中にエージェントが何をしたか把握できます。セッションの閲覧、ツール呼び出しの詳細確認、ポリシーが発火した箇所のレビューが可能。
-
-すべてローカルで動作 — データは外部に送信されません。
-
----
-
-## 動作要件
-
-- Node.js >= 20.9.0
-- Bun >= 1.3.0 （任意 — 開発時またはソースからビルドする場合のみ必要）
-
----
-
-## インストール
-
-```bash
-npm install -g failproofai
-# または
-bun add -g failproofai
-```
-
----
-
-## クイックスタート
-
-### 1. ポリシーをグローバルに有効化する
-
-```bash
-failproofai policies --install
-```
-
-`~/.claude/settings.json` にフックエントリを書き込みます。これにより Claude Code は各ツール呼び出しの前後に failproofai を呼び出すようになります。
-
-### 2. ダッシュボードを起動する
-
-```bash
-failproofai
-```
-
-`http://localhost:8020` が開きます — セッションの閲覧、ログの確認、ポリシーの管理ができます。
-
-### 3. 有効なポリシーを確認する
-
-```bash
-failproofai policies
-```
-
----
-
-## ポリシーのインストール
-
-### スコープ
-
-| スコープ | コマンド | 書き込み先 |
-|-------|---------|-----------------|
-| グローバル（デフォルト） | `failproofai policies --install` | `~/.claude/settings.json` |
-| プロジェクト | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| ローカル | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
-
-### 特定のポリシーをインストールする
-
-```bash
-failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-```
-
-### ポリシーを削除する
-
-```bash
-failproofai policies --uninstall
-# または特定のスコープを指定する場合:
-failproofai policies --uninstall --scope project
-```
-
----
-
-## 設定
-
-ポリシー設定は `~/.failproofai/policies-config.json`（グローバル）またはプロジェクト内の `.failproofai/policies-config.json`（プロジェクト単位）に保存されます。
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "sanitize-api-keys",
-    "block-push-master",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"],
-      "hint": "Try creating a fresh branch instead."
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  }
-}
-```
-
-**3つの設定スコープ**は自動的にマージされます（プロジェクト → ローカル → グローバル）。完全なマージルールは [docs/configuration.mdx](docs/configuration.mdx) を参照してください。
-
----
-
-## 組み込みポリシー
-
-| ポリシー | 説明 | 設定可能なパラメータ |
-|--------|-------------|:---:|
-| `block-sudo` | エージェントが特権システムコマンドを実行するのを防ぐ | `allowPatterns` |
-| `block-rm-rf` | 誤った再帰的ファイル削除を防ぐ | `allowPaths` |
-| `block-curl-pipe-sh` | 信頼できないスクリプトをシェルにパイプするのを防ぐ | |
-| `block-failproofai-commands` | 自己アンインストールを防ぐ | |
-| `sanitize-jwt` | JWTトークンがエージェントコンテキストに漏洩するのを止める | |
-| `sanitize-api-keys` | APIキーがエージェントコンテキストに漏洩するのを止める | `additionalPatterns` |
-| `sanitize-connection-strings` | データベース認証情報がエージェントコンテキストに漏洩するのを止める | |
-| `sanitize-private-key-content` | 出力からPEM秘密鍵ブロックを削除する | |
-| `sanitize-bearer-tokens` | 出力からAuthorization Bearerトークンを削除する | |
-| `block-env-files` | エージェントが.envファイルを読み取るのを防ぐ | |
-| `protect-env-vars` | エージェントが環境変数を出力するのを防ぐ | |
-| `block-read-outside-cwd` | エージェントをプロジェクト境界内に留める | `allowPaths` |
-| `block-secrets-write` | 秘密鍵・証明書ファイルへの書き込みを防ぐ | `additionalPatterns` |
-| `block-push-master` | main/masterへの誤ったプッシュを防ぐ | `protectedBranches` |
-| `block-work-on-main` | エージェントを保護ブランチから遠ざける | `protectedBranches` |
-| `block-force-push` | `git push --force` を防ぐ | |
-| `warn-git-amend` | コミットをamendする前にエージェントに通知する | |
-| `warn-git-stash-drop` | stashをdropする前にエージェントに通知する | |
-| `warn-all-files-staged` | 誤った `git add -A` を検出する | |
-| `warn-destructive-sql` | 実行前にDROP/DELETE SQLを検出する | |
-| `warn-schema-alteration` | 実行前にALTER TABLEを検出する | |
-| `warn-large-file-write` | 予期しない大きなファイル書き込みを検出する | `thresholdKb` |
-| `warn-package-publish` | 誤った `npm publish` を検出する | |
-| `warn-background-process` | 意図しないバックグラウンドプロセスの起動を検出する | |
-| `warn-global-package-install` | 意図しないグローバルパッケージのインストールを検出する | |
-| …その他 | | |
-
-ポリシーの詳細とパラメータリファレンス: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
-
----
-
-## カスタムポリシー
-
-エージェントを安定稼働させ、タスクに集中させるための独自ポリシーを作成できます:
-
-```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 (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
-    const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Writes to production paths are blocked");
-    return allow();
-  },
-});
-```
-
-以下のコマンドでインストールします:
-
-```bash
-failproofai policies --install --custom ./my-policies.js
-```
-
-### 判定ヘルパー
-
-| 関数 | 効果 |
-|----------|--------|
-| `allow()` | 操作を許可する |
-| `allow(message)` | 操作を許可し、情報コンテキストを Claude に送信する |
-| `deny(message)` | 操作をブロックする。メッセージが Claude に表示される |
-| `instruct(message)` | Claude のプロンプトにコンテキストを追加する。ブロックはしない |
-
-### コンテキストオブジェクト（`ctx`）
-
-| フィールド | 型 | 説明 |
-|-------|------|-------------|
-| `eventType` | `string` | `"PreToolUse"`、`"PostToolUse"`、`"Notification"`、`"Stop"` |
-| `toolName` | `string` | 呼び出されるツール（`"Bash"`、`"Write"`、`"Read"` など） |
-| `toolInput` | `object` | ツールの入力パラメータ |
-| `payload` | `object` | 生のイベントペイロード全体 |
-| `session.cwd` | `string` | Claude Code セッションのワーキングディレクトリ |
-| `session.sessionId` | `string` | セッション識別子 |
-| `session.transcriptPath` | `string` | セッションのトランスクリプトファイルへのパス |
-
-カスタムフックは推移的なローカルインポート、async/await、`process.env` へのアクセスをサポートしています。エラーはフェイルオープン（`~/.failproofai/hook.log` に記録され、組み込みポリシーは継続）。詳細なガイドは [docs/custom-hooks.mdx](docs/custom-hooks.mdx) を参照してください。
-
-### 規約ベースのポリシー
-
-`*policies.{js,mjs,ts}` ファイルを `.failproofai/policies/` に置くだけで自動的に読み込まれます — フラグや設定変更は不要です。ディレクトリをgitにコミットすれば、チーム全員が同じ品質基準を自動的に適用できます。
-
-```text
-# プロジェクトレベル — gitにコミットし、チームで共有
-.failproofai/policies/security-policies.mjs
-.failproofai/policies/workflow-policies.mjs
-
-# ユーザーレベル — 個人用、すべてのプロジェクトに適用
-~/.failproofai/policies/my-policies.mjs
-```
-
-両方のレベルが読み込まれます（ユニオン）。ファイルは各ディレクトリ内でアルファベット順に読み込まれます。読み込み順を制御するには `01-`、`02-` などのプレフィックスを付けてください。チームが新たな障害パターンを発見したら、ポリシーを追加してプッシュするだけ — 次のプル時に全員が更新を受け取ります。すぐに使えるサンプルは [examples/convention-policies/](examples/convention-policies/) を参照してください。
-
----
-
-## テレメトリー
-
-Failproof AI は機能の利用状況を把握するために、PostHog を通じて匿名の使用状況テレメトリーを収集しています。セッションの内容、ファイル名、ツールの入力、個人情報は一切送信されません。
-
-無効にするには:
-
-```bash
-FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
-```
-
----
-
-## ドキュメント
-
-| ガイド | 説明 |
-|-------|-------------|
-| [Getting Started](docs/getting-started.mdx) | インストールと最初のステップ |
-| [Built-in Policies](docs/built-in-policies.mdx) | パラメータ付き30種類の組み込みポリシー |
-| [Custom Policies](docs/custom-policies.mdx) | 独自ポリシーの作成 |
-| [Configuration](docs/configuration.mdx) | 設定ファイルの形式とスコープのマージ |
-| [Dashboard](docs/dashboard.mdx) | セッションの監視とポリシーアクティビティのレビュー |
-| [Architecture](docs/architecture.mdx) | フックシステムの仕組み |
-| [Testing](docs/testing.mdx) | テストの実行と新しいテストの作成 |
-
-### ドキュメントをローカルで実行する
-
-```bash
-docker build -f Dockerfile.docs -t failproofai-docs .
-docker run --rm -p 3000:3000 failproofai-docs
-```
-
-`http://localhost:3000` でMintlifyドキュメントサイトが開きます。docsディレクトリをマウントすると、コンテナは変更を監視します:
-
-```bash
-docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
-```
-
----
-
-## failproofaiコントリビューターへのご注意
-
-このリポジトリの `.claude/settings.json` は、標準の `npx -y failproofai` コマンドの代わりに `bun ./bin/failproofai.mjs --hook <EventType>` を使用しています。これは failproofai プロジェクト内で `npx -y failproofai` を実行すると自己参照の競合が発生するためです。
-
-その他のリポジトリでは、推奨される方法は `npx -y failproofai` で、以下のコマンドでインストールします:
-
-```bash
-failproofai policies --install --scope project
-```
-
-## コントリビューション
-
-[CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
-
----
-
-## ライセンス
-
-[LICENSE](LICENSE) を参照してください。
-
----
-
-**ExosphereHost: Reliability Research Lab for Your Agents** が開発・メンテナンスしています。私たちは独自のエージェント、ソフトウェア、専門知識を通じて、企業やスタートアップのAIエージェントの信頼性向上を支援しています。詳細は [exosphere.host](https://exosphere.host) をご覧ください。

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

@@ -1,307 +0,0 @@
-> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
-
-[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | **🇰🇷 한국어** | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
-
----
-
-```
-    ______      _ __                       ____   ___    ____
-   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
-  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
- / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
-/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
-               /_/
-```
-
-# Failproof AI
-
-[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
-[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
-[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
-[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
-[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
-
-**번역**: [简体中文](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 에이전트를 안정적이고, 목표에 집중하며, 자율적으로 실행되도록 유지하는 정책을 가장 쉽게 관리하는 방법 - **Claude Code** 및 **Agents SDK** 지원.
-
-- **30개의 내장 정책** - 일반적인 에이전트 장애 유형을 즉시 감지합니다. 파괴적인 명령 차단, 비밀 정보 유출 방지, 에이전트를 프로젝트 범위 내로 제한, 루프 감지 등 다양한 기능을 제공합니다.
-- **커스텀 정책** - JavaScript로 직접 안정성 규칙을 작성합니다. `allow`/`deny`/`instruct` API를 사용해 관행을 강제하고, 불필요한 변경을 방지하며, 작업을 제어하거나 외부 시스템과 연동할 수 있습니다.
-- **간편한 설정** - 코드를 작성하지 않고도 모든 정책을 조정할 수 있습니다. 프로젝트별 또는 전역으로 허용 목록, 보호 브랜치, 임계값을 설정하세요. 세 가지 범위의 설정이 자동으로 병합됩니다.
-- **에이전트 모니터** - 자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요. 세션을 탐색하고, 모든 도구 호출을 검사하며, 정책이 발동된 정확한 위치를 검토할 수 있습니다.
-
-모든 기능은 로컬에서 실행되며 - 어떤 데이터도 외부로 전송되지 않습니다.
-
----
-
-## 요구 사항
-
-- Node.js >= 20.9.0
-- Bun >= 1.3.0 (선택 사항 - 개발 또는 소스 빌드 시에만 필요)
-
----
-
-## 설치
-
-```bash
-npm install -g failproofai
-# 또는
-bun add -g failproofai
-```
-
----
-
-## 빠른 시작
-
-### 1. 전역으로 정책 활성화
-
-```bash
-failproofai policies --install
-```
-
-`~/.claude/settings.json`에 훅 항목을 작성합니다. 이후 Claude Code는 각 도구 호출 전후로 failproofai를 실행합니다.
-
-### 2. 대시보드 실행
-
-```bash
-failproofai
-```
-
-`http://localhost:8020`을 열어 세션을 탐색하고, 로그를 확인하며, 정책을 관리합니다.
-
-### 3. 활성 정책 확인
-
-```bash
-failproofai policies
-```
-
----
-
-## 정책 설치
-
-### 범위(Scope)
-
-| 범위 | 명령어 | 기록 위치 |
-|------|--------|-----------|
-| 전역 (기본값) | `failproofai policies --install` | `~/.claude/settings.json` |
-| 프로젝트 | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| 로컬 | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
-
-### 특정 정책 설치
-
-```bash
-failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-```
-
-### 정책 제거
-
-```bash
-failproofai policies --uninstall
-# 또는 특정 범위에서 제거:
-failproofai policies --uninstall --scope project
-```
-
----
-
-## 설정
-
-정책 설정은 전역의 경우 `~/.failproofai/policies-config.json`, 프로젝트별의 경우 프로젝트 내 `.failproofai/policies-config.json`에 저장됩니다.
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "sanitize-api-keys",
-    "block-push-master",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"],
-      "hint": "Try creating a fresh branch instead."
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  }
-}
-```
-
-**세 가지 설정 범위**는 자동으로 병합됩니다 (프로젝트 → 로컬 → 전역). 전체 병합 규칙은 [docs/configuration.mdx](docs/configuration.mdx)를 참고하세요.
-
----
-
-## 내장 정책
-
-| 정책 | 설명 | 설정 가능 |
-|------|------|:---------:|
-| `block-sudo` | 에이전트가 권한 있는 시스템 명령을 실행하지 못하도록 방지 | `allowPatterns` |
-| `block-rm-rf` | 실수로 인한 재귀적 파일 삭제 방지 | `allowPaths` |
-| `block-curl-pipe-sh` | 에이전트가 신뢰할 수 없는 스크립트를 셸로 파이프하지 못하도록 방지 | |
-| `block-failproofai-commands` | 자기 자신의 제거 방지 | |
-| `sanitize-jwt` | JWT 토큰이 에이전트 컨텍스트로 유출되지 않도록 차단 | |
-| `sanitize-api-keys` | API 키가 에이전트 컨텍스트로 유출되지 않도록 차단 | `additionalPatterns` |
-| `sanitize-connection-strings` | 데이터베이스 자격 증명이 에이전트 컨텍스트로 유출되지 않도록 차단 | |
-| `sanitize-private-key-content` | 출력에서 PEM 개인 키 블록 제거 | |
-| `sanitize-bearer-tokens` | 출력에서 Authorization Bearer 토큰 제거 | |
-| `block-env-files` | 에이전트가 .env 파일을 읽지 못하도록 방지 | |
-| `protect-env-vars` | 에이전트가 환경 변수를 출력하지 못하도록 방지 | |
-| `block-read-outside-cwd` | 에이전트를 프로젝트 범위 내로 제한 | `allowPaths` |
-| `block-secrets-write` | 개인 키 및 인증서 파일에 쓰기 방지 | `additionalPatterns` |
-| `block-push-master` | main/master에 실수로 푸시하는 것을 방지 | `protectedBranches` |
-| `block-work-on-main` | 에이전트가 보호된 브랜치에서 작업하지 못하도록 방지 | `protectedBranches` |
-| `block-force-push` | `git push --force` 방지 | |
-| `warn-git-amend` | 커밋 수정 전 에이전트에게 알림 | |
-| `warn-git-stash-drop` | 스태시 삭제 전 에이전트에게 알림 | |
-| `warn-all-files-staged` | 실수로 인한 `git add -A` 감지 | |
-| `warn-destructive-sql` | 실행 전 DROP/DELETE SQL 감지 | |
-| `warn-schema-alteration` | 실행 전 ALTER TABLE 감지 | |
-| `warn-large-file-write` | 예상치 못하게 큰 파일 쓰기 감지 | `thresholdKb` |
-| `warn-package-publish` | 실수로 인한 `npm publish` 감지 | |
-| `warn-background-process` | 의도하지 않은 백그라운드 프로세스 실행 감지 | |
-| `warn-global-package-install` | 의도하지 않은 전역 패키지 설치 감지 | |
-| …및 기타 | | |
-
-전체 정책 세부 사항 및 파라미터 참조: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
-
----
-
-## 커스텀 정책
-
-에이전트를 안정적이고 목표에 집중하도록 유지하는 정책을 직접 작성하세요:
-
-```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 (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
-    const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Writes to production paths are blocked");
-    return allow();
-  },
-});
-```
-
-다음 명령으로 설치합니다:
-
-```bash
-failproofai policies --install --custom ./my-policies.js
-```
-
-### 결정 헬퍼 함수
-
-| 함수 | 동작 |
-|------|------|
-| `allow()` | 작업 허용 |
-| `allow(message)` | 허용하고 Claude에 정보성 컨텍스트 전송 |
-| `deny(message)` | 작업 차단; 메시지가 Claude에 표시됨 |
-| `instruct(message)` | Claude의 프롬프트에 컨텍스트 추가; 차단하지 않음 |
-
-### 컨텍스트 객체 (`ctx`)
-
-| 필드 | 타입 | 설명 |
-|------|------|------|
-| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string` | 호출되는 도구 (`"Bash"`, `"Write"`, `"Read"`, …) |
-| `toolInput` | `object` | 도구의 입력 파라미터 |
-| `payload` | `object` | 전체 원시 이벤트 페이로드 |
-| `session.cwd` | `string` | Claude Code 세션의 작업 디렉터리 |
-| `session.sessionId` | `string` | 세션 식별자 |
-| `session.transcriptPath` | `string` | 세션 트랜스크립트 파일 경로 |
-
-커스텀 훅은 전이적 로컬 임포트, async/await, `process.env` 접근을 지원합니다. 오류 발생 시 fail-open 방식으로 처리됩니다 (`~/.failproofai/hook.log`에 기록되며 내장 정책은 계속 실행됩니다). 전체 가이드는 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)를 참고하세요.
-
-### 규약 기반 정책
-
-`.failproofai/policies/` 디렉터리에 `*policies.{js,mjs,ts}` 파일을 추가하면 별도의 플래그나 설정 변경 없이 자동으로 로드됩니다. 해당 디렉터리를 git에 커밋하면 모든 팀원이 동일한 품질 기준을 자동으로 적용받습니다.
-
-```text
-# 프로젝트 수준 — git에 커밋되어 팀과 공유
-.failproofai/policies/security-policies.mjs
-.failproofai/policies/workflow-policies.mjs
-
-# 사용자 수준 — 개인용, 모든 프로젝트에 적용
-~/.failproofai/policies/my-policies.mjs
-```
-
-두 수준 모두 로드됩니다(합집합). 각 디렉터리 내에서 파일은 알파벳 순서로 로드됩니다. 순서를 제어하려면 `01-`, `02-` 등의 접두사를 사용하세요. 팀에서 새로운 장애 유형을 발견하면 정책을 추가하고 푸시하기만 하면 됩니다 — 팀원 모두가 다음 풀에서 업데이트를 받게 됩니다. 바로 사용할 수 있는 예제는 [examples/convention-policies/](examples/convention-policies/)를 참고하세요.
-
----
-
-## 텔레메트리
-
-Failproof AI는 기능 사용 현황을 파악하기 위해 PostHog를 통해 익명의 사용 텔레메트리를 수집합니다. 세션 내용, 파일 이름, 도구 입력, 개인 정보는 절대 전송되지 않습니다.
-
-비활성화 방법:
-
-```bash
-FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
-```
-
----
-
-## 문서
-
-| 가이드 | 설명 |
-|--------|------|
-| [시작하기](docs/getting-started.mdx) | 설치 및 첫 번째 단계 |
-| [내장 정책](docs/built-in-policies.mdx) | 파라미터가 포함된 30개의 내장 정책 전체 목록 |
-| [커스텀 정책](docs/custom-policies.mdx) | 직접 정책 작성하기 |
-| [설정](docs/configuration.mdx) | 설정 파일 형식 및 범위 병합 |
-| [대시보드](docs/dashboard.mdx) | 세션 모니터링 및 정책 활동 검토 |
-| [아키텍처](docs/architecture.mdx) | 훅 시스템 동작 방식 |
-| [테스팅](docs/testing.mdx) | 테스트 실행 및 새 테스트 작성 |
-
-### 로컬에서 문서 실행
-
-```bash
-docker build -f Dockerfile.docs -t failproofai-docs .
-docker run --rm -p 3000:3000 failproofai-docs
-```
-
-`http://localhost:3000`에서 Mintlify 문서 사이트를 엽니다. docs 디렉터리를 마운트하면 컨테이너가 변경 사항을 감시합니다:
-
-```bash
-docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
-```
-
----
-
-## failproofai 기여자를 위한 참고 사항
-
-이 저장소의 `.claude/settings.json`은 표준 `npx -y failproofai` 명령 대신 `bun ./bin/failproofai.mjs --hook <EventType>`을 사용합니다. 이는 failproofai 프로젝트 내에서 `npx -y failproofai`를 실행하면 자기 참조 충돌이 발생하기 때문입니다.
-
-다른 모든 저장소에서는 권장 방법인 `npx -y failproofai`를 사용하며, 다음 명령으로 설치합니다:
-
-```bash
-failproofai policies --install --scope project
-```
-
-## 기여하기
-
-[CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요.
-
----
-
-## 라이선스
-
-[LICENSE](LICENSE)를 참고하세요.
-
----
-
-**ExosphereHost: 에이전트를 위한 신뢰성 연구 실험실**이 구축하고 유지 관리합니다. 저희는 자체 에이전트, 소프트웨어, 전문 지식을 통해 기업과 스타트업이 AI 에이전트의 신뢰성을 향상시킬 수 있도록 지원합니다. 자세한 내용은 [exosphere.host](https://exosphere.host)를 방문하세요.