Enum CliError 

pub enum CliError {
    Io(Error),
    Json(Error),
    Wal(WalError),
    RulesDirNotFound(String),
    NoRulesFound(String),
    InvalidPayload(String),
    FactLogParse {
        line: usize,
        reason: String,
    },
    HashChain(String),
    ExecutionHadErrors {
        count: usize,
    },
    Other(String),
}

CLI 错误

设计原则：

• 每个变体携带足够上下文（路径、行号、原因），便于用户定位问题
• #[from] 自动转换 std::io::Error / serde_json::Error / WalError
• Display 输出人类可读的中文/英文混合消息（与现有 CLI 风格一致）

Variants

Io(Error)

文件系统 I/O 错误

Json(Error)

JSON 序列化/反序列化错误

Wal(WalError)

tier1 WAL 序列化错误（fact_from_json 失败等）

RulesDirNotFound(String)

规则目录不存在

NoRulesFound(String)

规则目录中无 .json 文件

InvalidPayload(String)

初始 payload JSON 解析失败

FactLogParse

fact log 解析错误（指定行号和原因）

Fields

line: usize

出错的行号（1-based）

reason: String

错误原因

HashChain(String)

哈希链验证失败

ExecutionHadErrors

执行完成但产生 Error 事实（规则执行失败）

CR-20260902-001（UV-046 C1/C3）：执行含 Error fact 时不再返回退出码 0。 CI/自动化管道以退出码判定成败，Error fact 静默成功会让“确定性执行“ 的核心承诺在自动化场景下失效。fact log 仍正常写出供审计。

Fields

count: usize

Error 事实数量

Other(String)

通用错误（兜底）

Implementations

impl CliError

pub fn other(msg: impl Into<String>) -> Self

从任意字符串创建通用错误

示例

use evorule_cli::CliError;

let err = CliError::other("something went wrong");
assert_eq!(err.to_string(), "something went wrong");

impl CliError

退出码映射

约定：

• 0：成功
• 1：通用错误（默认）
• 2：规则加载错误（目录不存在、无 .json）
• 3：执行完成但产生 Error 事实（CR-20260902-001：不再静默成功）

pub fn exit_code(&self) -> i32

返回该错误对应的退出码

约定

• 0：成功
• 1：通用错误（默认）
• 2：规则加载错误（目录不存在、无 .json）
• 3：执行完成但产生 Error 事实（CR-20260902-001）

示例

use evorule_cli::CliError;

// 规则目录缺失 → 退出码 2
let dir_err = CliError::RulesDirNotFound("/nonexistent".into());
assert_eq!(dir_err.exit_code(), 2);

// 执行含 Error fact → 退出码 3
let exec_err = CliError::ExecutionHadErrors { count: 1 };
assert_eq!(exec_err.exit_code(), 3);

// 通用错误 → 退出码 1
assert_eq!(CliError::other("boom").exit_code(), 1);

Trait Implementations

impl Debug for CliError

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

Formats the value using the given formatter.

impl Display for CliError

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

Formats the value using the given formatter.

impl Error for CliError

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 CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<WalError> for CliError

fn from(source: WalError) -> Self

Converts to this type from the input type.