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 → 分发 → 回写 IoResponseauditor— 基于 FactsLog 的审计链hash— BLAKE3 哈希clock— 逻辑时钟session— 会话管理器(机制层,管理反应器实例生命周期)rule_validation— 规则 JSON Schema 验证器(tier0 core_eval.json)time_machine— 时间机器:replay / rewind / fork / diffshared_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 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;
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 分发器(机制层)
- IoDispatcher
Builder - I/O 分发器 builder(链式注册)
Traits§
- IoHandler
- I/O Handler trait —— 所有 I/O handler 实现此接口
Functions§
- content_
hash - 重导出 tier1 的哈希算法(单一真相源)
Type Aliases§
- IoResult
- I/O 执行结果