failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ja/cli/audit.mdx

@@ -0,0 +1,116 @@
+---
+title: 過去のセッションを監査する（ベータ版）
+description: "過去のトランスクリプトから、エージェントが無駄または危険な操作を行った頻度を集計する"
+---
+
+<Note>
+  **ベータ機能。** 初期フィードバックを収集しながら提供しています。
+  検出器のカタログおよびレポートの形式は、次の安定版リリース前に変更される可能性があります。
+  問題があればIssueを作成してください。
+</Note>
+
+この監査機能は、過去のエージェントCLIトランスクリプトを failproofai のポリシーエンジンに通して再生し、**`/audit` ダッシュボードページ**に共有可能なビジュアルレポートを表示します。レポートにはエージェントのアーキタイプ、0〜100のスコア、そしてどのポリシーが何を検出できたかが詳しく示されます。
+
+## 実行方法
+
+3通りの起動方法があり、いずれも同じ `/audit` レポートに到達します。
+
+<CodeGroup>
+
+```bash npx (no install)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="インストール不要" icon="bolt">
+    `npx -y failproofai audit` は failproofai を取得してスキャンを実行し、ダッシュボードを自動的に開きます。事前インストールは不要です。
+  </Card>
+  <Card title="CLIから実行" icon="terminal">
+    `failproofai audit` はターミナルでスキャンを実行し、完了後に
+    `localhost:8020/audit` を自動的に開きます。
+  </Card>
+  <Card title="ダッシュボードから実行" icon="gauge">
+    `failproofai` を実行してナビゲーションバーの **Audit**（PoliciesとProjectsの間）をクリックするか、`/audit` を直接開いてください。
+  </Card>
+</CardGroup>
+
+<Tip>
+  `failproofai audit -h`（または `--help`）を実行すると使い方が確認できます。監査は**完全オフライン**で動作し、アカウントもネットワーク接続も不要です。`Ctrl+C` で停止するまでダッシュボードは提供され続けます。
+</Tip>
+
+ダッシュボードはこのマシン上の過去のエージェントCLIトランスクリプト（Claude Code、Codex、Copilot、Cursor、OpenCode、Pi）をスキャンし、failproofai が防ぐように設計した操作（環境変数チェック、フォースプッシュ、冗長な `cd <cwd>` プレフィックス、スリープポーリングループ、直前に編集したファイルの再読み込みなど）をエージェントがどのくらいの頻度で行っているかを報告します。
+
+各トランスクリプトについて、すべてのツール使用イベントが39個の組み込みポリシー**および**ランタイムポリシーではまだカバーされていないパターンを検出する8個の監査専用検出器を通じて再生されます。カウントはすべてのセッションを通じてポリシー／検出器ごとに集計されます。
+
+## 取得できる情報
+
+`/audit` ページは1画面で共有可能な**ポスター**と、その下に4つのセクションで構成されています。
+
+1. **ポスター** — エージェントのアイデンティティを一目で把握できます。**アーキタイプ**（8種類のうちの1つ：`optimist`、`cowboy`、`explorer`、`goldfish`、`paranoid architect`、`precision builder`、`hammer`、`ghost`）、ペルソナキーワード、そのアーキタイプの希少性、および階層バンド付きの**0〜100スコア**（`S`〜`bottom tier`）が表示されます。XやLinkedInに投稿したり、PNGとしてダウンロードして共有できます。
+2. **`// strengths`** — エージェントがすでに上手くできていること。スキャンの実際の数値（例：クリーンなツールコール率、`0`回のmainへのプッシュ試行）として表示され、関連するポリシーのレコードがクリーンな場合のみ表示されます。
+3. **`// quirks`** — 見逃したもの：failproofai が検出したはずの動作をランキング形式の表で表示します。*いつ*最後に発生したか、*何が見逃された*か（および本来ブロックしたはずの組み込みポリシー）、その*重大度*、および*発生頻度*（`new` / `recurring` / `N× seen`）が確認できます。
+4. **`// how to improve`** — 推奨される修正リスト：コピー＆ペーストで使える `failproofai policy add <slug>` が各ポリシーに1行ずつ表示され、すべての推奨事項を一括で有効にする **install all** ボタンと、適用した場合の**予測スコア**も確認できます。
+5. **`// come back better`** — 習慣化のサポート：再監査のメール**リマインダー**（`3d` / `7d` / `14d` / `30d`）の設定または今すぐ再監査の実行、および**友人への招待**（failproof.ai から送信され、あなたにCcされます）ができます。リマインダーと招待にはサインインが必要です。
+
+## スケジュール監査
+
+**failproofaid デーモン**を実行している場合（[`failproofai config`](/ja/cli/install-policies) を参照）、スケジュールに従って自動的に監査を再実行し、バックグラウンドで `/audit` レポートを更新できます。スキャンはこのマシン上のすべてのエージェントセッショントランスクリプトの*内容*を読み込むため、**デフォルトでは無効**になっています。明示的に要求するまでタイマーでスキャンは実行されません。
+
+`~/.failproofai/config.toml` で有効にします：
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| キー | 意味 |
+|---|---|
+| `auto` | `true` でスケジュールスキャンが有効になります。未設定、`false`、`"yes"` などはすべて無効です。 |
+| `interval_days` | スキャンの間隔（日数）。1〜90の範囲に制限され、`0`、負の値、または数値以外の値は `7` にフォールバックします。 |
+
+- スケジュールは**ウォールクロック**ベースのため、サスペンドや再起動後も維持されます。期限を過ぎてスリープしていたラップトップは起動時に**1回**だけ実行され、積み残しは発生しません。
+- 各実行は独立した低優先度（`nice 19`）プロセスです。ツールコールへの応答を維持するため、デーモンのフックパスは常に解放されています。
+- `failproofai audit` またはダッシュボードの再実行がすでに進行中の場合、スキャンはスキップされ、失敗ではなく後で再試行されます。
+- 進捗は `~/.failproofai/state/audit-schedule.json`（最終実行日時、次回予定日時）に書き込まれます。このファイルはデーモンが管理しています。スケジュールの変更は `config.toml` で行ってください。
+
+<Note>
+古いバージョンの failproofai でセットアップしたマシンでこれを有効にした場合は、
+`failproofai config` を一度実行してください。デーモンのサービス定義にCLIを起動するための追加エントリが必要であり、このコマンドの実行によって更新されます。
+</Note>
+
+## 監査専用検出器
+
+これらはリアルタイムではまだ適用されていない「非効率な動作」パターンを検出します。監査中にのみ実行され、ライブのツールコールをブロックすることはありません。
+
+| 検出器 | カウント対象 |
+|---|---|
+| `redundant-cd-cwd` | コマンドがすでに `cwd` で実行されているにもかかわらず `cd <cwd> && …` で始まるBashコマンド。 |
+| `prefer-edit-over-read-cat` | 単一のソースファイルに対する `cat` / `head` / `tail` / `less` / `more` — `Read` ツールを使用すべきケース。 |
+| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` によるインプレース編集 — `Edit` ツールを使用すべきケース。 |
+| `prefer-write-over-heredoc` | ヒアドキュメントや複数行の `echo > file` によるファイル書き込み — `Write` ツールを使用すべきケース。 |
+| `sleep-polling-loop` | 長時間の `sleep N`（30秒以上）や `while …; sleep …; done` によるポーリングループ。 |
+| `find-from-root` | `find /`、`find /home`、`find /usr` など — `cwd` を起点にスコープを絞るべきケース。 |
+| `git-commit-no-verify` | フックをスキップする `git commit … --no-verify` / `-n`。 |
+| `reread-after-edit` | 同一セッション内で直前に `Edit` / `Write` したファイルへの `Read`。 |
+
+## キャッシュ
+
+- **トランスクリプトごとのキャッシュ**は `~/.failproofai/cache/audit/<sha1>.json` に保存され、`(mtime, size, engineVersion, detectorVersion)` をキーとします。トランスクリプトまたはポリシー／検出器のコードが変更されると自動的に無効化されます。各エントリには `cachedAt` タイムスタンプが**TTLメタデータ**として保存されます（キャッシュキーには含まれません）。**7日**を超えたエントリは読み取り時に拒否されるため、古い結果が進化する検出器の意図を超えて存続することはありません。
+- **全体結果のキャッシュ**は `~/.failproofai/audit-dashboard.json`（モード0600）に保存されます。ページに遷移したときに再実行なしでダッシュボードを即座に表示できます。こちらも**7日のTTL**を超えると読み取り時に拒否され、`/audit` は空の状態にフォールバックして新規実行を促します。レポート下部の `[ re-audit now ]` をクリックして更新してください。再監査は `noCache: true` で送信されるため、トランスクリプトごとのキャッシュを迂回してすべてのトランスクリプトを再スキャンします（キャッシュ結果を返すのではなく）。実行中は上部の固定ストリップで進捗がストリーミング表示され、成功時は結果がその場で入れ替わります（ページリロードなし。再監査が失敗した場合は以前のレポートが保持されます）。
+
+## 注意事項
+
+- **変更なし。** 監査は読み取り専用モードで再生されます。`warn-repeated-tool-calls` はセッションごとのサイドカーが変更されてしまうためスキップされます。
+- **ワークフローポリシーはスキップされます。** `require-*-before-stop` ポリシーは `Stop` イベントと `execSync` によるライブのgit状態に対してのみ動作します。「2025年の時点で何が起きていたか」を意味のある形で解釈できないため、監査カウントには含まれません。
+- **カスタムポリシーはスキップされます。** ユーザーが設定したカスタムフックは再生されません（元のセッション以降に変更されている可能性があるため）。

package/.next/standalone/docs-old/ja/cli/dashboard.mdx

@@ -0,0 +1,29 @@
+---
+title: セッションの表示
+description: "ダッシュボードを起動してエージェントセッションの確認とポリシーの管理を行う"
+---
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` でウェブダッシュボードを起動します。
+
+## オプション
+
+| フラグ | 説明 |
+|--------|------|
+| `--port <number>` | リッスンするポート番号（デフォルト: `8020`） |
+| `--allowed-origins <origins>` | 開発リソースへのアクセスを許可するホスト/IPのカンマ区切りリスト |
+
+デフォルト以外の Claude プロジェクトフォルダをダッシュボードに指定する場合は、起動時に `CLAUDE_PROJECTS_PATH` 環境変数を設定してください。
+
+## 使用例
+
+```bash
+# 別のポートで起動する
+failproofai --port 9000
+
+# 環境変数でカスタムの Claude プロジェクトパスを指定する
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/ja/cli/environment-variables.mdx

@@ -0,0 +1,63 @@
+---
+title: 環境変数
+description: "環境変数を使用して failproofai の動作を設定する"
+---
+
+## ダッシュボード
+
+| 変数 | 説明 |
+|----------|-------------|
+| `PORT` | ダッシュボードのポート（デフォルト: `8020`） |
+| `CLAUDE_PROJECTS_PATH` | Claude Code のプロジェクトフォルダの検索場所を上書きする |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | 非表示にするダッシュボードページをカンマ区切りで指定 |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | 開発リソースへのアクセスを許可するホスト/IP。`--allowed-origins` と同等。 |
+
+## ログ
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | サーバーのログレベル（デフォルト: `warn`） |
+| `FAILPROOFAI_HOOK_LOG_FILE` | カスタムフックログファイルのパス。`true` を指定するとデフォルトのパス（`~/.failproofai/logs/hooks.log`）が使用される |
+
+## テレメトリ
+
+failproofai はデフォルトで匿名の使用状況テレメトリを報告します。無効にする方法は2つあり、より制限の厳しい設定が優先されます。つまり、環境変数によって設定ファイルで無効化された機能を再有効化することはできません。
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | 現在のプロセスにおける匿名使用状況テレメトリを無効化する |
+
+マシン全体で恒久的に無効化するには、`~/.failproofai/config.toml` に以下を追加してください:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+**failproofaid デーモン**を実行している場合は、設定ファイルを使用してください。
+デーモンはシステムスコープのサービスであり、そのプロセス環境にはシェルからエクスポートされた変数が含まれません。そのため `FAILPROOFAI_TELEMETRY_DISABLED` はデーモンには届きません。`[telemetry] enabled = false` はCLIとデーモンの両方で読み込まれます。
+</Note>
+
+デーモンが報告するのは、自身の**ライフサイクル**に関する情報のみです。具体的には、起動時（および前回の実行が正常終了したかどうか）、停止時、評価ワーカーの起動または再起動時、コレクタータスクの失敗時、クラウドポリシーの取得結果などです。これらには低カーディナリティの値とカウントのみが含まれ、ファイルパス、コマンド、ポリシー、プロンプト、トランスクリプトから読み取られた情報は一切含まれません。ツール呼び出しごとのイベントも存在しません。
+
+## 認証
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOF_API_URL` | ダッシュボードの認証ダイアログで使用するAPIサーバーのベースURLを上書きする。デフォルトは `https://api.befailproof.ai`。ローカルのAPIサーバーを使用する場合は `http://localhost:8080`（または該当するアドレス）に設定する。 |
+| `FAILPROOFAI_AUTH_DIR` | `auth.json` の保存場所を上書きする（デフォルト: `~/.failproofai`）。主に独立したテスト環境で使用する。 |
+
+## 初回起動時のプロンプト
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | `failproofai` を初めて単独で実行した際に表示されるポリシーのインストールを提案するプロンプトをスキップする |
+
+## LLM（ポリシー評価用）
+
+| 変数 | 説明 |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | LLM APIエンドポイント（デフォルト: `https://api.openai.com/v1`） |
+| `FAILPROOFAI_LLM_API_KEY` | LLMを使用したポリシー向けのAPIキー |
+| `FAILPROOFAI_LLM_MODEL` | モデル名（デフォルト: `gpt-4o-mini`） |

