fn_registry/functions/infra/watch_dir_fsnotify.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
watch_dir_fsnotify	function	go	infra	0.1.0	impure	func WatchDirFsnotify(ctx context.Context, root string) (<-chan FsEvent, error)	Crea un watcher recursivo sobre root y todos sus subdirectorios usando fsnotify. Emite FsEvent al canal con debounce de 200ms por path (multiples eventos del mismo archivo en la ventana = un solo evento con la ultima op). Cierra el canal cuando ctx.Done(). Anade automaticamente nuevos subdirectorios creados en runtime.	watcher fsnotify filesystem dev-ux async kanban		fs_event_go_infra	fs_event_go_infra	false	error_go_core	context fmt log os path/filepath time github.com/fsnotify/fsnotify	name desc ctx Context para cancelar el watcher. Al cancelar, el canal se cierra limpiamente. name desc root Directorio raiz a vigilar recursivamente. Debe existir o retorna error.	Canal de solo lectura que emite FsEvent por cada cambio detectado (tras debounce). El canal se cierra cuando ctx se cancela o el watcher interno falla.	true	detecta escritura de archivo canal se cierra cuando ctx cancela error en directorio inexistente debounce agrupa multiples escrituras	functions/infra/watch_dir_fsnotify_test.go	functions/infra/watch_dir_fsnotify.go

Ejemplo

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

ch, err := infra.WatchDirFsnotify(ctx, "$HOME/fn_registry/dev/issues")
if err != nil {
    log.Fatal(err)
}

for ev := range ch {
    fmt.Printf("event: op=%s path=%s\n", ev.Op, ev.Path)
    // recargar el issue afectado en cache
}

Cuando usarla

En el backend de kanban_cpp para detectar cambios externos en dev/issues/ y dev/flows/ (ediciones en el editor de texto del usuario) y propagar via SSE al frontend ImGui. Tambien util para cualquier daemon que necesite invalidar cache ante cambios en disco.

Gotchas

• Debounce por path: si guardas el mismo archivo 5 veces en 200ms (ej. autoguardado del editor), recibes 1 evento, no 5. El Op del evento es el de la ultima operacion en la ventana.
• Subdirectorios dinamicos: si se crea un subdirectorio nuevo mientras el watcher esta activo, se anade automaticamente al watcher. Los archivos creados dentro del nuevo subdir se detectan.
• Eventos CHMOD ignorados: solo se emiten create, write, remove, rename. Cambios de permisos no disparan eventos.
• Canal con buffer 64: si el consumidor es lento y el buffer se llena, eventos adicionales se bloquean en la goroutine interna. Con debounce 200ms es poco probable en uso normal.
• No filtra por extension: emite eventos para cualquier archivo en el arbol, no solo .md. El consumidor debe filtrar si solo le interesan ciertos tipos.
• Linux inotify limit: en sistemas con muchos subdirectorios, puede alcanzar el limite de fs.inotify.max_user_watches (default 8192). Aumentar con sysctl fs.inotify.max_user_watches=65536 si se observan errores en el log.