Function materialize_source 

pub fn materialize_source(db: &FactsDb, opts: &Options) -> Result<()>

Unified source-table materialiser that honours BOTH --time-bucket AND --use-canonical-lineage. Call this once at the top of an analysis; follow up with source_table for the FROM clause.

Composition: when both flags are set, the lineage view is materialised first and bucketing happens on top, so rename ancestry survives the temporal collapse.

Errors

Returns crate::CodeLoreError::Analysis on materialise failure.