Function compile 

pub fn compile(
    files: Vec<RawRuleFile>,
    mw_meta: &dyn MiddlewareMetadataProvider,
    fetch_meta: &dyn FetchMetadataProvider,
) -> Result<Arc<SymbolicFlowGraph>, Error>

Facade for the core compile pipeline.

Runs merge → expand → analyze → lower → validate and returns an Arc<SymbolicFlowGraph> ready for vane-engine::FlowGraph::link.

Errors

Returns Error::compile on duplicate rule names, unknown middleware or fetch names referenced by rules, bad ListenSpec strings, predicate type mismatches, or graph-level validation failures (dangling IDs, cycles, phase mismatches).