Enum AgentError

atomic-agent/src/error.rs:40–301

/// Errors that can occur during agent operations.
#[derive(Debug, Error)]
pub enum AgentError {
    // Watchman / File Watcher Errors
    /// Watchman daemon is not running or not installed.
    ///
    /// This is a soft error — the system falls back to the polling-based
    /// `FallbackWatcher` when Watchman is unavailable.
    #[error("Watchman is not running (install from https://facebook.github.io/watchman/ or the fallback watcher will be used)")]
    WatchmanNotRunning,

    /// Failed to connect to the Watchman daemon.
    #[error("Failed to connect to Watchman: {reason}")]
    WatchmanConnectionFailed {
        /// Human-readable reason for the connection failure.
        reason: String,
    },

    /// A Watchman query or command failed.
    #[error("Watchman query failed: {reason}")]
    WatchmanQueryFailed {
        /// Human-readable reason for the query failure.
        reason: String,
    },

    /// Failed to resolve the repository root with Watchman.
    #[error("Watchman failed to resolve watch root for path: {path}")]
    WatchmanResolveRoot {
        /// The path that could not be resolved.
        path: PathBuf,
    },

    // Hook Parsing Errors
    /// Failed to parse JSON input from an agent hook callback.
    #[error("Failed to parse hook input for {agent} ({hook_type}): {reason}")]
    HookParseFailed {
        /// Which agent sent the hook (e.g., "claude-code", "gemini-cli").
        agent: String,
        /// The hook type that failed to parse (e.g., "stop", "user-prompt-submit").
        hook_type: String,
        /// What went wrong during parsing.
        reason: String,
    },

    /// Hook input was empty (stdin had no data).
    #[error("Empty hook input from {agent} for hook type {hook_type}")]
    HookInputEmpty {
        /// Which agent sent the empty input.
        agent: String,
        /// The hook type that received empty input.
        hook_type: String,
    },

    /// A required field was missing from the hook input JSON.
    #[error("Missing required field '{field}' in {agent} hook input for {hook_type}")]
    HookFieldMissing {
        /// Which agent sent the input.
        agent: String,
        /// The hook type.
        hook_type: String,