Enum TixError 

pub enum TixError {
    Io(Error),
    Workflow(WorkflowDiagnostic),
    Config(String),
    Parse(String),
    NotFound(String),
    InvalidInput(String),
    Editor(String),
    External(String),
    Kitty(String),
}

Typed errors raised by tix.

Variants

Io(Error)

An I/O operation failed (read/write/rename/remove).

Workflow(WorkflowDiagnostic)

The transition service refused a status change (contract §3.5).

WP03. Carries the diagnostic, not a pre-formatted string, so the named kind reaches the surface intact: the CLI, the TUI, MCP and lint all report one condition under one name (contract §6). A refusal that arrives as a bare InvalidInput would be indistinguishable from a typo caught by argument parsing, and the caller could not tell “you asked for a column that does not exist” from “that move is against policy”.

Reaching this variant is itself the contract: nothing was written — no issue file, no tix.toml, no History entry. The seam guarantees it.

Config(String)

tix.toml or other config surface is invalid.

Parse(String)

A data file (issue frontmatter, config) could not be parsed.

NotFound(String)

The requested issue/config path does not exist.

InvalidInput(String)

User input failed validation.

Editor(String)

Launching or interacting with the $EDITOR failed.

External(String)

An external tool (glab, linear-cli, …) failed.

Kitty(String)

Spec Kitty bridge error (kitty-specs/ read, parse, or link).

Implementations

impl TixError

pub fn with_path(self, path: impl Display) -> Self

Wrap an error with a path prefix for context.

Trait Implementations

impl Debug for TixError

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

Formats the value using the given formatter.

impl Display for TixError

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

Formats the value using the given formatter.

impl Error for TixError

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 From<Error> for TixError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<HierarchyError> for TixError

A hierarchy refusal becomes user input error, so ? works at the call site.

The conversion is total and lossless: the type’s own Display already renders the full diagnostic set, and InvalidInput supplies the invalid input: prefix every other validation failure in the crate carries.

fn from(err: HierarchyError) -> TixError

Converts to this type from the input type.

impl From<Refusal> for TixError

fn from(refusal: Refusal) -> Self

Refusals reach surfaces that take the crate’s error type as invalid input, the variant WP01 and WP02 already use for triage validation failures — no new variant, and no new name in crate::workflow::DiagnosticKind, whose ALL stays at seven.