Struct ValidatedEmbedding 

pub struct ValidatedEmbedding { /* private fields */ }

Validated embedding tensor - compile-time guarantee of data quality

This type can ONLY be constructed via new(), which enforces:

• Correct element count (vocab_size * hidden_dim)
• Density check (<50% zeros) - catches PMAT-234 bug
• No NaN or Inf values
• Non-degenerate distribution (L2 > 1e-6, values vary)
• Spot check at 10%/50%/90% of vocab

Poka-Yoke Guarantee

The inner data field is private. There is no way to construct this type without passing validation. This makes the PMAT-234 bug (94.5% zeros) impossible at compile time.

Implementations

impl ValidatedEmbedding

pub fn new( data: Vec<f32>, vocab_size: usize, hidden_dim: usize, ) -> Result<ValidatedEmbedding, ContractValidationError>

Construct a validated embedding tensor

This is the ONLY way to create a ValidatedEmbedding. All contract rules are enforced here.

Errors

Returns ContractValidationError if any validation rule fails:

• Wrong element count

• 50% zeros (F-DATA-QUALITY-001)

• Contains NaN (F-DATA-QUALITY-002)
• Contains Inf (F-DATA-QUALITY-002)
• L2 norm ~0 (F-DATA-QUALITY-003)
• All values identical (F-DATA-QUALITY-003)
• Spot check fails (F-DATA-QUALITY-004)

pub fn data(&self) -> &[f32]

Access the validated data

pub fn into_inner(self) -> Vec<f32>

Consume and return the inner data

pub fn vocab_size(&self) -> usize

Get vocab size

pub fn hidden_dim(&self) -> usize

Get hidden dimension

pub fn stats(&self) -> &TensorStats

Get validation statistics

Trait Implementations

impl Clone for ValidatedEmbedding

fn clone(&self) -> ValidatedEmbedding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValidatedEmbedding

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

Formats the value using the given formatter.