pub fn format_error_with_guidance(error: &str) -> (String, Option<String>)
Convert a technical error message to a user-friendly message with guidance.
Takes the raw error string and returns a tuple of (short_message, suggestion).