カスタムポリシー

.failproofai/policies/ 以下に policies.js、policies.mjs、または policies.ts で終わるファイルを作成してください。規約ファイルはプロジェクトスコープおよびユーザースコープで自動的に読み込まれます。

クラウド公開前にポリシーをテストする

ダッシュボード
CLI

カスタムポリシーをテストマシン1台にインストールし、マッチするアクションと正当なノンマッチの両方をトリガーします。
Observe → policy に移動して、2つの判定結果を比較します。
リンクされた各セッションを開き、イベントペイロードにルールの根拠となる十分な証跡が含まれているか確認します。
動作が正しいことを確認したら、レビュー済みのソースを Admin → policy editor に移してバージョンを公開します。

failproofai policies --install --custom ./security.policies.ts \
  --cli claude --scope project
failproofai policies

.failproofai/policies/ 以下の規約ファイルは --custom なしで読み込まれます。壊れたモジュールでバリデーションを失敗させたい CI 環境では、明示的なインストールコマンドを残してください。

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "protect-production-paths",
  description: "Block writes to production configuration",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
    const path = String(ctx.toolInput?.file_path ?? "").replaceAll("\\", "/");
    if (path.split("/").includes("production")) {
      return deny("Writes to production configuration require approval.");
    }
    return allow();
  },
});

これは production/config.yml、/srv/production/config.yml、/srv/production、C:\\production\\config.yml に対して Write と Edit の両方でマッチします。production はパスセグメント全体でなければならないため、production-backup のような名前にはマッチしません。明示的なファイルを検証してインストールするには：

failproofai policies --install --custom ./security.policies.ts

ポリシーコンテキストには、イベントタイプ、正規化されたペイロード、ツール名と入力、セッションメタデータ、パラメーター、および利用可能な場合はソース CLI が含まれます。

失敗パスのテスト

エントリファイルまたはそれがインポートするローカルモジュールを変更した後は、バリデーションを実行してください：

failproofai policies --install --custom ./security.policies.ts --scope project

strict な CLI パスは、ファイルが見つからない場合、構文エラー、未解決のインポート、トップレベルの例外、モジュール読み込みタイムアウトで失敗します。実行時に壊れたカスタムファイルはログに記録されてスキップされるため、組み込みポリシーは継続して機能します。読み込み警告は期待される実行の損失として扱い、本番ログでアラートを設定してください。明示的・規約・クラウド管理のポリシーを通じてグローバルに一意な名前を使用してください。ポリシー関数は決定論的に保ち、外部呼び出しには短いタイムアウトを設定し、すべてのパスで意図的な allow、instruct、または deny を返すようにしてください。

カスタムポリシーは実行コードです。期待されるマッチだけでなく、フィールドの欠如、代替ツール名、不正な入力についてもテストしてください。

​クラウド公開前にポリシーをテストする

​失敗パスのテスト

クラウド公開前にポリシーをテストする

失敗パスのテスト