package/.next/standalone/docs-old/ja/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: フックハンドラー（内部）
+description: "各ツールイベントで Claude Code が呼び出すサブプロセス"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+これは `failproofai policies --install` によって Claude Code の `settings.json` に登録されるコマンドです。通常、直接呼び出す必要はありません。
+
+stdin から JSON ペイロードを読み込み、有効なすべてのポリシーを評価し、判定結果を示す終了コードで終了します：
+
+| 終了コード | 判定 | 効果 |
+|-----------|----------|--------|
+| `0` | `allow` | アクションを許可する |
+| `1` | `deny` | アクションをブロックする — Claude は拒否理由を受け取る |
+| `2` | `instruct` | Claude のコンテキストにガイダンスを注入する |
+
+### サポートされているイベントタイプ
+
+| カテゴリ | イベント |
+|----------|--------|
+| **ツール実行** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **セッションライフサイクル** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **ユーザーインタラクション** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **サブエージェント & タスク** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **設定** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **ファイルシステム** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **コンテキスト** | `PreCompact`, `PostCompact` |

package/.next/standalone/docs-old/ja/cli/install-policies.mdx

@@ -0,0 +1,57 @@
+---
+title: ポリシーのインストール
+description: "エージェントのツール呼び出しごとにポリシーが実行されるよう有効化する"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+インストール済みのエージェント CLI（Claude Code、OpenAI Codex、または GitHub Copilot CLI _(ベータ)_）の設定ファイルにフックエントリを書き込み、failproofai がツール呼び出しをインターセプトできるようにします。
+
+エイリアス: `failproofai p -i`
+
+## オプション
+
+| フラグ | 説明 |
+|------|-------------|
+| `--cli claude\|codex\|copilot` | インストール対象のエージェント CLI。スペース区切りで複数指定可能（例: `--cli claude codex copilot`）または繰り返し指定。省略するとインストール済み CLI を自動検出してプロンプトを表示。 |
+| `--scope user` | ユーザースコープの設定ファイルにインストール（Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`）。デフォルト。 |
+| `--scope project` | プロジェクトスコープの設定ファイルにインストール（Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`）。 |
+| `--scope local` | Claude のみ — `<cwd>/.claude/settings.local.json` にインストール。Codex および Copilot には `local` スコープがありません。 |
+| `--custom <path>` / `-c` | カスタムフックポリシーを含む JS ファイルへのパス |
+
+## 動作
+
+- **ポリシー名の未指定** — ポリシーを選択するインタラクティブなプロンプトを表示
+- **特定の名前を指定** — 指定したポリシーを有効化（既に有効なポリシーに追加）
+- **`all`** — 利用可能なすべてのポリシーを有効化
+
+インストールは追記型です。`--install` を再度実行しても既存のポリシーは削除されず、新しいポリシーが追加されます。
+
+## 使用例
+
+```bash
+# すべてのデフォルトポリシーをグローバルにインストール（インタラクティブ）
+failproofai policies --install
+
+# 現在のプロジェクトに特定のポリシーをインストール
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# すべてのポリシーを一括で有効化
+failproofai policies --install all
+
+# カスタムポリシーファイルを使用してインストール
+failproofai policies --install --custom ./my-policies.js
+
+# OpenAI Codex 向けにインストール（プロジェクトスコープ）
+failproofai policies --install --cli codex --scope project
+
+# GitHub Copilot CLI（ベータ）向けに現在のプロジェクトへインストール
+failproofai policies --install --cli copilot --scope project
+
+# 3 つの CLI すべてに一括でインストール
+failproofai policies --install --cli claude codex copilot
+```
+
+`--custom <path>` を指定した場合、ファイルは即座に検証されます。少なくとも 1 回 `customPolicies.add()` を呼び出している必要があります。解決されたパスは `customPoliciesPath` として `policies-config.json` に保存されます。

