fix: CLI error hints for wait combinator failures

- Item 1 (preserve request headers across the 401-retry loop): the sync
  client now delegates entirely to the async client, and the async
  retry loop on this branch already rebuilds the retried request with
  its original headers. Kept branch version.
- Item 7 (clear Windows readonly attr before rewriting the auth cache):
  this branch reworked set_file_permissions to a Unix-only 0o600 path
  with a no-op elsewhere, so no readonly attribute is ever set and the
  clear_readonly helper is moot. Kept branch version.
- Item 33 (safe downcast of the reused ConfirmPopup): this branch
  already replaced the raw-pointer downcast with Component::as_any_mut()
  (as a required method returning &mut dyn Any). Kept branch version.
- Item 39 (variant-specific color_eyre suggestion for WaitTimeout /
  WaitFailed / WaitResourceVanished): applied. Adds
  OpenStackCliError::wait_hint (cli/core/src/error.rs), wired into
  osc.rs so wait errors surface an actionable hint instead of
  ApiError's generic transparent Display.

Signed-off-by: Artem Goncharov <artem.goncharov@gmail.com>

Author: gtema

cli/core/src/error.rs

@@ -216,4 +216,26 @@ impl OpenStackCliError {
             data,
         }
     }
+
+    /// A short, user-facing hint for errors coming from the SDK's
+    /// `wait`/`wait_deleted`/`wait_for_status` combinators, distinguishing
+    /// timeout, failure, and vanished-resource cases instead of leaving
+    /// them as an opaque, generic API error.
+    pub fn wait_hint(&self) -> Option<&'static str> {
+        let Self::OpenStackApi { source } = self else {
+            return None;
+        };
+        match source {
+            openstack_sdk_core::api::ApiError::WaitTimeout { .. } => Some(
+                "the resource may still be transitioning; re-run the command later or check its current status directly",
+            ),
+            openstack_sdk_core::api::ApiError::WaitFailed { .. } => Some(
+                "the resource reported a failure state while waiting for it; inspect it directly for details",
+            ),
+            openstack_sdk_core::api::ApiError::WaitResourceVanished => Some(
+                "the resource disappeared while waiting for it to reach the desired state (it may have been deleted concurrently)",
+            ),
+            _ => None,
+        }
+    }
 }

openstack_cli/src/bin/osc.rs

@@ -22,6 +22,7 @@ use clap_complete::CompleteEnv;
 use color_eyre::eyre::{Report, Result};
 use color_eyre::owo_colors::OwoColorize;
 use color_eyre::section::PanicMessage;
+use color_eyre::Help;
 use std::env;
 use std::fmt;
 
@@ -37,7 +38,14 @@ async fn main() -> Result<(), Report> {
             return Ok(());
         }
         Ok(false) | Err(_) => {
-            openstack_cli::entry_point().await?;
+            if let Err(e) = openstack_cli::entry_point().await {
+                let hint = e.wait_hint();
+                let report: Report = e.into();
+                return Err(match hint {
+                    Some(hint) => report.suggestion(hint),
+                    None => report,
+                });
+            }
         }
     }