Watching

Workflow and current contract

FSWatcher exposes filesystem events through its declared receive API. OS file notifications may be coalesced, reordered, or interrupted; process the concrete WatchEvent variant and error/closure behavior rather than expecting exactly one event per write.

Keep this watcher distinct from the separate weave-agentfs-watch package, which declares batch/configuration types but has current lifecycle and unbounded-buffering limitations. Watching observes local changes; it does not synchronize a remote Locus or grant file permissions.

Source reference

• watcher declarations — local/agentfs/src/watcher.rs.