Function collect_md_files 

fn collect_md_files(dir: &Path, recursive: bool) -> Result<Vec<PathBuf>>

Walk dir for .md files, honouring .gitignore rules (via the ignore crate). Returns paths in a stable, sorted order so output is reproducible.

When recursive is false only the top level of dir is visited (max_depth = 1).