ruvector-graph-transformer 2.0.4

Unified graph transformer with proof-gated mutation substrate — 8 verified modules for physics, biological, manifold, temporal, and economic graph intelligence
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Error types for the graph transformer crate.
//!
//! Composes errors from all sub-crates into a unified error type.

use thiserror::Error;

/// Unified error type for graph transformer operations.
#[derive(Debug, Error)]
pub enum GraphTransformerError {
    /// Verification error from ruvector-verified.
    #[error("verification error: {0}")]
    Verification(#[from] ruvector_verified::VerificationError),

    /// GNN layer error from ruvector-gnn.
    #[error("gnn error: {0}")]
    Gnn(#[from] ruvector_gnn::GnnError),

    /// Attention error from ruvector-attention.
    #[error("attention error: {0}")]
    Attention(#[from] ruvector_attention::AttentionError),

    /// MinCut error from ruvector-mincut.
    #[error("mincut error: {0}")]
    MinCut(#[from] ruvector_mincut::MinCutError),

    /// Proof gate violation: mutation attempted without valid proof.
    #[error("proof gate violation: {0}")]
    ProofGateViolation(String),

    /// Configuration error.
    #[error("configuration error: {0}")]
    Config(String),

    /// Invariant violation detected during execution.
    #[error("invariant violation: {0}")]
    InvariantViolation(String),

    /// Dimension mismatch in graph transformer operations.
    #[error("dimension mismatch: expected {expected}, got {actual}")]
    DimensionMismatch {
        /// Expected dimension.
        expected: usize,
        /// Actual dimension.
        actual: usize,
    },

    /// Numerical error (NaN, Inf, or other instability).
    #[error("numerical error: {0}")]
    NumericalError(String),
}

/// Convenience result type for graph transformer operations.
pub type Result<T> = std::result::Result<T, GraphTransformerError>;