package/.next/standalone/docs-old/ja/cli/list-policies.mdx

@@ -0,0 +1,31 @@
+---
+title: ポリシー一覧
+description: "有効なポリシー、そのパラメータ、カスタムポリシーを確認する"
+---
+
+```bash
+failproofai policies
+```
+
+すべてのポリシーとそのステータス、設定済みパラメータ、カスタムポリシーを表示します。
+
+## 出力例
+
+```text
+Failproof AI Hook Policies (user)
+
+  Status  Name                          Description
+  ──────  ──────────────────────────────────────────────────────────────
+  ✓       block-sudo                    Block sudo commands
+            allowPatterns: ["sudo systemctl status"]
+  ✓       block-rm-rf                   Block recursive deletions
+  ✗       block-curl-pipe-sh            Block curl|bash patterns
+  ✓       sanitize-api-keys             Redact API keys from output
+            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
+
+  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
+  ✓       require-jira-ticket           Block commits without ticket
+  ✓       approval-gate                 Approval gate for destructive ops
+```
+
+`policyParams` 内の未知のキーはここでフラグが立てられるため、タイポを早期に発見できます。

package/.next/standalone/docs-old/ja/cli/migrate.mdx

@@ -0,0 +1,86 @@
+---
+title: ホームディレクトリを移行する
+description: "~/.failproofai をこのバージョンが対応するレイアウトに更新する。まず実行内容を確認することも可能"
+---
+
+```bash
+failproofai migrate --dry-run   # 計画を表示するだけで、何も変更しない
+failproofai migrate             # 実際に実行する
+```
+
+ほとんどの場合、このコマンドを手動で入力する必要はありません。アップグレード後の最初のコマンド実行時に自動的に動作し、[`failproofai update`](/ja/cli/update) にも含まれています。実行前に計画を確認したい場合や、移行処理だけを単独で実行したい場合に直接使用してください。
+
+## バージョンではなくレイアウトに基づく管理
+
+`~/.failproofai/VERSION` には**レイアウト**番号が記録されています。これはリリースバージョンではなく、ディレクトリの構造を表す番号です。移行処理はこの番号をキーとしているため、バージョンを大幅にスキップしてもコストが低く抑えられます。
+
+- npm のバージョンはリリースごとに変わり、2つのレイアウト間に数十ものバージョンが存在します。
+- そのため、**レイアウト変更なし**で30回のリリースをスキップしたマシンは、意味のない処理を30回実行するのではなく、**移行処理をゼロ回**実行します。
+- 複数のレイアウトをまとめてスキップした場合は、各ステップが順番に実行されます。各ステップは自身の前後の状態だけを把握します。
+
+npm はインストール済みパッケージを単独で更新できないため、この設計は重要です。あるバージョンを何ヶ月も使い続けた後、一気に複数のレイアウトを飛び越えるケースは珍しいことではなく、むしろ通常のケースです。
+
+## ドライラン
+
+`--dry-run` は実行されるステップのチェーンと、事前に保存されるファイルを表示するだけで、何も変更しません。移行処理、バックアップ、台帳への記録はいずれも行われません。
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## 引き継がれるものと再構築されるもの
+
+ホームディレクトリ内の各パスが保持するデータの種類によって、移行時に削除できるかどうかが決まります。ルールは次のとおりです：**派生データや再取得可能なデータは削除してよい。ユーザーが入力したもの、未配信のもの、マシンを識別するものは引き継ぐ。**
+
+| 引き継がれる | 再構築または再取得 |
+|---|---|
+| `config.json` — 設定、`daemon.configured`、追加のキャプチャパス | 監査キャッシュ |
+| `credentials.json` — クラウド登録情報 | クラウド管理のデプロイメント（次回のポーリング時に再取得してダイジェスト検証） |
+| `policies-config.json` — ポリシーの選択とパラメータ | デーモンのスクラッチ状態 |
+| `policies/` — 独自のポリシーファイルとそこでインポートするヘルパー | |
+| `hook-activity/` — ダッシュボードが読む決定ログ | |
+| アップロードキューに残っている未配信イベント | |
+| `cursors/` — コレクターのウォーターマーク | |
+| `bin/` 内のデーモンバイナリ | |
+
+<Note>
+  未配信イベントを削除せず引き継ぐのは、失うと取り返しのつかない損失になるからです。単に遅延が生じるだけでなく、コレクターのウォーターマークがスプール内のデータより先に進んでしまっているため、そのトランスクリプトの範囲は二度と読まれることがありません。移行処理はデーモンに対して、完了次第スプールを配信するよう指示するため、通常は引き継ぐべきデータが残っていない状態になります。
+</Note>
+
+新しいバージョンが `config.json`、`credentials.json`、`policies-config.json` に書き込んだキーは、古いバージョンで読み込む際も削除されずに保持されます。
+
+## 残されるレコード
+
+```
+~/.failproofai/migrations/
+  applied.json                 ステップごとに1エントリ：レイアウト、CLI、タイムスタンプ、所要時間、結果
+  backup-layout<n>/            最初のステップ実行前に取得した、置き換え不可能なファイルのコピー
+```
+
+`applied.json` は「このマシンで実際に何が行われたか」を示すものです。アップグレード後に問題が発生した場合、最初に確認すべき情報です。バグレポートにはこのファイルを添付してください。
+
+バックアップはディレクトリ全体のコピーではなく、意図的に小さく保たれています。移行処理は設計上、置き換え不可能なものを削除しません。そのため、保険をかける必要があるのは**ステップのバグ**に対してであり、そのようなバグが影響を与えるのはこれらのわずかなファイルだけです。
+
+## ステップが失敗した場合
+
+ステップが失敗した時点でチェーンが停止します。`VERSION` は完了したステップによってのみ更新されるため、ホームディレクトリは古いレイアウトのままとなり、次のコマンド実行時にリトライされます。部分的な移行が完了したとしてホームが最新状態とみなされることはありません。ステップは `applied.json` に `"ok": false` として記録され、バックアップは取得された場所に残ります。
+
+## 新しいホームは移行されず拒否される
+
+`~/.failproofai/` が現在実行中の failproofai よりも**新しい**バージョンによって書き込まれた場合、コマンドは停止し、代わりにアップグレードするよう指示します。そのデータに問題はなく、新しい CLI で正常に読み込めます。そこから「前方に」移行するという概念は存在せず、リセットすると回復可能なデータが失われます。
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+デーモンも同じルールを適用します。`failproofaid` は対応していないレイアウトに対しては起動を拒否します。移動したパスを読み書きするのではなく、起動しないという選択をします。

