pub fn run(args: CliArgs) -> Result<()>
Main entry point for the application.
Parses CLI arguments, initializes state, and dispatches to command handlers.