Enum TixError 

pub enum TixError {
    Io(Error),
    Workflow(WorkflowDiagnostic),
    Config(String),
    Parse(String),
    NotFound(String),
    InvalidInput(String),
    Refused(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.

Refused(String)

A validation refusal whose findings are already a rendered block.

render_diagnostics renders the service’s findings through crate::diagnostics, so by the time they reach an error they are a rustc-style block, not a bare message. Wrapping that in the invalid input: prefix would put a second, non-rustc prefix in front of a rustc block — so this variant prints its payload verbatim (#[error("{0}")]), and render_error returns it unchanged.

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 diagnostic_id(&self) -> &'static str

The stable rendering id for this error, used by render_error.

One id per variant, so the CLI, MCP, and the TUI all bracket the same condition with the same name. Refused has no id of its own — its payload already carries one.

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<EpicError> for TixError

An epic refusal becomes user input error, so ? works at the call site.

The payload is a single-line diagnostic (<kind>: <message>), so it takes the crate’s existing invalid input: prefix without doubling it — the same boundary every other selector/validation refusal crosses (cli-surface §6).

fn from(err: EpicError) -> TixError

Converts to this type from the input type.

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<ProjectError> for TixError

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

The payload is a single-line diagnostic (<kind>: <message>), so it takes the crate’s existing invalid input: prefix without doubling it — the same boundary every other selector/validation refusal crosses (cli-surface §6).

fn from(err: ProjectError) -> TixError

Converts to this type from the input type.

impl From<Refusal> for TixError

fn from(refusal: Refusal) -> Self

A refusal becomes a rendered block: the one place a refusal is turned into something a surface prints, so its rustc-style header is produced exactly once, here, rather than by every caller that happens to to_string() it.

impl From<RuleError> for TixError

A rule refusal becomes a rendered error at the surface, like every other validation refusal (crate::error::TixError::Refused).

fn from(err: RuleError) -> TixError

Converts to this type from the input type.

impl From<TimeMutationError> for TixError

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

<kind>: <message> is already a single-line diagnostic, so it takes the crate’s existing invalid input: prefix without doubling it — the same boundary crate::projects::ProjectError crosses.

fn from(err: TimeMutationError) -> TixError

Converts to this type from the input type.

impl From<TixError> for TemplateWriteError

fn from(error: TixError) -> Self

A bare error from the registry is a refusal by default: the registry’s failures are all validation, and the save path maps its own error to TemplateWriteError::Failed explicitly.

impl From<TixError> for ViewWriteError

fn from(error: TixError) -> Self

Converts to this type from the input type.