Enum RuleCacheError 

pub enum RuleCacheError {
    Load(Error),
    Poisoned,
}

v0.7.0 #1020 (Agent-1 #6) — typed error for the substrate-public RuleCache::get_or_load surface. Per CLAUDE.md #964 audit-closure rule, substrate-public APIs MUST use typed errors; pre-#1020 get_or_load returned anyhow::Result<Arc<Vec<Rule>>>, leaking the untyped error type across the substrate boundary at a brand-new (#991) API.

Variants:

• RuleCacheError::Load wraps a downstream load failure from crate::governance::rules_store::list_enabled_by_kind. The inner anyhow::Error preserves the rusqlite + context chain for diagnostics; downstream code paths that need the chain call .0 directly or From::<RuleCacheError>::from into their own anyhow surface.
• RuleCacheError::Poisoned surfaces an RwLock poison — previously swallowed with a silent fallback to the freshly-loaded snapshot. Surfacing it lets callers decide whether to refuse, retry, or rebuild the cache.

Variants

Load(Error)

list_enabled_by_kind failed (rusqlite error or downstream signature-verification panic).

Poisoned

The inner RwLock is poisoned (another thread panicked while holding it). The legacy fallback returned the freshly- loaded snapshot; callers can still do so via RuleCacheError::is_poisoned but the typed signal lets observability paths surface the panic.

Implementations

impl RuleCacheError

pub fn is_poisoned(&self) -> bool

Returns true for the RuleCacheError::Poisoned variant. Callers that want the legacy “silent fallback” posture can branch on this to recover the freshly-loaded snapshot from a parallel list_enabled_by_kind call.

Trait Implementations

impl Debug for RuleCacheError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for RuleCacheError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for RuleCacheError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for RuleCacheError

fn from(e: Error) -> Self

Converts to this type from the input type.