SOP Fan-In: Filesystem
Los cambios en Filesystem pueden iniciar ejecuciones de SOP. El monitor supervisa una o más rutas con un observador recursivo de notify, agrupa y estabiliza cada cambio, construye un evento de SOP por cambio y lo envía al motor. Esta ruta está condicionada por la característica de compilación channel-filesystem (activada de forma predeterminada).
El lado de transporte (rutas vigiladas, globos de inclusión y exclusión, seguridad de raíz amplia y de enlaces simbólicos) se configura en el Filesystem channel. Esta página cubre el activador.
Activador
Cambio en Filesystem. En vivo: entregado por el monitor de Filesystem.
| campo | tipo | predeterminado | significado |
|---|---|---|---|
condition | string? | null | Expresión opcional evaluada contra la carga útil del cambio. |
events | created | modified | deleted | renamed[] | [] | Cambia los tipos para que coincidan; vacío coincide con cualquier tipo. |
path* | cadena | — | Globo de rutas (*, **, ?); un directorio sin especificar coincide con cualquier cosa dentro de él. |
Cargar y verificar el SOP:
Definir
Author the SOP as described in Syntax, con un trigger filesystem. Los campos del trigger arriba son las claves compatibles; la página recorre el archivo completo.
Validar
zeroclaw sop validate
Inspeccionar
zeroclaw sop list
zeroclaw sop show <name>
Coincidencia
El path admite patrones glob (*, **, ?); un directorio sin más coincide con cualquier cambio en él o por debajo de él. La lista opcional events limita por tipo de cambio; una lista vacía coincide con todos los tipos. Cada cambio se convierte en una carga útil estructurada contra la que se evalúa una condition de disparador opcional y que la ejecución coincidente ve en el contexto del paso.
Dispararlo
Con un SOP cargado y el canal del sistema de archivos vigilando una ruta, escribe en esa ruta para producir un cambio que el observador entregue: crear, modificar, renombrar o eliminar un archivo dentro de una raíz vigilada. El observador aplica debounce y consolida el cambio, y luego lo despacha. Se inicia una ejecución para cada SOP cargado cuyo glob de path y filtro de events coincidan, y cuyo condition (si lo hay) se cumpla frente al payload del cambio.
Si nada se inicia, confirma que la ruta está dentro de una raíz vigilada (no excluida por un glob ni rechazada por un symlink o por la seguridad de raíz amplia), que el tipo de cambio está en events, y que condition coincide. Consulta la tabla de resolución de problemas de la vista general de fan-in.
Aprueba y observa
Las ejecuciones que alcanzan un punto de control se pausan como WaitingApproval. Límpialas o inspecciónalas con la CLI (zeroclaw sop list, zeroclaw sop approve) o fuera de banda mediante los endpoints de aprobación de la gateway API (GET /admin/sop/pending, POST /admin/sop/approve, POST /admin/sop/deny).
Ver también
- Filesystem channel: rutas observadas, globs, seguridad de symlinks
- Descripción general de fan-in
- Sintaxis: el formato de archivo SOP