Struct EntityResolver 

pub struct EntityResolver { /* private fields */ }

Resolves entity references to canonical names using a three-tier strategy:

1. Learned cache — instant lookup from alias table (no LLM call)
2. Rule-based — case normalization, substring matching
3. LLM-powered — CognitiveLlmService.resolve_entities() for ambiguous cases

The alias table persists across sessions so the LLM is only consulted for genuinely new entity references.

Implementations

impl EntityResolver

pub fn new() -> Self

pub fn resolve(&self, name: &str) -> ResolvedEntity

Resolve an entity reference using the learned cache and rule-based matching. Does not call the LLM — use resolve_with_llm for the full pipeline.

pub async fn resolve_batch_with_llm<J: LlmJudge>( &mut self, names: &[String], contexts: &[Option<String>], llm: &CognitiveLlmService<J>, ) -> Vec<ResolvedEntity>

Full three-tier resolution: cache → rules → LLM.

Resolves a batch of entity references. Any LLM-confirmed merges are automatically added to the alias table for future cache hits.

pub fn learn_group(&mut self, group: &EntityMergeGroup)

Learn a merge group from the LLM, adding all aliases to the cache.

pub fn add_alias(&mut self, alias: &str, canonical: &str, confidence: f32)

Manually register an alias mapping.

pub fn get_canonical(&self, name: &str) -> Option<&String>

Get the canonical name for an alias, if known.

pub fn known_entities(&self) -> Vec<String>

Returns all known canonical entity names.

pub fn alias_count(&self) -> usize

pub fn is_known_different(&self, a: &str, b: &str) -> bool

Check if two entity names are known to be different (negative cache).

pub fn mark_different(&mut self, a: &str, b: &str)

Mark two entity names as confirmed different (negative cache).

pub fn unresolved_names(&self, names: &[String]) -> Vec<String>

Returns the set of entity names that are NOT yet resolved (no cache hit, no rule-based match). These need LLM resolution.

pub fn negative_count(&self) -> usize

Number of negative-cached pairs.

pub fn save(&self, path: &Path) -> Result<()>

Save the alias table to a JSON file.

pub fn load(&mut self, path: &Path) -> Result<()>

Load the alias table from a JSON file, merging with existing entries.

Trait Implementations

impl Clone for EntityResolver

fn clone(&self) -> EntityResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EntityResolver

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

Formats the value using the given formatter.

impl Default for EntityResolver

fn default() -> Self

Returns the “default value” for a type.