Skip to main content

Crate evorule_governance

Crate evorule_governance 

Source
Expand description

EvoRule 治理层 - I/O 订阅者、审计链、规则验证、时间机器

§定位

evorule-governance 是三层架构的最上层(纯机制层库):

  • 订阅 evorule-reactor 的 event broadcast 通道,过滤 IoRequest 事实
  • 通过 IoDispatcher 框架分发 I/O(具体 Handler 实现由应用层注入,本 crate 仅定义机制)
  • 基于 FactsLog 构建审计链(BLAKE3 哈希 + 逻辑时钟)
  • 提供规则验证器(RuleValidator)+ 时间机器(TimeMachine: replay / rewind / fork / diff)
  • 提供 SessionManager:会话管理器(机制层,管理反应器实例生命周期)

H5/H6 边界清理后不再包含:HTTP API、SSE、Prometheus metrics、Bearer 认证、具体 I/O Handler 实现。 上述应用层功能由应用层自行构建,本 crate 仅提供机制层接口。

§设计原则

  • 不染指控制流:治理层完全不知道 conditional/while_loop/sequence 的存在
  • I/O 外挂:仅定义 IoHandler trait + IoDispatcher 框架(机制),零业务逻辑侵入;具体实现由应用层注入
  • 事实总线:所有组件通过 Fact 通信,无直接函数调用

§模块结构

  • io_handler — IoHandler trait + IoResult(机制定义,应用层注入实现)
  • io_dispatcher — Enum Dispatch(I/O 分发框架)
  • io_subscriber — 订阅 IoRequest → 分发 → 回写 IoResponse
  • auditor — 基于 FactsLog 的审计链
  • hash — BLAKE3 哈希
  • clock — 逻辑时钟
  • session — 会话管理器(机制层,管理反应器实例生命周期)
  • rule_validation — 规则 JSON Schema 验证器(tier0 core_eval.json)
  • time_machine — 时间机器:replay / rewind / fork / diff
  • shared_facts_log — 跨 session 共享 FactsLog 包装
  • metrics — IoMetrics trait(机制层接口,Prometheus 实现由应用层提供)

Re-exports§

pub use auditor::Auditor;
pub use auditor::LoadError;
pub use clock::LogicalClock;
pub use io_subscriber::IoSubscriber;
pub use metrics::noop_metrics;
pub use metrics::IoMetrics;
pub use metrics::NoOpMetrics;
pub use metrics::SharedMetrics;
pub use permission::ConditionEvaluator;
pub use permission::DefaultPolicy;
pub use permission::PermissionEntry;
pub use permission::PermissionError;
pub use permission::PermissionGate;
pub use permission::PermissionState;
pub use permission::PermissionTable;
pub use permission::Verdict;
pub use session::Session;
pub use session::SessionAnchorConfig;
pub use session::SessionError;
pub use session::SessionId;
pub use session::SessionManager;
pub use anchor::signature_payload_v2;
pub use anchor::verify_anchor_chain;
pub use anchor::verify_binding;
pub use anchor::AnchorChainBuilder;
pub use anchor::AnchorError;
pub use anchor::AnchorProto;
pub use anchor::AuditAnchor;
pub use anchor::FactRange;
pub use anchor::ANCHOR_FORMAT;
pub use anchor::ANCHOR_GENESIS;
pub use signing::verify_signature;
pub use signing::AuditSigner;
pub use signing::SignError;
pub use shared_facts_log::SharedFact;
pub use shared_facts_log::SharedFactsLog;

Modules§

anchor
审计锚点链(G-A2:抗整链重算/替换/截断/fork 伪造)
auditor
审计器 - 基于 FactsLog 构建审计链
circuit_breaker
会话级熔断器(SG-3,family-②「白名单外锚点连发」)
clock
逻辑时钟(Lamport Clock)
hash
内容哈希工具(BLAKE3)—— re-export tier1 单一真相源
io_dispatcher
I/O Dispatcher —— v0.2.0 已下沉到 evorule-reactor
io_handler
IoHandler trait —— H5 已下沉到 evorule-reactor
io_subscriber
I/O 订阅者 - 订阅 event broadcast 通道,过滤 IoRequest 事实,执行 I/O,回写 IoResponse
metrics
I/O 指标收集接口(机制层 trait 定义)
permission
权限子系统 —— 机制层数据模型、版本化快照与条件评估
rule_validation
规则校验 API —— 静态验证 + 安全分析
session
会话管理器 - 多反应器实例隔离
shared_facts_log
跨会话共享事实存储
signing
审计锚点签名(G-A1:真实性 / 防抵赖)
time_machine
时间机器模块 —— 提供 rewind/diff 核心能力

Structs§

IoDispatcher
I/O 分发器(机制层)
IoDispatcherBuilder
I/O 分发器 builder(链式注册)

Traits§

IoHandler
I/O Handler trait —— 所有 I/O handler 实现此接口

Functions§

content_hash
重导出 tier1 的哈希算法(单一真相源)

Type Aliases§

IoResult
I/O 执行结果