Struct ErrorPanel 

pub struct ErrorPanel {
    pub code: String,
    pub title: String,
    pub message: Option<String>,
    pub severity: ErrorSeverity,
    pub context: Vec<ErrorContext>,
    pub suggestions: Vec<String>,
    pub caused_by: Vec<CausedBy>,
    pub stack_trace: Option<String>,
    pub timestamp: DateTime<Utc>,
    pub truncated: bool,
}

ErrorPanel - The base error display component for RCH.

Provides consistent, actionable error messages with:

• Error code and title
• Main message
• Context key-value pairs
• Remediation suggestions
• Error chaining support
• Timestamp for debugging

Fields

code: String

Error code in RCH-Exxx format.

title: String

Short error title (e.g., “Worker Connection Failed”).

message: Option<String>

Main error message with details.

severity: ErrorSeverity

Error severity level.

context: Vec<ErrorContext>

Context key-value pairs (e.g., Host, Timeout).

suggestions: Vec<String>

Remediation suggestions (numbered list).

caused_by: Vec<CausedBy>

Error chain (caused by).

stack_trace: Option<String>

Stack trace (usually collapsed/hidden).

timestamp: DateTime<Utc>

Timestamp when the error occurred.

truncated: bool

Whether the message was truncated (show –verbose hint).

Implementations

impl ErrorPanel

pub fn new(code: impl Into<String>, title: impl Into<String>) -> Self

Create a new ErrorPanel with code and title.

Arguments

• code - Error code (e.g., “RCH-E042”)
• title - Short error title (e.g., “Worker Connection Failed”)

pub fn error(code: impl Into<String>, title: impl Into<String>) -> Self

Create an error-level ErrorPanel (red, cross icon).

pub fn warning(code: impl Into<String>, title: impl Into<String>) -> Self

Create a warning-level ErrorPanel (amber, warning icon).

pub fn info(code: impl Into<String>, title: impl Into<String>) -> Self

Create an info-level ErrorPanel (blue, info icon).

pub fn with_severity(self, severity: ErrorSeverity) -> Self

Set the severity level.

pub fn message(self, message: impl Into<String>) -> Self

Set the main error message.

pub fn message_truncated( self, message: impl Into<String>, max_len: usize, ) -> Self

Set the main error message, truncating if too long.

If the message exceeds max_len characters, it will be truncated and truncated will be set to true (shows –verbose hint).

pub fn context(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add a context key-value pair.

pub fn suggestion(self, suggestion: impl Into<String>) -> Self

Add a remediation suggestion.

pub fn suggestions<I, S>(self, suggestions: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add multiple suggestions at once.

pub fn caused_by(self, message: impl Into<String>, code: Option<String>) -> Self

Add a caused-by error (for error chaining).

pub fn stack_trace(self, trace: impl Into<String>) -> Self

Add a stack trace (shown in verbose mode or dim).

pub fn with_timestamp(self, timestamp: DateTime<Utc>) -> Self

Set the timestamp explicitly.

pub fn render(&self, ctx: OutputContext)

Render the error panel to stderr.

Automatically selects rich or plain output based on context.

pub fn to_json(&self) -> Result<String>

Serialize to JSON string.

Use this for –json mode output.

pub fn to_json_compact(&self) -> Result<String>

Serialize to compact JSON string.

Trait Implementations

impl Clone for ErrorPanel

fn clone(&self) -> ErrorPanel

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorPanel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorPanel

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorPanel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ErrorPanel

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl Serialize for ErrorPanel

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.