package/.next/standalone/docs-old/ja/cli/remove-policies.mdx

@@ -0,0 +1,43 @@
+---
+title: ポリシーのアンインストール
+description: "Claude Code の settings.json からフックエントリを削除する"
+---
+
+```bash
+failproofai policies --uninstall [policy-names...] [options]
+```
+
+Claude Code の `settings.json` から failproofai フックエントリを削除します。
+
+エイリアス: `failproofai p -u`
+
+## オプション
+
+| フラグ | 説明 |
+|------|-------------|
+| `--scope user` | グローバル設定から削除（デフォルト） |
+| `--scope project` | プロジェクト設定から削除 |
+| `--scope local` | ローカル設定から削除 |
+| `--scope all` | すべてのスコープから一括削除 |
+| `--custom` / `-c` | 設定から `customPoliciesPath` をクリア |
+
+## 動作
+
+- **ポリシー名を指定しない場合** — 設定ファイルからすべての failproofai フックエントリを削除します
+- **特定の名前を指定した場合** — 該当ポリシーを無効化しますが、フックはインストールされたままにします
+
+## 使用例
+
+```bash
+# すべてのフックをグローバルから削除
+failproofai policies --uninstall
+
+# 特定のポリシーを無効化（フックはインストールされたまま）
+failproofai policies --uninstall block-sudo
+
+# すべてのスコープからフックを削除
+failproofai policies --uninstall --scope all
+
+# カスタムポリシーのパスをクリア
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/ja/cli/update.mdx

@@ -0,0 +1,64 @@
+---
+title: アップグレード後の更新
+description: "npm が担えないアップグレードの残り半分を完了する：ホームの移行とデーモンの同期"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+アップグレードはこれだけです。`npm` が CLI を差し替え、`failproofai update` が残りを行います。
+
+## 2つ目のコマンドが必要な理由
+
+`npm install -g` が置き換えるのは CLI だけです。failproofai のインストールには、意図的にパッケージの外側に置かれた2つのコンポーネントが存在しており、npm を実行しても両方とも更新されません。
+
+- **`~/.failproofai/`** — 設定、クラウド登録、ポリシー選択、履歴が含まれます。新バージョンでは構成が変わる場合があり、その再編成は両方の構成を把握したコードで行う必要があります。
+- **`failproofaid` デーモンバイナリ** — `~/.failproofai/bin/failproofaid-<version>` に配置されています。`node_modules` の外側に置かれているのは意図的な設計です。実行中のサービスのファイルを差し替えると、稼働中のデーモンが異なるソースからビルドされたバイナリを参照することになり、またパッケージを削除するとサービスが起動のたびにクラッシュループに陥ります。
+
+そのため `npm install -g` だけを実行した状態では、CLI は新しくなってもデーモンは古いままです。`failproofaid` は認識できないホームレイアウトに対して起動を拒否します — バージョン不一致を無言で許容するのではなく、明示的にエラーとするためです。この2つを揃えるのが `failproofai update` の役割です。
+
+## 実行内容
+
+<Steps>
+  <Step title="未適用のレイアウト移行を実行する">
+    `~/.failproofai/VERSION` に記録されたレイアウトを読み取り、現バージョンが扱えるレイアウトへと移行するステップを実行します。通常は何も行いません — [`failproofai migrate`](/ja/cli/migrate) を参照してください。
+  </Step>
+  <Step title="対応するデーモンバイナリを配置する">
+    可能であれば npm がすでにダウンロード済みのプラットフォームパッケージから取得します（ネットワーク不要）。それが無い場合は、この正確なバージョンのリリースアセットから取得し、使用前に SHA-256 で検証します。
+  </Step>
+  <Step title="サービスを再起動して正常に復帰したことを確認する">
+    想定ではなく実際に確認します — サービスマネージャーはプロセスをフォークした時点でアクティブと報告しますが、それは正常動作を意味しません。
+  </Step>
+</Steps>
+
+## オプション
+
+| フラグ | 効果 |
+|--------|------|
+| `--no-daemon` | ホームの移行のみ行い、デーモンは現在のバージョンのまま残します。 |
+
+<Warning>
+  `--no-daemon` を指定すると、バージョンがずれたデーモンがそのまま残ります。デーモンを必須とするよう設定されたマシンでは、デーモンが応答できない場合にすべてのフックイベントが **フェイルクローズ** になります — 移行後のホームに対して起動を拒否するデーモンは応答できません。デーモンの更新も一緒に実行することを推奨します。
+</Warning>
+
+## 問題が発生した場合
+
+コマンドはゼロ以外の終了コードで終了し、どちらの処理が失敗したかを表示します。知っておくべき2つのケース：
+
+- **移行ステップが完了しなかった。** ホームには*古い*レイアウトが記録されたままになるため、次回のコマンド実行時に再試行されます — 部分的な移行が成功したとしてホームが現行とマークされることはありません。実行前に設定と登録情報のコピーが `~/.failproofai/migrations/backup-layout<n>/` に保存されています。
+- **パスワードなしでデーモンを再起動できなかった。** `sudo -n` を意図的に使用しているため、進捗表示の裏でパスワードを求めることはありません。コマンドは自分で実行すべき正確なコマンド行を表示します。
+
+<Note>
+  これらの操作はインタラクティブなセットアップウィザードを必要としません。設定、クラウド登録、ポリシー選択はアップグレードを経ても保持されるため、移行済みのマシンはアップグレード前とまったく同じように動作します — これは誰も座っていないマシン（CI ランナー、フリートボックス、ヘッドレスゲートウェイなど）で特に重要です。
+</Note>
+
+## 自動化
+
+`failproofai update` は非インタラクティブで、何も行うことがない場合でも安全に実行できます — 「移行は不要でした」と報告して終了コード 0 で終了します。プロビジョニングスクリプトや Dockerfile でアップグレードのたびに実行するのが想定された使い方です。
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+（イメージビルド時は `--no-daemon` を使用します。この時点ではまだ再起動するサービスが存在しないためです。）

package/.next/standalone/docs-old/ja/cli/version.mdx

@@ -0,0 +1,12 @@
+---
+title: バージョン確認
+description: "インストール済みの failproofai バージョンを表示する"
+---
+
+```bash
+failproofai --version
+# or
+failproofai -v
+```
+
+インストール済みのバージョン番号を表示します。