Ground spell extraction with the effective catalog

internal/modules/dnd/extract/spells/assets/prompts/catalog.md

@@ -0,0 +1,6 @@
+The canonical spell-name catalog for this extraction is provided below as JSON.
+Return spell names using the catalog's canonical spelling exactly. Aliases and
+other campaign reference material are not part of this catalog input and must
+not be copied into the output as spell names.
+
+{{ input "spell_catalog" }}

internal/modules/dnd/extract/spells/assets/prompts/dnd.spells.yaml

@@ -5,6 +5,9 @@ inputs:
   - name: transcript
     required: true
     content_type: application/json
+  - name: spell_catalog
+    required: true
+    content_type: application/json
   - name: players
     required: false
     content_type: text/plain
@@ -25,6 +28,8 @@ messages:
     content_file: ./sharedassets/common-dnd-references.md
     cache_control:
       type: ephemeral
+  - role: user
+    content_file: ./catalog.md
   - role: user
     content_file: ./task.md
   - role: user

internal/modules/dnd/extract/spells/assets/prompts/instructions.md

@@ -5,8 +5,12 @@ source_id automatically.
 Return only D&D spell-cast artifacts. For each spell cast, identify the in-world
 caster, spell name, effect, narrative description, and source references.
 
-Use player, party, and glossary reference material only to clarify source text.
-Do not return spells, casters, or effects that are mentioned only in reference
-material.
+Use the canonical spell-name catalog to select spell names. Do not return a
+spell name absent from that catalog, even when it is suggested by general D&D
+knowledge or reference material.
+
+Use player, party, and glossary reference material only to clarify source text;
+references are not source evidence for a spell cast. Do not return spells,
+casters, or effects that are mentioned only in reference material.
 
 Return exactly one JSON object and no explanatory text.

internal/modules/dnd/extract/spells/assets/prompts/task.md

@@ -3,3 +3,7 @@ Extract Dungeons & Dragons spell-cast artifacts from the provided transcript.
 Extract only spell casts that are supported by the transcript. Do not infer
 spells from general D&D knowledge or from table chatter that does not identify a
 spell being cast.
+
+Use the provided canonical spell-name catalog when naming each extracted spell.
+Return the canonical catalog spelling exactly. The catalog is a recognition
+aid; it does not establish that a spell was cast.