Struct Selector 

pub struct Selector {
    pub concepts: Vec<Concept>,
    pub variants: Vec<Variant>,
    pub audience: Audience,
    pub depth: Depth,
    pub locale: String,
    pub headers: bool,
}

What to compose. Build one directly, or use a Recipe.

Fields

concepts: Vec<Concept>

Concepts to include, in render order.

variants: Vec<Variant>

Variants to include; empty means all.

audience: Audience

Audience lens.

depth: Depth

How much detail.

locale: String

Requested locale; falls back to DEFAULT_LOCALE per slot.

headers: bool

Emit ## <concept title> section headers. Markdown-rendering clients want them; a plain-terminal REPL banner does not.

Implementations

impl Selector

pub fn with_overlay(self) -> Self

Opt into Concept::Overlay guidance (--overlay, kaish-vfs). Every Recipe excludes it by default — most embedders never enable overlay mode, and the paragraph is dead weight (or an active mixed signal for a read-only embedder) when they don’t. Chain it onto a recipe: Recipe::agent_onboarding().with_overlay(). A no-op if already present.

pub fn without_overlay(self) -> Self

Drop Concept::Overlay guidance, in case a future recipe or a caller-built Selector included it. Symmetric with Self::with_overlay; a no-op today since no recipe defaults it in.