Enum WorkflowError 

pub enum WorkflowError {
    InvalidConfig {
        reason: String,
    },
    SchemaMismatch {
        reason: String,
    },
    MissingDependency {
        reason: String,
    },
    IntegrationFailed {
        reason: String,
    },
    FormulaDsl {
        context: &'static str,
        source: FormulaDslError,
    },
    ColumnNotFound {
        name: String,
        role: Option<String>,
        available: Vec<String>,
        similar: Vec<String>,
        tsv_hint: bool,
    },
}

Typed error category for the solver::fit_orchestration materialization and fitting pipeline.

Every variant’s Display impl is byte-equivalent to the original format!(...)/.to_string() text the module emitted before the typed migration. The category split lets internal callers reason about the failure kind without parsing strings; public entry points keep their Result<_, String> signatures and rely on From<WorkflowError> for String at the boundary.

Variants

InvalidConfig

Fit configuration is internally inconsistent or selects an unsupported combination (conflicting family/link, unsupported linkwiggle(...)/link(...) placement, frailty requested for a family that does not implement it, duplicate or out-of-range hyperpriors, etc.).

Fields

reason: String

SchemaMismatch

Saved-model or runtime block dimensions disagree with what the rebuilt designs / penalties expect (initial beta length, penalty block shape vs range width, time-basis column count, response support mismatch).

Fields

reason: String

MissingDependency

A required input column, frailty parameter, baseline target, or cause count is missing for the requested mode (e.g. cause-specific fit with one cause, latent-cloglog without a fixed sigma).

Fields

reason: String

IntegrationFailed

An underlying numerical step (PIRLS / smoothing-parameter optimizer / profile-cost evaluation) failed to converge or produced a non-finite value that downstream code cannot consume.

Fields

reason: String

FormulaDsl

Formula parsing / term-resolution failed before materialization; the source retains the parser-layer category and argument context.

Fields

context: &'static str

source: FormulaDslError

ColumnNotFound

A formula referenced a column that does not exist in the input data. Carries the structured payload through to the FFI boundary so the Python side can raise gamfit.ColumnNotFoundError with column, role, available, similar, and tsv_hint attributes — issue #305 / #343 (typed-dispatch migration; no string classification at the boundary).

Fields

name: String

role: Option<String>

available: Vec<String>

similar: Vec<String>

tsv_hint: bool

Trait Implementations

impl Clone for WorkflowError

fn clone(&self) -> WorkflowError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowError

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

Formats the value using the given formatter.

impl Display for WorkflowError

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

Formats the value using the given formatter.

impl Error for WorkflowError

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<&str> for WorkflowError

fn from(reason: &str) -> Self

Converts to this type from the input type.

impl From<DataError> for WorkflowError

Typed lift from leaf data-layer errors. DataError::ColumnNotFound is the variant of immediate interest — it preserves the structured fields so gam-pyffi can dispatch to ColumnNotFoundError without parsing human text. Other DataError variants degrade to the appropriate workflow bucket (SchemaMismatch for row/column shape problems, InvalidConfig for parse / encoding / empty / invalid-value sources) since they don’t have a dedicated structured destination yet.

fn from(err: DataError) -> Self

Converts to this type from the input type.

impl From<FormulaDslError> for WorkflowError

Cross-module cascade: a FormulaDslError raised inside materialize / fit_from_formula (via parse_formula, parse_surv_response, etc.) flows up with its parser-layer source attached instead of stringifying into a generic workflow configuration bucket.

fn from(err: FormulaDslError) -> Self

Converts to this type from the input type.

impl From<String> for WorkflowError

Catchall lift for legacy Result<_, String> chains that flow into a WorkflowError-returning function via ?. Maps to InvalidConfig since the upstream call sites that still hand out bare strings are configuration / setup helpers (FitConfig parsing, payload assembly, etc.) that pre-date the typed-error migration. Specific leaves that carry structured payload (DataError, FormulaDslError, EstimationError, …) have their own dedicated From impls and bypass this fallback.

fn from(reason: String) -> Self

Converts to this type from the input type.

impl From<TermBuilderError> for WorkflowError

Typed lift from term-builder errors. TermBuilderError::ColumnNotFound preserves the structured fields (name, role, available, similar, tsv_hint) through to the FFI boundary so gam-pyffi can raise a gamfit.ColumnNotFoundError with attributes set from the payload — not from re-parsed prose. Other variants degrade into the closest generic workflow bucket; the dedicated typed channels for those failure classes can be added incrementally as their dispatch arrives.

fn from(err: TermBuilderError) -> Self

Converts to this type from the input type.

impl From<WorkflowError> for String

fn from(err: WorkflowError) -> String

Converts to this type from the input type.