Enum GraphBuilderError 

pub enum GraphBuilderError {
    ParseError {
        span: Span,
        reason: String,
    },
    UnsupportedConstruct {
        construct: String,
        span: Span,
    },
    SymbolResolutionError {
        symbol: String,
        file: PathBuf,
    },
    CrossLanguageError {
        reason: String,
    },
    IoError {
        file: PathBuf,
        source: Error,
    },
    BuildTimedOut {
        file: PathBuf,
        phase: &'static str,
        timeout_ms: u64,
    },
    Internal {
        reason: String,
    },
    Cancelled,
}

Errors that can occur while constructing the unified code graph.

Variants

ParseError

Tree-sitter failed to parse a construct that the builder expected.

Fields

span: Span

Source span for the problematic node.

reason: String

Human readable error message.

UnsupportedConstruct

The builder encountered a language feature that is currently unsupported.

Fields

construct: String

Description of the unsupported construct (e.g., “async generator”).

span: Span

Span for the construct.

SymbolResolutionError

A symbol reference could not be resolved to a known definition.

Fields

symbol: String

Node that the builder attempted to resolve.

file: PathBuf

File where resolution failed.

CrossLanguageError

Building a cross-language edge failed validation (e.g. inconsistent metadata).

Fields

reason: String

Why the edge construction failed.

IoError

An IO failure occurred while reading source input.

Fields

file: PathBuf

File being read when the failure occurred.

source: Error

Underlying IO error.

BuildTimedOut

Graph building exceeded its per-file time budget.

Fields

file: PathBuf

File being built when the timeout was reached.

phase: &'static str

The build phase in progress when the timeout fired.

timeout_ms: u64

Timeout budget in milliseconds.

Internal

Internal invariant violation or propagated error from a subsystem that does not fit one of the more specific variants above.

Used when bridging between error models — e.g., when the incremental rebuild engine surfaces a failure from the full-build pipeline (anyhow::Result<CodeGraph> → GraphResult<CodeGraph>) or when an internal precondition is violated.

Fields

reason: String

Human-readable description of the failure.

Cancelled

Graph build was cancelled cooperatively via a CancellationToken.

The incremental rebuild engine polls the shared cancellation flag at every pass boundary. When the flag is set, the pass returns this variant immediately — the partially-built graph is discarded and no publish_graph boundary is crossed.

This variant is a cooperative signal, not a fault: the daemon’s rebuild dispatcher treats Cancelled as a normal outcome whenever a later rebuild supersedes an in-flight one. Callers that expect side-effect-free cancellation should special-case this variant and skip error logging.

Trait Implementations

impl Debug for GraphBuilderError

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

Formats the value using the given formatter.

impl Display for GraphBuilderError

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

Formats the value using the given formatter.

impl Error for GraphBuilderError

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.