//! Ahead-of-time compilation (`ruby --build`).
//!
//! Today this precompiles the script to fusevm bytecode and warms the on-disk
//! cache (`cache.rs`), so subsequent runs skip lex/parse/lower entirely. The
//! `fusevm` crate's `aot` feature (a native-object emitter linked against the
//! rubylang `staticlib`) is the next wave — emitting a standalone executable — and
//! the `staticlib` crate-type + feature are wired now so that lands without a
//! build-graph change. The report below is explicit user-requested output.
/// Precompile `file` and store its bytecode in the cache. Returns a one-line
/// report of what was built.