Struct ConfigFileWatcher 

pub struct ConfigFileWatcher { /* private fields */ }

Watches the config file for changes using OS-native file notifications.

Spawns a background thread on construction. When a change is detected, sets an internal flag that the main loop can consume via poll.

Consumers:

• TUI: poll() in the main event loop to trigger hot-reload.
• Dashboard API (future): poll() in a loop to emit ConfigChanged SSE.

Implementations

impl ConfigFileWatcher

pub fn new(config_path: &Path) -> Self

Start watching config_path. Returns a watcher handle.

If the OS file watcher fails to initialise (e.g. sandbox restrictions), the watcher is silently disabled — poll() will always return false.

pub fn poll(&self) -> bool

Check (and consume) the config-changed flag.