Struct OntologyTable 

pub struct OntologyTable { /* private fields */ }

The loaded APEX-MEM ontology table plus bounded LRU cache for resolved mappings.

Designed for read-heavy workloads: the static table and cardinality map are behind ArcSwap for lock-free reads; the LRU cache is behind a Mutex (written only on misses and LLM fallback results).

Implementations

impl OntologyTable

pub fn from_default(cache_max: usize) -> Self

Create from the embedded default ontology table.

pub async fn from_path( path: &Path, cache_max: usize, ) -> Result<Self, MemoryError>

Load from a TOML file at path, or fall back to embedded defaults when path is empty.

Errors

Returns an error if the file exists but cannot be parsed.

pub async fn reload(&self, path: &Path) -> Result<(), MemoryError>

Reload the ontology table from path (or embedded defaults if path is empty).

The LRU cache is cleared atomically with the table swap so stale mappings from the old table cannot win over new canonical forms.

Errors

Returns an error if the new TOML cannot be parsed.

pub async fn resolve(&self, raw_predicate: &str) -> (String, bool)

Resolve raw_predicate to its canonical form.

Resolution order:

1. LRU cache hit
2. Static table lookup
3. Miss: return raw as canonical (cardinality-n default)

Returns (canonical, was_unmapped). was_unmapped is true when the predicate had no entry in the static table; callers should increment the unmapped counter.

Examples

use zeph_memory::graph::ontology::OntologyTable;

let table = OntologyTable::from_default(64);
let (canonical, unmapped) = table.resolve("employed_by").await;
assert_eq!(canonical, "works_at");
assert!(!unmapped);

pub fn cardinality(&self, canonical_predicate: &str) -> Cardinality

Return the cardinality for canonical_predicate.

Defaults to Cardinality::Many for predicates not in the ontology table.

Trait Implementations

impl Debug for OntologyTable

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

Formats the value using the given formatter.