Project spell aliases into extraction prompts

internal/modules/dnd/spells/catalog/effective.go

@@ -26,10 +26,18 @@ type EffectiveCatalog struct {
 	ruleset        string
 	overlayIDs     []string
 	canonicalNames []string
+	promptSpells   []PromptSpell
 	lookup         map[string]string
 	digest         string
 }
 
+// PromptSpell is the recognition-only catalog entry supplied to extraction
+// prompts. It intentionally contains no catalog provenance or source data.
+type PromptSpell struct {
+	CanonicalName string   `json:"canonical_name"`
+	Aliases       []string `json:"aliases"`
+}
+
 func (c EffectiveCatalog) BaseID() string       { return c.baseID }
 func (c EffectiveCatalog) Ruleset() string      { return c.ruleset }
 func (c EffectiveCatalog) Digest() string       { return c.digest }
@@ -41,6 +49,22 @@ func (c EffectiveCatalog) CanonicalNames() []string {
 	return append([]string(nil), c.canonicalNames...)
 }
 
+// PromptSpells returns canonical names and their recognized aliases in
+// deterministic canonical-name order. The result is safe for callers to
+// modify.
+func (c EffectiveCatalog) PromptSpells() []PromptSpell {
+	out := make([]PromptSpell, len(c.promptSpells))
+	for index, spell := range c.promptSpells {
+		aliases := make([]string, len(spell.Aliases))
+		copy(aliases, spell.Aliases)
+		out[index] = PromptSpell{
+			CanonicalName: spell.CanonicalName,
+			Aliases:       aliases,
+		}
+	}
+	return out
+}
+
 // Lookup matches canonical names and aliases after applying the same
 // normalization used by the embedded catalog. The returned string is the
 // established canonical display name.
@@ -254,6 +278,16 @@ func composeEffectiveCatalog(base Catalog, overlays []overlayCatalog) (Effective
 		canonicalNames = append(canonicalNames, spell.name)
 	}
 	sort.Strings(canonicalNames)
+	promptSpells := make([]PromptSpell, len(canonicalNames))
+	for index, name := range canonicalNames {
+		spell := builder.spells[name]
+		aliases := make([]string, 0, len(spell.aliases))
+		for _, alias := range spell.aliases {
+			aliases = append(aliases, alias)
+		}
+		sort.Strings(aliases)
+		promptSpells[index] = PromptSpell{CanonicalName: spell.name, Aliases: aliases}
+	}
 
 	digest, err := effectiveDigest(base, overlays, builder, canonicalNames)
 	if err != nil {
@@ -264,6 +298,7 @@ func composeEffectiveCatalog(base Catalog, overlays []overlayCatalog) (Effective
 		ruleset:        base.Ruleset(),
 		overlayIDs:     overlayIDs,
 		canonicalNames: canonicalNames,
+		promptSpells:   promptSpells,
 		lookup:         cloneStringMap(builder.lookup),
 		digest:         digest,
 	}, nil