SOP Fan-In: Filesystem
Les modifications de Filesystem peuvent lancer des exécutions de SOP. Le watcher surveille un ou plusieurs chemins via un watcher notify récursif, applique un debounce et stabilise chaque modification, génère un événement SOP par modification, et le transmet au moteur. Ce chemin est contrôlé par la fonctionnalité de build channel-filesystem (activée par défaut).
Le côté transport (chemins surveillés, globs d’inclusion et d’exclusion, sécurité des racines larges et des liens symboliques) est configuré sur le canal Filesystem. Cette page couvre le déclencheur.
Déclencheur
Filesystem modification. Live : fourni par le surveillant de système de fichiers.
| champ | type | par défaut | sens |
|---|---|---|---|
condition | string? | null | Expression optionnelle évaluée par rapport au payload de modification. |
events | created | modified | deleted | renamed[] | [] | Modifiez les kinds pour qu’ils correspondent ; vide correspond à tous les kinds. |
path* | chaîne | — | Glob de chemin (*, **, ?) ; un répertoire nu correspond à tout ce qui se trouve en dessous. |
Charger et vérifier le SOP :
Définir
Rédigez la SOP tel que décrit dans Syntax, avec un déclencheur filesystem. Les champs du déclencheur ci-dessus correspondent aux clés prises en charge ; la page parcourt le fichier dans son intégralité.
Valider
zeroclaw sop validate
Inspect
zeroclaw sop list
zeroclaw sop show <name>
Correspondance
Le path prend en charge les motifs glob (*, **, ?) ; un simple répertoire correspond à tout changement à son niveau ou en dessous. La liste optionnelle events restreint par type de changement ; une liste vide correspond à tous les types. Chaque changement est transformé en une charge utile structurée contre laquelle une condition de déclenchement optionnelle est évaluée et que l’exécution correspondante voit dans le contexte d’étape.
Exécutez-le
Avec un SOP chargé et le canal filesystem surveillant un chemin, écrivez dans ce chemin pour produire un changement que le watcher délivre : créer, modifier, renommer ou supprimer un fichier à l’intérieur d’une racine surveillée. Le watcher debounce et stabilise le changement, puis le dispatch. Un run démarre pour chaque SOP chargé dont le glob path et le filtre events correspondent, et dont la condition (le cas échéant) est satisfaite par le payload du changement.
Si aucun processus ne démarre, vérifiez que le chemin se trouve dans une racine surveillée (non exclu par un glob ou rejeté par un lien symbolique ou une sécurité de racine large), que le type de modification figure dans events, et que la condition correspond. Consultez le tableau de dépannage de la vue d’ensemble fan-in.
Approuver et observer
Les exécutions qui atteignent un point de contrôle se mettent en pause en tant que WaitingApproval. Effacez-les ou inspectez-les avec le CLI (zeroclaw sop list, zeroclaw sop approve) ou hors bande via les endpoints d’approbation de la gateway API (GET /admin/sop/pending, POST /admin/sop/approve, POST /admin/sop/deny).
Voir aussi
- Filesystem canal: chemins surveillés, globs, sécurité des liens symboliques
- Vue d’ensemble du fan-in
- Syntaxe : le format de fichier SOP