failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,307 @@
+> **⚠️** 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` | コミット修正前にエージェントへ通知 | |
+| `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` へのアクセスをサポートしています。エラーはフェイルオープン（`~/.failproofai/hook.log` に記録され、ビルトインポリシーは継続）となります。詳細なガイドは [docs/custom-hooks.mdx](docs/custom-hooks.mdx) を参照してください。
+
+### 規約ベースのポリシー（v0.0.2-beta.7+）
+
+`*policies.{js,mjs,ts}` ファイルを `.failproofai/policies/` に配置するだけで自動的に読み込まれます — `--custom` フラグや設定変更は不要です。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: Reliability Research Lab for Your Agents** によって構築・メンテナンスされています。私たちは自社のエージェント、ソフトウェア、専門知識を通じて、企業やスタートアップのAIエージェントの信頼性向上を支援しています。詳細は [exosphere.host](https://exosphere.host) をご覧ください。

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

@@ -0,0 +1,307 @@
+> **⚠️** 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
+```
+
+---
+
+## 정책 설치
+
+### 스코프
+
+| 스코프 | 명령어 | 저장 위치 |
+|--------|--------|-----------|
+| 전역 (기본값) | `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)를 참고하세요.
+
+### 컨벤션 기반 정책 (v0.0.2-beta.7 이상)
+
+`.failproofai/policies/` 디렉토리에 `*policies.{js,mjs,ts}` 파일을 추가하면 자동으로 로드됩니다 — `--custom` 플래그나 설정 변경이 필요 없습니다. 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)를 방문하세요.