Struct StructuredError 

pub struct StructuredError {
    pub code: ErrorCode,
    pub message: String,
    pub hint: Option<String>,
    pub retryable: bool,
    pub context: Option<Value>,
}

Structured error for machine-parseable output.

Provides AI coding agents with:

• Machine-readable error code
• Human-readable message
• Context-aware hint for self-correction
• Retryability flag
• Structured context data

Fields

code: ErrorCode

Machine-readable error code

message: String

Human-readable error message

hint: Option<String>

Optional hint for fixing the error

retryable: bool

Whether the operation can be retried

context: Option<Value>

Additional context data

Implementations

impl StructuredError

pub fn from_error(err: &BeadsError) -> Self

Create a new structured error from a BeadsError.

pub fn issue_not_found(searched_id: &str, existing_ids: &[String]) -> Self

Create a structured error with similar ID suggestions.

pub fn ambiguous_id(partial: &str, matches: &[String]) -> Self

Create a structured error for ambiguous ID.

pub fn cycle_detected(cycle_path: &str) -> Self

Create a structured error for cycle detection.

pub fn not_initialized() -> Self

Create a structured error for not initialized.

pub fn invalid_priority(provided: &str) -> Self

Create a structured error for invalid priority.

pub fn invalid_status(provided: &str) -> Self

Create a structured error for invalid status.

pub fn invalid_type(provided: &str) -> Self

Create a structured error for invalid issue type.

pub fn to_json(&self) -> Value

Serialize to JSON value.

pub fn to_human(&self, color: bool) -> String

Format for human-readable output.

Trait Implementations

impl Clone for StructuredError

fn clone(&self) -> StructuredError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StructuredError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StructuredError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StructuredError

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

where __S: Serializer,

Serialize this value into the given Serde serializer.