failproofai 1.0.1-beta.1 → 1.0.2-beta.0

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

@@ -0,0 +1,199 @@
+---
+title: はじめに
+description: "failproofai をインストールし、ポリシーを有効にして、エージェントを安定稼働させましょう"
+icon: rocket
+---
+
+## 必要要件
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (オプション - ソースからビルドする場合のみ必要)
+
+---
+
+## インストール
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## クイックスタート
+
+<Steps>
+  <Step title="ポリシーを有効にする">
+    ポリシーとは、エージェントのツール呼び出しの前後に実行されるルールです。破壊的なコマンド、シークレットの漏洩、その他の障害モードを、被害が発生する前に検出します。
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    このコマンドは、インストール済みのエージェント CLI にフックエントリを書き込みます（Claude Code の `~/.claude/settings.json`、OpenAI Codex の `~/.codex/hooks.json`、GitHub Copilot CLI の `~/.copilot/hooks/failproofai.json`、Cursor Agent の `~/.cursor/hooks.json`、OpenCode の `~/.config/opencode/plugins/failproofai.mjs` と `~/.config/opencode/opencode.json` の `plugin` 配列へのエントリ、Pi の `~/.pi/agent/settings.json`、Hermes の `~/.hermes/config.yaml`、OpenClaw の `~/.openclaw/openclaw.json`、Factory Droid の `~/.factory/hooks.json`、Devin CLI の `~/.config/devin/config.json`、Antigravity CLI の `~/.gemini/config/hooks.json`、または Goose の自動検出プラグインディレクトリ `~/.agents/plugins/failproofai/hooks/hooks.json`）。複数がインストールされている場合は選択を促すプロンプトが表示されます。`--cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose`（任意のサブセット）を指定するとプロンプトをスキップできます。
+
+    GitHub Copilot CLI、Cursor Agent、OpenCode、Pi のサポートは**ベータ版**です。それぞれ `--cli copilot`、`--cli cursor`、`--cli opencode`、`--cli pi` でインストールしてください。Hermes（hermes-agent、Slack/Telegram ゲートウェイ）は `--cli hermes` でユーザースコープにインストールされ、**オフライン監査ソース**としても機能します。OpenClaw（openclaw ゲートウェイ、セルフホスト型マルチチャンネルアシスタント）は `--cli openclaw` でユーザースコープにインストールされ、インプロセスのプラグインフック（`before_agent_finalize` は実際のターン終了ゲートとして機能するため、`require-*-before-stop` 組み込みポリシーが有効）を通じてポリシーが適用されます。また**オフライン監査ソース**としても機能します。Factory Droid（`droid`）は `--cli factory`（ユーザー + プロジェクトスコープ）でインストールされ、**オフライン監査ソース**としても機能します。Devin CLI（`devin`、Cognition）は `--cli devin`（ユーザー + プロジェクトスコープ）でインストールされ、**オフライン監査ソース**としても機能します。Antigravity CLI（`agy`）は `--cli antigravity`（ユーザー + プロジェクトスコープ）でインストールされ、**オフライン監査ソース**としても機能します。Goose（コードネーム goose、Block）は `--cli goose`（ユーザー + プロジェクトスコープ）でインストールされます。インストーラーは `~/.agents/plugins/failproofai/` にプラグインディレクトリを作成するだけで、Goose が自動検出します。また**オフライン監査ソース**としても機能します。
+
+    ```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="確認する">
+    ```bash
+    failproofai policies
+    ```
+
+    すべてのポリシー、その有効/無効の状態、設定済みのパラメーターが一覧表示されます。
+  </Step>
+  <Step title="ダッシュボードを起動する">
+    ```bash
+    failproofai
+    ```
+
+    `http://localhost:8020` にローカルダッシュボードが開き、セッションの閲覧、ツール呼び出しの検査、ポリシーの管理ができます。
+  </Step>
+  <Step title="エージェントを実行する">
+    通常通り Claude Code を起動してください。エージェントが危険な操作を試みた場合、failproofai が自動的に介入します。エージェントを無人で動作させたまま、ダッシュボードで後から内容を確認できます。
+  </Step>
+</Steps>
+
+---
+
+## ポリシーの仕組み
+
+エージェントがツールを実行するたびに、Claude Code はサブプロセスとして failproofai を呼び出します。
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
+                                                 evaluates policies
+                                                 writes decision to stdout
+```
+
+各ポリシーは次の 3 つのいずれかの判定を返します。
+
+- **allow** - エージェントは通常通り処理を続行する
+- **deny** - アクションがブロックされ、エージェントに理由が通知される
+- **instruct** - エージェントのプロンプトに追加のコンテキストが付加される
+
+<Note>
+ポリシーはローカルプロセス上で実行されます。リモートサービスへのデータ送信は一切行われません。
+</Note>
+
+---
+
+## コンベンションベースのポリシーでチームポリシーを設定する
+
+チーム全体で品質基準を確立する最も手軽な方法は、`.failproofai/policies/` コンベンションを使うことです。このディレクトリにポリシーファイルを置くだけで自動的に読み込まれます。フラグや設定変更、インストールコマンドは一切不要です。
+
+<Steps>
+  <Step title="ポリシーディレクトリを作成する">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="ポリシーファイルを追加する">
+    スターターサンプルをコピーするか、独自のポリシーを作成してください。
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    または新しいポリシーを作成します。
+
+    ```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("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="git にコミットする">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    failproofai をインストール済みのチームメンバー全員が、これらのポリシーを自動的に受け取ります。開発者ごとのセットアップは不要です。
+  </Step>
+</Steps>
+
+<Tip>
+`.failproofai/policies/` をリポジトリにコミットして、チーム全体で同じ基準を共有しましょう。新たな障害モードを発見したらポリシーを追加してプッシュするだけで、全員が次回の `git pull` 時にアップデートを受け取れます。こうしたポリシーは、継続的に改善されていく生きた品質基準となっていきます。
+</Tip>
+
+---
+
+## データの保存場所
+
+すべての設定とログはお使いのマシン上に保存されます。
+
+| パス | 保存される内容 |
+|------|----------------|
+| `~/.failproofai/policies/local-policies/policies-config.json` | グローバルポリシー設定 |
+| `~/.failproofai/hook-activity/` | フック実行履歴（ページ付き JSONL） |
+| `~/.failproofai/logs/` | カスタムフックエラーのデバッグログ |
+| `.failproofai/policies-config.json` | プロジェクト単位の設定（コミット対象） |
+| `.failproofai/policies-config.local.json` | 個人用オーバーライド（gitignore 対象） |
+
+---
+
+## アンインストール
+
+```bash
+failproofai policies --uninstall
+```
+
+`~/.claude/settings.json` からフックエントリを削除します。`~/.failproofai/` 内の設定ファイルは保持されます。
+
+---
+
+## 次のステップ
+
+<CardGroup cols={2}>
+
+<Card title="設定" icon="gear" href="/ja/configuration">
+  スコープと設定ファイルのフォーマット
+</Card>
+
+<Card title="組み込みポリシー" icon="shield" href="/ja/built-in-policies">
+  パラメーター付き全 26 ポリシー
+</Card>
+
+<Card title="カスタムポリシー" icon="code" href="/ja/custom-policies">
+  JavaScript で独自のポリシーを作成する
+</Card>
+
+<Card title="エージェントモニター" icon="chart-line" href="/ja/dashboard">
+  セッションの監視とポリシー活動の確認
+</Card>
+
+</CardGroup>

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

@@ -0,0 +1,57 @@
+---
+title: "Failproof AI"
+description: "FailproofAI は AI エージェントに39個の組み込み障害ポリシーを提供し、ループ、シークレットの漏洩、破壊的なツール呼び出しなどを1回のインストールで検出します。"
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+**AI の障害処理**、**エラー回復**、**LLM の信頼性**のためのフックとポリシー。**Claude Code**、**OpenAI Codex**、**GitHub Copilot**、**Cursor Agent**、**OpenCode**、**Pi**、**Hermes**、**OpenClaw**、**Factory Droid**、**Devin CLI**、**Antigravity CLI**、および **Agents SDK** で AI エージェントを安定かつ自律的に稼働させ続けます。
+
+AI エージェントは予測可能な形で失敗します。破壊的なコマンドを実行したり、シークレットを漏洩したり、タスクから逸脱したり、ループにはまったり、main ブランチに直接プッシュしたりします。放置すると、小さな障害が連鎖してサービス停止や認証情報の漏洩、作業の消失につながります。
+
+FailproofAI はこの問題を**ポリシー**で解決します。これらのルールはエージェントのすべてのツール呼び出しにフックし、**障害を検出**し、**対処**（ブロック、指示、サニタイズ）し、注意が必要な場合に**通知**します。ローカルダッシュボードでは、すべてのツール呼び出し、エージェントの障害、および回復アクションを後から確認できます。
+
+トランスクリプトとポリシーの評価はあなたのマシン上に保存されます。データが送信されるのは、認証済みの監査リマインダーや招待などのオンライン機能を明示的に使用した場合のみです。
+
+## はじめに
+
+<CardGroup cols={2}>
+
+<Card title="39個の組み込みポリシー" icon="shield" href="/ja/built-in-policies">
+  破壊的なコマンドのブロック、シークレットの漏洩防止、エージェントをプロジェクトの境界内に収める設定など、すべてすぐに使えます。
+</Card>
+
+<Card title="カスタムポリシー" icon="code" href="/ja/custom-policies">
+  シンプルな allow / deny / instruct API を使って、JavaScript で独自のルールを記述できます。
+</Card>
+
+<Card title="エージェントモニター" icon="chart-line" href="/ja/dashboard">
+  席を外している間にエージェントが何をしたかを確認できます。セッションの閲覧、ツール呼び出しの検査、ポリシーが発動した箇所のレビューが可能です。
+</Card>
+
+<Card title="簡単な設定" icon="gear" href="/ja/configuration">
+  コードなしで任意のポリシーを調整できます。プロジェクトごと、またはグローバルにホワイトリスト、保護ブランチ、しきい値を設定できます。
+</Card>
+
+</CardGroup>
+
+## クイックスタート
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # enable policies (or skip — `failproofai` will offer to set them up on first run)
+failproofai                      # launch the dashboard
+```
+
+詳細な手順については、[はじめ方](/ja/getting-started)ガイドをご覧ください。

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

@@ -0,0 +1,82 @@
+---
+title: パッケージエイリアス
+description: "タイポスクワット防止のために登録されたエイリアスとその仕組み"
+icon: copy
+---
+
+## 公式パッケージ
+
+正式な npm パッケージは **`failproofai`** です:
+
+```bash
+npm install -g failproofai
+# または
+bun add -g failproofai
+```
+
+---
+
+## エイリアス名を所有する理由
+
+タイポスクワッティングは、悪意のある攻撃者が人気パッケージ名からキー入力1つ分しか違わない名前を登録するという、よくあるサプライチェーン攻撃です。インストールコマンドを誤って入力した無防備なユーザーは、フルシステムアクセス権限を持つ攻撃者制御のコードを実行することになります。これはまさに Failproof AI が防御するように設計された脅威です。
+
+この攻撃経路を排除するため、**npm 上の `failproofai` に対するよくあるスペルミスや表記バリアントをすべて先手を打って取得しています**。これらの名前はいずれも第三者に登録されることはありません。それぞれが本物の `failproofai` パッケージをインストールして委譲する薄いプロキシとなっています。
+
+---
+
+## 登録済みエイリアス
+
+**表記バリアント** - "failproof ai" のさまざまな書き方:
+
+| パッケージ | ステータス |
+|---------|--------|
+| `failproof` | ✅ 公開済み |
+| `failproof-ai` | ⏳ npm サポート対応待ち |
+| `fail-proof-ai` | ⏳ npm サポート対応待ち |
+| `failproof_ai` | ⏳ npm サポート対応待ち |
+| `fail_proof_ai` | ⏳ npm サポート対応待ち |
+| `fail-proofai` | ⏳ npm サポート対応待ち |
+
+**`failprof*` タイポ** - "proof" から `o` が1つ抜けたもの:
+
+| パッケージ | ステータス |
+|---------|--------|
+| `failprof` | ✅ 公開済み |
+| `failprof-ai` | ✅ 公開済み |
+| `failprofai` | ⏳ npm サポート対応待ち |
+| `fail-prof-ai` | ⏳ npm サポート対応待ち |
+| `failprof_ai` | ⏳ npm サポート対応待ち |
+
+**`faliproof*` タイポ** - `a` と `i` が入れ替わったもの:
+
+| パッケージ | ステータス |
+|---------|--------|
+| `faliproof` | ✅ 公開済み |
+| `faliproof-ai` | ✅ 公開済み |
+| `faliproofai` | ⏳ npm サポート対応待ち |
+
+> **対応待ちの理由:** npm のスパム防止ポリシーにより、記号を除去して類似性チェックを行った結果、既存パッケージと同じ文字列に正規化される名前はブロックされます。アンチスクワッティング目的でこれらの名前を予約するよう npm サポートに連絡済みです。承認され次第、有効化される予定です。
+
+公開済みのエイリアスが私たちのものであることは、以下のコマンドで確認できます:
+
+```bash
+npm info failproof
+# maintainers フィールドに "ExosphereHost Inc." が含まれているか確認してください
+```
+
+---
+
+## エイリアスの仕組み
+
+各エイリアスパッケージは:
+
+1. `failproofai` を依存関係としてリストに含めており、これにより本物のパッケージがインストールされ、バイナリが利用可能になります
+2. 自身の名前（例: `failprof-ai`）に対応するバイナリを公開し、すべての引数を `failproofai` バイナリへ転送します
+
+プロキシは2行の Node スクリプトです。ロジックもなく、ネットワーク呼び出しもなく、`failproofai` 自体が行う以上のデータ収集も一切ありません。
+
+---
+
+## 見落としている名前を発見した場合
+
+[failproofai/failproofai](https://github.com/failproofai/failproofai/issues) にイシューを作成してください。登録いたします。

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

@@ -0,0 +1,260 @@
+---
+title: テスト
+description: "ユニットテスト、E2Eテスト、テストヘルパー"
+icon: flask-vial
+---
+
+failproofai には2つのテストスイートがあります。**ユニットテスト**（高速、モック使用）と**エンドツーエンドテスト**（実際のサブプロセス呼び出し）です。
+
+---
+
+## テストの実行
+
+```bash
+# ユニットテストを一度だけ実行
+bun run test:run
+
+# ウォッチモードでユニットテストを実行
+bun run test
+
+# E2Eテストを実行（事前セットアップが必要 - 下記参照）
+bun run test:e2e
+
+# ビルドせずに型チェックのみ
+bunx tsc --noEmit
+
+# リント
+bun run lint
+```
+
+---
+
+## ユニットテスト
+
+ユニットテストは `__tests__/` ディレクトリに格納されており、`jsdom` を使用した [Vitest](https://vitest.dev) で実行されます。
+
+```text
+__tests__/
+  hooks/
+    builtin-policies.test.ts      # 各ビルトインのポリシーロジック
+    hooks-config.test.ts          # 設定の読み込みとスコープのマージ
+    policy-evaluator.test.ts      # パラメータのインジェクションと評価順序
+    custom-hooks-registry.test.ts # globalThis レジストリの追加/取得/クリア
+    custom-hooks-loader.test.ts   # ESM ローダー、推移的インポート、エラー処理
+    manager.test.ts               # インストール/削除/一覧操作
+  components/
+    sessions-list.test.tsx        # セッション一覧コンポーネント
+    project-list.test.tsx         # プロジェクト一覧コンポーネント
+    ...
+  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
+```
+
+### ポリシーのユニットテストを書く
+
+```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());
+  });
+});
+```
+
+---
+
+## エンドツーエンドテスト
+
+E2Eテストは実際の `failproofai` バイナリをサブプロセスとして起動し、JSON ペイロードを stdin にパイプして、stdout の出力と終了コードをアサートします。これにより、Claude Code が使用する完全なインテグレーションパスをテストします。
+
+### セットアップ
+
+E2Eテストはリポジトリのソースから直接バイナリを実行します。初回実行前に、カスタムフックファイルが `'failproofai'` からインポートする際に使用する CJS バンドルをビルドしてください。
+
+```bash
+bun build src/index.ts --outdir dist --target node --format cjs
+```
+
+その後、テストを実行します。
+
+```bash
+bun run test:e2e
+```
+
+公開フック API（`src/hooks/custom-hooks-registry.ts`、`src/hooks/policy-helpers.ts`、または `src/hooks/policy-types.ts`）を変更した場合は、`dist/` を再ビルドしてください。
+
+### E2Eテストの構成
+
+```text
+__tests__/e2e/
+  helpers/
+    hook-runner.ts      # バイナリを起動し、ペイロード JSON をパイプして、終了コード・stdout・stderr をキャプチャ
+    fixture-env.ts      # テストごとに分離された一時ディレクトリと設定ファイル
+    payloads.ts         # 各イベントタイプに対応した Claude 準拠のペイロードファクトリ
+  hooks/
+    builtin-policies.e2e.test.ts   # 実際のサブプロセスを使った各ビルトインポリシー
+    custom-hooks.e2e.test.ts       # カスタムフックの読み込みと評価
+    config-scopes.e2e.test.ts      # プロジェクト/ローカル/グローバルをまたいだ設定のマージ
+    policy-params.e2e.test.ts      # パラメータ化された各ポリシーへのパラメータインジェクション
+```
+
+### E2Eヘルパーの使い方
+
+**`FixtureEnv`** - テストごとに分離された環境:
+
+```typescript
+import { createFixtureEnv } from "../helpers/fixture-env";
+
+const env = createFixtureEnv();
+// env.cwd    - 一時ディレクトリ。payload.cwd として渡すと .failproofai/policies-config.json を読み込む
+// env.home   - 分離されたホームディレクトリ。実際の ~/.failproofai が混入しない
+
+env.writeConfig({
+  enabledPolicies: ["block-sudo"],
+  policyParams: {
+    "block-sudo": { allowPatterns: ["sudo systemctl status"] },
+  },
+});
+```
+
+`createFixtureEnv()` は `afterEach` クリーンアップを自動的に登録します。
+
+**`runHook`** - バイナリを呼び出す:
+
+```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`** - 使いやすいペイロードファクトリ:
+
+```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テストを書く
+
+```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("");  // allow → 空の stdout
+  });
+});
+```
+
+### E2Eレスポンスの形式
+
+| 判定 | 終了コード | stdout |
+|----------|-----------|--------|
+| `PreToolUse` deny | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` |
+| `PostToolUse` deny | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` |
+| Instruct（Stop 以外） | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` |
+| Stop instruct | `2` | stdout は空。理由は stderr に出力 |
+| Allow | `0` | 空文字列 |
+
+### Vitest の設定
+
+E2Eテストは `vitest.config.e2e.mts` を使用し、以下の設定が含まれます。
+
+- `environment: "node"` - ブラウザのグローバル変数は不要
+- `pool: "forks"` - 真のプロセス分離（テストがサブプロセスを起動する）
+- `testTimeout: 20_000` - テストごとに 20 秒（バイナリの起動 + フック評価）
+
+`forks` プールは重要です。スレッドベースのワーカーは `globalThis` を共有するため、サブプロセスを起動するテストに干渉する可能性があります。プロセスベースのフォークはこの問題を回避します。
+
+---
+
+## CI
+
+マージ前に、フルの CI 実行（`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`）がパスする必要があります。E2Eスイートは別の CI ジョブとして並行して実行されます。
+
+完全なマージ前チェックリストについては、[コントリビューティングガイド](../CONTRIBUTING.md)を参照してください。

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

@@ -0,0 +1,63 @@
+---
+title: "알림"
+description: "고객으로부터 먼저 듣는 대신, 팀이 이미 사용하는 채널에서 문제가 발생하는 즉시 알림을 받으세요."
+---
+
+
+고객으로부터 먼저 듣는 대신, 팀이 이미 사용하는 채널에서 문제가 발생하는 즉시 알림을 받으세요. 규칙을 한 번 설정하면 Failproof AI Observability가 일정에 따라 확인하고, 이메일, Slack, 웹훅, 또는 대시보드에서 직접 알림을 보내드립니다.
+
+![알림 페이지: 각 트리거, 평가 기간, 채널, 정보·경고·심각 심각도 배지를 보여주는 알림 규칙 카드 그리드](/agenteye/images/alerts.png)
+*모든 알림 규칙을 한눈에: 무엇을 감시하는지, 얼마나 자주, 어디로 알리는지, 얼마나 긴급한지.*
+
+## 사용자보다 먼저 문제를 파악하세요
+
+회귀를 발견하기 위해 대시보드를 새로고침하며 기다리지 마세요. 아무도 보고 있지 않을 때도 알아야 할 신호가 있다면 알림을 설정하고, 이미 사용하는 곳에서 바로 받으세요:
+
+- **이메일**: 알아야 할 담당자에게 전송.
+- **Slack**: 인시던트로 바로 이동하는 버튼이 포함된 풍부한 메시지.
+- **웹훅**: PagerDuty, Opsgenie 또는 자체 엔드포인트로 전달되는 JSON POST. 수신자가 신뢰할 수 있도록 선택적 서명 지원.
+- **대시보드 내**: 규칙을 조정 중이고 아직 아무에게도 알리고 싶지 않을 때를 위한 조용한 옵션.
+
+단일 규칙에 원하는 조합을 자유롭게 연결하세요. 심각도(정보, 경고, 심각)도 함께 전달되어 긴급한 알림은 긴급하게 보입니다.
+
+## JSON이 아닌 폼으로 규칙 작성
+
+무엇이 "고장"인지 폼으로 설명하면 Failproof AI Observability가 내부 규칙을 대신 작성해 줍니다. JSON 사양은 그 폼이 내부적으로 생성하는 결과물이므로, 규칙을 이해하기 위해 읽을 수는 있지만 직접 타이핑할 일은 거의 없습니다.
+
+![새 알림 폼: 이름과 설명, 활성화 토글, 메트릭 임계값·커스텀 SQL·평가 점수·복합 평가·이벤트별 조건을 제공하는 트리거 선택기](/agenteye/images/alert-new.png)
+*트리거를 선택하면 폼에 해당 필드가 표시됩니다. 저장을 누르면 규칙이 작성됩니다.*
+
+기본 흐름은 빠릅니다: 이름을 입력하고, **트리거**(무엇을 감시할지)를 선택하고, **임계값과 기간**(얼마나 나쁜지, 얼마나 오래)을 설정하고, **채널**을 하나 이상 연결한 다음 **저장**하고 **테스트**를 눌러 가상 알림을 발송해 모든 수신처가 올바르게 연결되었는지 확인하세요. 내부적으로는 다음과 같은 작은 사양이 생성됩니다:
+
+```json
+{ "metric": "p95_latency_ms", "op": ">", "value": 5000, "window_secs": 900 }
+```
+
+하나의 신호 유형에만 국한되지 않습니다. 장애를 어떻게 인식하느냐에 맞는 트리거를 선택하세요:
+
+| 트리거 | 발동 조건 |
+|---|---|
+| **메트릭 임계값** | 미리 설정된 메트릭(오류율, p95 또는 p99 지연시간, 이벤트 또는 오류 수, 토큰 사용량)이 특정 기간 동안 설정 기준을 초과할 때 |
+| **커스텀 SQL** | 사용자 정의 읽기 전용 쿼리가 행을 반환하거나, 쿼리로 계산된 값이 임계값을 초과할 때 |
+| **평가 점수** | 평가자 점수의 평균(예: 환각)이 임계값을 초과할 때 |
+| **복합 평가** | 여러 점수 조건을 any, all, 또는 최소 N개 논리로 결합하여 여러 점수에 걸쳐 나타나는 회귀를 감지할 때 |
+| **이벤트별** | 특정 에이전트, 특정 오류 유형, 또는 메시지 하위 문자열과 일치하는 단일 이벤트가 발생할 때 |
+
+[오류 페이지](/ko/agenteye/error-tracking)에서 이미 장애를 보고 계신가요? 각 행에는 **+ alert** 버튼이 있어 동일한 폼이 해당 장애를 다시 감지하도록 미리 채워진 상태로 열립니다. 방금 분류한 인시던트가 다음번에 알림을 보내는 항목이 됩니다.
+
+**위치:** 알림은 `/<org-slug>/alerts`에 있습니다. 규칙 생성, 편집, 삭제, 테스트에는 **`alerts:write`** 권한이 필요하며, 조회는 `alerts:read`로 충분합니다. 수신자 선택기에는 조직 구성원이 이름으로 표시되므로, 폼을 벗어나지 않고도 특정 사람에게 알림을 보낼 수 있습니다.
+
+## 실제 문제일 때만 알림 받기
+
+잘못된 측정 하나에 잠에서 깨어나서는 안 됩니다. **M of N** 노이즈 필터는 알림이 실제로 발동되기 전에 최근 몇 번의 확인 중 몇 번이 실패해야 하는지를 제어합니다. **3 of 5**로 설정하면 최근 다섯 번의 확인 중 세 번이 기준을 초과한 경우에만 규칙이 발동되어, 불안정한 신호가 헛된 경보를 울리지 않습니다. 첫 번째 위반 시 즉시 발동하려면 기본값 **1 of 1**로 유지하세요. 규칙 실행 빈도도 선택할 수 있으며, 신호가 실제로 변화하는 속도에 맞춰 1m, 5m, 15m, 1h 중에서 선택하세요.
+
+## 알림이 발동되면 어떻게 되나요
+
+기준 위반이 발생하면 **인시던트**가 생성되고 채널에 한 번 알림이 전송됩니다. 이후 팀이 인지하고, 담당자를 지정하고, 논의하고, 해결하는 과정이 깔끔하고 명확한 기록으로 남습니다. 해당 분류 워크플로우는 별도의 페이지에 있습니다: [인시던트](/ko/agenteye/incidents)를 참조하세요.
+
+## 관련 항목
+
+- [인시던트](/ko/agenteye/incidents): 발동된 알림을 열림에서 인지됨, 해결됨까지 추적합니다.
+- [오류 추적](/ko/agenteye/error-tracking): 에이전트 장애를 그룹화하고 클릭 한 번으로 알림으로 승격합니다.
+- [대시보드](/ko/agenteye/dashboards): 알림 임계값의 기반이 되는 공유 보드를 확인합니다.
+- [CLI 및 에이전트](/ko/agenteye/cli-and-agents): 터미널에서 알림을 생성하고 인시던트를 확인하거나, CI에 스크립트로 통합합니다.