MongoDB Population Skill

Installation: If not already installed, add the required packages:

• pnpm add @efesto-cloud/population (for Populate type and normalizePopulate helper)
• pnpm add @efesto-cloud/mongodb-population (for BasePopulator and QueryBuilder classes)

Adds MongoDB population support — typed eager-loading of related documents via aggregation $lookup — to an existing entity. The entity, its DTO, document type, mapper, and repository are assumed to already exist. This skill only patches them where needed and writes the population infrastructure.

Scope: Shape type, QueryBuilder, Populator, plus targeted patches to entity, DTO, document, mapper, and repository interface/implementation.

Does not: create entities or repositories from scratch, write use cases, or manage DI container wiring.

Phase 0 — Clarify Intent

If the user has not specified which entity to populate and/or which fields should be populated, use AskUserQuestion to ask: