Skip to main content

evorule_governance/
lib.rs

1// SPDX-License-Identifier: AGPL-3.0-or-later
2// Copyright (C) 2026 EvoRule Project
3// This file is part of EvoRule, licensed under GNU Affero General Public License v3 or later.
4//! EvoRule 治理层 - I/O 订阅者、审计链、规则验证、时间机器
5//!
6//! # 定位
7//! evorule-governance 是三层架构的最上层(纯机制层库):
8//! - 订阅 evorule-reactor 的 event broadcast 通道,过滤 `IoRequest` 事实
9//! - 通过 IoDispatcher 框架分发 I/O(具体 Handler 实现由应用层注入,本 crate 仅定义机制)
10//! - 基于 `FactsLog` 构建审计链(BLAKE3 哈希 + 逻辑时钟)
11//! - 提供规则验证器(RuleValidator)+ 时间机器(TimeMachine: replay / rewind / fork / diff)
12//! - 提供 SessionManager:会话管理器(机制层,管理反应器实例生命周期)
13//!
14//! **H5/H6 边界清理后不再包含**:HTTP API、SSE、Prometheus metrics、Bearer 认证、具体 I/O Handler 实现。
15//! 上述应用层功能由应用层自行构建,本 crate 仅提供机制层接口。
16//!
17//! # 设计原则
18//! - **不染指控制流**:治理层完全不知道 `conditional`/`while_loop`/`sequence` 的存在
19//! - **I/O 外挂**:仅定义 IoHandler trait + IoDispatcher 框架(机制),零业务逻辑侵入;具体实现由应用层注入
20//! - **事实总线**:所有组件通过 Fact 通信,无直接函数调用
21//!
22//! # 模块结构
23//! - `io_handler` — IoHandler trait + IoResult(机制定义,应用层注入实现)
24//! - `io_dispatcher` — Enum Dispatch(I/O 分发框架)
25//! - `io_subscriber` — 订阅 IoRequest → 分发 → 回写 IoResponse
26//! - `auditor` — 基于 FactsLog 的审计链
27//! - `hash` — BLAKE3 哈希
28//! - `clock` — 逻辑时钟
29//! - `session` — 会话管理器(机制层,管理反应器实例生命周期)
30//! - `rule_validation` — 规则 JSON Schema 验证器(tier0 core_eval.json)
31//! - `time_machine` — 时间机器:replay / rewind / fork / diff
32//! - `shared_facts_log` — 跨 session 共享 FactsLog 包装
33//! - `metrics` — IoMetrics trait(机制层接口,Prometheus 实现由应用层提供)
34// cluster 已移除(多 reactor 协作原语,应用层功能,后续由应用层实现)
35// api, io_handlers, bin 目录已全部迁出本 crate(H5/H6 边界清理)
36
37#![forbid(unsafe_code)]
38#![deny(missing_docs)]
39
40// H6: api 模块已迁出本 crate(机制-策略分离,核心层不再包含 HTTP API 代码)
41pub mod anchor;
42pub mod auditor;
43pub mod circuit_breaker;
44pub mod clock;
45pub mod hash;
46pub mod io_dispatcher;
47pub mod io_handler;
48// H5: io_handlers 具体实现已外迁(机制-策略分离)
49// 具体 handler 实现(DbHandler/HttpHandler/MemoryHandler)不再属于本 crate
50pub mod io_subscriber;
51pub mod metrics;
52pub mod permission;
53// object_pool 已移除(性能优化,非核心功能)
54pub mod rule_validation;
55// H6: session 模块从 api/ 提升到顶层(机制层,管理反应器实例生命周期)
56pub mod session;
57// G-A1: 审计锚点签名(真实性/防抵赖),可选能力——未配置签名器时审计行为与旧版完全一致
58pub mod shared_facts_log;
59pub mod signing;
60pub mod time_machine;
61
62// 公开 API 重导出
63// H6: AppState/GovernanceApi/GovernanceServer/SessionApi 已迁移到应用层(不再从核心导出)
64pub use auditor::{Auditor, LoadError};
65pub use clock::LogicalClock;
66// cluster 已移除(多 reactor 协作原语,应用层功能)
67pub use hash::content_hash;
68pub use io_dispatcher::{IoDispatcher, IoDispatcherBuilder};
69pub use io_handler::{IoHandler, IoResult};
70pub use io_subscriber::IoSubscriber;
71pub use metrics::{noop_metrics, IoMetrics, NoOpMetrics, SharedMetrics};
72pub use permission::{
73    ConditionEvaluator, DefaultPolicy, PermissionEntry, PermissionError, PermissionGate,
74    PermissionState, PermissionTable, Verdict,
75};
76pub use session::{Session, SessionAnchorConfig, SessionError, SessionId, SessionManager};
77// G-A1: 审计锚点签名(真实性/防抵赖)
78pub use anchor::{
79    signature_payload_v2, verify_anchor_chain, verify_binding, AnchorChainBuilder, AnchorError,
80    AnchorProto, AuditAnchor, FactRange, ANCHOR_FORMAT, ANCHOR_GENESIS,
81};
82pub use signing::{verify_signature, AuditSigner, SignError};
83// ObjectPool 已移除(性能优化,非核心功能)
84pub use shared_facts_log::{SharedFact, SharedFactsLog};