lellm_graph/compiler/mod.rs
1//! Compiler — 图优化 pass 框架。
2//!
3//! 提供 CompilerPass trait 和优化上下文，用于在编译阶段对图进行优化。
4//!
5//! # 设计理念
6//!
7//! ```text
8//! 用户 API：
9//! builder.build() → Graph（不触发优化）
10//! builder.compile() → Graph（触发优化）
11//!
12//! 编译器内部流程：
13//! 1. 分析 SubgraphNode
14//! 2. 评估是否值得内联
15//! 3. 如果值得：展开 Subgraph，合并到外层 Graph
16//! 4. 如果不值得：保持 Subgraph，运行时递归执行
17//! ```
18
19pub mod context;
20pub mod inline_pass;
21pub mod pass;
22
23pub use context::CompilerContext;
24pub use inline_pass::InlinePass;
25pub use pass::CompilerPass;