Struct EntityRegistry 

pub struct EntityRegistry { /* private fields */ }

Scope-aware in-memory entity registry.

Entities are partitioned by scope. Resolution first tries the exact scope, then falls back to namespace-only scope if the exact scope yields nothing. Cross-scope collisions are avoided by using ScopeKey in all indexes.

This registry owns entity data as a derived projection — it does NOT own source truth. Entities can be rebuilt from upstream stores.

Implementations

impl EntityRegistry

pub fn new(max_aliases: usize, max_entities: usize) -> Self

Create a new registry with bounded alias and entity limits.

pub fn register(&mut self, entity: Entity) -> Result<(), RuntimeError>

Register a new entity. Returns error if the registry is full.

pub fn remove(&mut self, id: &EntityId) -> Option<Entity>

Remove an entity by ID.

pub fn get(&self, id: &EntityId) -> Option<&Entity>

Look up an entity by ID.

pub fn resolve(&self, mention: &str, scope: &ScopeKey) -> ResolveResult

Resolve a raw mention within a specific scope.

Resolution order:

1. Exact canonical name match in the given scope -> ExactCanonical
2. Exact alias match in the given scope -> ExactAlias
3. Namespace-only fallback (if scope has more dimensions) -> ScopedFallback
4. Unresolved

Alternatives from other scopes with the same namespace are included in ResolveResult::alternatives when the primary match is Unresolved or ScopedFallback, so callers can see potential ambiguity.

pub fn len(&self) -> usize

Number of registered entities.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

pub fn iter(&self) -> impl Iterator<Item = &Entity>

Iterate over all entities.

pub fn iter_scope<'a>( &'a self, scope: &'a ScopeKey, ) -> impl Iterator<Item = &'a Entity> + 'a

Iterate over entities in a specific scope.

pub fn clear_all(&mut self)

Remove all entities across all scopes (for full cache rebuild).

pub fn clear_scope(&mut self, scope: &ScopeKey)

Remove all entities in a specific scope.

Trait Implementations

impl Debug for EntityRegistry

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

Formats the value using the given formatter.