Class SearchEnricher

Apply full enrichment to search results: entity icons, record names, and tags.

Enrich results with tags from both TaggedItems and ContentItemTags entities.

Handles Content Item results by promoting entity-sourced content items to their underlying entity records (Option B), or excluding redundant entity-sourced items, while preserving genuine external unstructured content items (PDFs, URLs, Markdown files).

When a content item originated from an Entity content source (or links to an Entity Record Document):

1. If its underlying entity record can be resolved, it is promoted to that target entity (EntityName, RecordID), carrying its score and snippet forward, and marked with PromotedFromContentItemID so the engine verifies the origin row and its lane bound rather than trusting the provider that found the content item.
2. If it cannot be resolved, it is excluded to avoid surfacing detached internal items.

Genuine external content items (ContentSourceType !== 'Entity') remain as 'MJ: Content Items'.

Filter results to only include those with at least one tag matching the specified list. Uses case-insensitive comparison.