Enum CapError 

#[non_exhaustive]
pub enum CapError {
    NotFound(String),
    ValidationError(String),
    ExecutionError(String),
    PermissionDenied(String),
    ConfirmationRequired,
    NotInitialized,
}

Capability Registry 错误类型。

6 个变体覆盖所有业务错误场景，标注 #[non_exhaustive] 允许未来新增变体不破坏外部 match。

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound(String)

能力未找到（按名称查找不存在）。

ValidationError(String)

参数校验失败（缺少必填字段或类型不匹配）。

ExecutionError(String)

能力执行失败（透传能力内部错误）。

PermissionDenied(String)

权限不足（上层授权中间件拒绝）。

ConfirmationRequired

需要人工确认（HITL 闸门）。

NotInitialized

Registry 未初始化（facade 未调用 init()）。

Trait Implementations

impl Debug for CapError

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

Formats the value using the given formatter.

impl Display for CapError

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

Formats the value using the given formatter.

impl Error for CapError

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.