failproofai 0.0.6-beta.2 → 0.0.6-beta.4

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

@@ -1,47 +0,0 @@
----
-title: ポリシーのインストール
-description: "エージェントのツール呼び出しごとにポリシーが実行されるよう有効化する"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Claude Code の `settings.json` にフックエントリを書き込み、failproofai がツール呼び出しを横断できるようにします。
-
-エイリアス: `failproofai p -i`
-
-## オプション
-
-| フラグ | 説明 |
-|--------|------|
-| `--scope user` | `~/.claude/settings.json` にインストール（デフォルト - すべてのセッションに適用） |
-| `--scope project` | カレントディレクトリの `.claude/settings.json` にインストール |
-| `--scope local` | カレントディレクトリの `.claude/settings.local.json` にインストール |
-| `--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
-```
-
-`--custom <path>` を指定すると、ファイルは即座に検証されます。少なくとも 1 回 `customPolicies.add()` を呼び出している必要があります。解決されたパスは `policies-config.json` に `customPoliciesPath` として保存されます。

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

@@ -1,31 +0,0 @@
----
-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/ja/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: ポリシーのアンインストール
-description: "Claude Code の設定からフックエントリを削除する"
----
-
-```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/ja/cli/version.mdx

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

package/.next/standalone/docs/ja/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: 設定
-description: "設定ファイルのフォーマット、3スコープシステム、マージルール"
-icon: gear
----
-
-failproofaiはJSON設定ファイルを使用して、有効なポリシー、その動作、カスタムポリシーの読み込み元を管理します。設定はチームと簡単に共有できるよう設計されています。リポジトリにコミットするだけで、すべての開発者が同じエージェントセーフティネットを利用できます。
-
----
-
-## 設定スコープ
-
-優先順位順に評価される3つの設定スコープがあります：
-
-| スコープ | ファイルパス | 用途 |
-|-------|-----------|---------|
-| **project** | `.failproofai/policies-config.json` | リポジトリごとの設定。バージョン管理にコミット |
-| **local** | `.failproofai/policies-config.local.json` | 個人用のリポジトリごとの上書き設定。gitignore対象 |
-| **global** | `~/.failproofai/policies-config.json` | すべてのプロジェクトに適用されるユーザーレベルのデフォルト |
-
-failproofaiがフックイベントを受け取ると、カレントワーキングディレクトリに存在する3つのファイルをすべて読み込んでマージします。
-
-### マージルール
-
-**`enabledPolicies`** — 3つのスコープすべての和集合となります。いずれかのレベルで有効化されたポリシーはアクティブになります。
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← 重複排除された和集合
-```
-
-**`policyParams`** — 特定のポリシーのパラメータを最初に定義したスコープが完全に優先されます。ポリシーのパラメータ内の値は深くマージされません。
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← projectが優先。globalは無視される
-```
-
-```text
-project:  (block-sudoエントリなし)
-local:    (block-sudoエントリなし)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← globalにフォールスルー
-```
-
-**`customPoliciesPath`** — 最初に定義したスコープが優先されます。
-
-**`llm`** — 最初に定義したスコープが優先されます。
-
----
-
-## 設定ファイルのフォーマット
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## フィールドリファレンス
-
-### `enabledPolicies`
-
-型：`string[]`
-
-有効にするポリシー名の一覧です。名前は `failproofai policies` が表示するポリシー識別子と完全に一致する必要があります。完全なリストは[組み込みポリシー](/ja/built-in-policies)を参照してください。
-
-`enabledPolicies` に含まれていないポリシーは、`policyParams` にエントリがあっても非アクティブになります。
-
-### `policyParams`
-
-型：`Record<string, Record<string, unknown>>`
-
-ポリシーごとのパラメータ上書き設定です。外側のキーはポリシー名、内側のキーはポリシー固有のものです。各ポリシーの利用可能なパラメータは[組み込みポリシー](/ja/built-in-policies)に記載されています。
-
-ポリシーにパラメータが存在しても指定しない場合、ポリシーの組み込みデフォルト値が使用されます。`policyParams` をまったく設定しないユーザーは、以前のバージョンと同一の動作になります。
-
-ポリシーのパラメータブロック内の未知のキーは、フック実行時には無視されますが、`failproofai policies` を実行したときに警告として表示されます。
-
-#### `hint`（横断的設定）
-
-型：`string`（任意）
-
-ポリシーが `deny` または `instruct` を返したときに理由に追記されるメッセージです。ポリシー自体を変更せずに、Claudeへの具体的なガイダンスを提供するために使用します。
-
-組み込み、カスタム（`custom/`）、プロジェクト規約（`.failproofai-project/`）、ユーザー規約（`.failproofai-user/`）を問わず、あらゆるポリシータイプで利用できます。
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Ask the user for approval first."
-    }
-  }
-}
-```
-
-`block-force-push` が拒否した場合、Claudeには「Force-pushing is blocked. Try creating a fresh branch instead.」と表示されます。
-
-文字列以外の値や空文字列は無視されます。`hint` が設定されていない場合、動作は変わりません（後方互換性があります）。
-
-### `customPoliciesPath`
-
-型：`string`（絶対パス）
-
-カスタムフックポリシーを含むJavaScriptファイルへのパスです。`failproofai policies --install --custom <path>` を実行すると自動的に設定されます（パスは保存前に絶対パスに解決されます）。
-
-ファイルはフックイベントのたびに新しく読み込まれます。キャッシュはありません。作成方法の詳細は[カスタムポリシー](/ja/custom-policies)を参照してください。
-
-### 規約ベースのポリシー
-
-`customPoliciesPath` の明示的な指定に加えて、failproofaiは `.failproofai/policies/` ディレクトリからポリシーファイルを自動的に検出して読み込みます：
-
-| レベル | ディレクトリ | スコープ |
-|-------|-----------|-------|
-| プロジェクト | `.failproofai/policies/` | バージョン管理を通じてチームと共有 |
-| ユーザー | `~/.failproofai/policies/` | 個人用。すべてのプロジェクトに適用 |
-
-**ファイルのマッチング：** `*policies.{js,mjs,ts}` にマッチするファイルのみ読み込まれます（例：`security-policies.mjs`、`workflow-policies.js`）。ディレクトリ内のその他のファイルは無視されます。
-
-**設定不要：** 規約ポリシーは `policies-config.json` へのエントリが不要です。ディレクトリにファイルを置くだけで、次のフックイベント時に自動的に読み込まれます。
-
-**ユニオン読み込み：** プロジェクトとユーザーの両方の規約ディレクトリがスキャンされます。両レベルのすべてのマッチするファイルが読み込まれます（最初のスコープ優先となる `customPoliciesPath` とは異なります）。
-
-詳細と例については[カスタムポリシー](/ja/custom-policies)を参照してください。
-
-### `llm`
-
-型：`object`（任意）
-
-AIコールを行うポリシー向けのLLMクライアント設定です。ほとんどのセットアップでは不要です。
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## CLIからの設定管理
-
-`policies --install` および `policies --uninstall` コマンドは Claude Code の `settings.json`（フックエントリポイント）に書き込みます。一方、`policies-config.json` は直接管理するファイルです。この2つは別々のものです：
-
-- **`settings.json`** — ツール使用のたびに Claude Code が `failproofai --hook <event>` を呼び出すよう指示する
-- **`policies-config.json`** — どのポリシーをどのパラメータで評価するかを failproofai に指示する
-
-`policies-config.json` はいつでも直接編集できます。変更は次のフックイベント時に即座に反映され、再起動は不要です。
-
----
-
-## 例：チームデフォルトを含むプロジェクトレベルの設定
-
-`.failproofai/policies-config.json` をリポジトリにコミットします：
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-各開発者は `.failproofai/policies-config.local.json`（gitignore対象）を作成して、チームメンバーに影響を与えることなく個人用の上書き設定を行えます。