SOP ファンイン: Filesystem
Filesystem の変更により SOP の実行を開始できます。ウォッチャーは再帰的な notify ウォッチャーで 1 つ以上のパスを監視し、各変更をデバウンスしてセトルし、変更ごとに SOP イベントを構築してエンジンにディスパッチします。このパスは channel-filesystem ビルドフィーチャーでゲートされます (デフォルトでオン)。
トランスポート側（監視対象パス、include および exclude のグロブ、broad-root および symlink の安全性）は Filesystem channel で設定します。このページではトリガーについて説明します。
トリガー
Filesystem の変更。Live: ファイルシステムウォッチャーによって配信されます。
| フィールド | 型 | default | 意味 |
|---|---|---|---|
condition | string? | null | 変更ペイロードに対して評価されるオプションの式。 |
events | created | modified | deleted | renamed[] | [] | 一致させる種類を変更します。空の場合はすべての種類に一致します。 |
path* | string | — | パスグロブ (*, **, ?); 裸のディレクトリはその下のすべてにマッチします。 |
SOP を読み込んで検証する:
定義
Syntax の説明に従い、filesystem トリガーを付けて SOP を作成します。上記のトリガーフィールドがサポートされているキーです。ページはファイル全体を走査します。
検証
zeroclaw sop validate
検査
zeroclaw sop list
zeroclaw sop show <name>
マッチング
path はグロブパターン（*、**、?）をサポートしており、ディレクトリのみを指定した場合はその配下の任意の変更に一致します。オプションの events リストは変更種別で絞り込みを行い、空のリストはすべての種別に一致します。各変更は構造化されたペイロードに展開され、オプションのトリガー condition がそれに対して評価され、一致した実行はステップコンテキストでそれを参照できます。
実行する
SOPが読み込まれ、ファイルシステムチャネルがパスを監視している状態で、そのパスに書き込むことで監視対象が配信する変更を発生させます。監視対象のルート内でファイルの作成、変更、リネーム、または削除を行います。ウォッチャーは変更をデバウンスして安定させてから、それをディスパッチします。読み込まれたすべてのSOPのうち、そのpathグロブとeventsフィルターが一致し、かつ（存在する場合は）conditionが変更ペイロードに対して成立するものについて、実行が開始されます。
何も開始されない場合は、パスが監視対象のルート内にあること（glob によって除外されておらず、シンボリックリンクや broad-root セーフティによって拒否もされていないこと）、変更の種類が events に含まれていること、および condition が一致していることを確認してください。fan-in の概要のトラブルシューティング表を参照してください。
承認して観察する
チェックポイントに到達した実行は WaitingApproval として一時停止します。CLI（zeroclaw sop list、zeroclaw sop approve）またはゲートウェイAPIの承認エンドポイント（GET /admin/sop/pending、POST /admin/sop/approve、POST /admin/sop/deny）を介した帯域外操作で、これらをクリアまたは確認できます。
関連項目も参照してください
- Filesystem チャネル: 監視対象パス、glob、シンボリックリンクの安全性
- ファンイン概要
- 構文：SOP ファイル形式