Struct SenseModule 

#[repr(C)]
pub struct SenseModule {
    pub octree_bits: [u64; 4],
    pub directions: [TernaryDir; 8],
    pub confidence: f32,
    pub kind: SenseKind,
    pub version: u8,
    pub octree_depth: u8,
    pub n_directions: u8,
    pub _reserved: u8,
    pub commitment: [u8; 32],
}

Fixed-size sense module: KG latent octree + ternary direction vectors. ~232 bytes. BLAKE3 committed.

Field ordering: u64-aligned first, then f32, then u8 tail. commitment must remain LAST for the hash-until-end-of-struct pattern.

Fields

octree_bits: [u64; 4]

Octree occupancy bit-planes (up to depth 3 → 128 nodes in 2×u64).

directions: [TernaryDir; 8]

Ternary direction vectors for projection.

confidence: f32

Module confidence [0, 1].

kind: SenseKind

version: u8

octree_depth: u8

n_directions: u8

_reserved: u8

commitment: [u8; 32]

BLAKE3 commitment over all preceding fields.

Implementations

impl SenseModule

pub fn project(&self, belief_state: &[f32; 8]) -> f32

Project belief state onto this module’s ternary directions → sigmoid scalar.

KG weight bridge: output is scaled by module confidence so that high-confidence KG triples produce stronger sense activations and low-confidence triples are attenuated. Confidence 1.0 = unchanged.

Optimized: branch-free bit extraction via shift+AND, flat loop (LLVM auto-vectorizes better than chunked), bounded exp sigmoid.

pub fn query_octree(&self, level: u8, index: u8) -> Option<bool>

Query octree occupancy at given level and index. Returns None if indices out of bounds.

pub fn commit(&mut self)

Compute and store BLAKE3 commitment. Zeros TernaryDir padding bytes first for deterministic hashing.

pub fn verify(&self) -> bool

Verify BLAKE3 commitment. Uses a stack buffer to avoid cloning the entire 232-byte struct. Zeros TernaryDir padding bytes before comparing to match commit() behavior.

Trait Implementations

impl Clone for SenseModule

fn clone(&self) -> SenseModule

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SenseModule

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

Formats the value using the given formatter.

impl Default for SenseModule

fn default() -> Self

Returns the “default value” for a type.