Minor additional improvements to the D&D spell extraction prompt.

docs/integrations/dnd-spell-artifacts.md

@@ -58,13 +58,16 @@ occurred. The `spell` value must resolve through the effective SRD-plus-overlay
 catalog as either a canonical name or alias. Catalog validation accepts aliases
 but does not rewrite them; unknown fields are rejected.
 
-`effect` and `narrative_description` record what the transcript establishes
+`effect` and `narrative_description` record the casting declaration and its
-about the session as played. They do not correct the table from published D&D
+immediate resolution as established by the transcript. They do not follow
-rules or supplement the transcript with model knowledge. When the transcript
+summoned creatures, persistent spell effects, or other downstream consequences
-contains a nonstandard or disputed ruling, the artifact may preserve the
+through the rest of the scene. They also do not correct the table from
-observed resolution and attribute relevant reasoning to the GM or table; it
+published D&D rules or supplement the transcript with model knowledge. When the
-must not present that reasoning as a universal game rule. The spell catalog is
+transcript contains a nonstandard or disputed ruling, the artifact may preserve
-name-recognition policy, not evidence for spell mechanics or outcomes.
+the immediate observed resolution and attribute relevant reasoning to the GM or
+table; it must not present that reasoning as a universal game rule. The spell
+catalog is name-recognition policy, not evidence for spell mechanics or
+outcomes.
 
 ## Source References
 
@@ -75,14 +78,16 @@ must not appear after the end unit. Unknown fields are rejected.
 
 For each cast, the complete `source_refs` collection identifies the transcript
 evidence for every factual claim in `caster`, `spell`, `effect`, and
-`narrative_description`. A cast declaration and a later resolution may be
+`narrative_description`. A cast declaration and its immediate resolution may be
 cited with separate narrow ranges when intervening units are unrelated. A
-reported target, roll, amount, condition, interruption, or outcome must be
+reported target, roll, amount, condition, interruption, or immediate outcome
-supported by the cited units; otherwise the artifact describes only the
+must be supported by the cited units; otherwise the artifact describes only the
-supported attempt or declaration. The deterministic validators establish that
+supported attempt or declaration. Later behavior by summoned creatures,
-ranges are structurally valid and that the spell name is related to cited
+recurring effects, and other downstream consequences are outside the cast
-text. Semantic claim completeness is an extraction policy and remains subject
+artifact's evidence scope. The deterministic validators establish that ranges
-to evaluation rather than deterministic proof.
+are structurally valid and that the spell name is related to cited text.
+Semantic claim completeness is an extraction policy and remains subject to
+evaluation rather than deterministic proof.
 
 Reference slot keys and accepted file types are defined in
 [Configuration](../config.md#implemented-production-modules). References are

docs/internal/modules.md

@@ -160,10 +160,12 @@ failures therefore stop construction before source parsing or an LLM call;
 campaign references remain separate disambiguation inputs and never become
 source evidence.
 
-The prompt requires each cast's source references collectively to support all
+The prompt limits each cast to its declaration and immediate resolution; it
-reported facts, using separate narrow ranges when a declaration and resolution
+does not follow summoned creatures, persistent effects, or other downstream
-are non-contiguous. It grounds caster names in in-world identities, using the
+consequences through the scene. Source references must collectively support all
-player and party references to disambiguate transcript speakers without
+reported facts, using separate narrow ranges when immediate evidence is
+non-contiguous. The prompt grounds caster names in in-world identities, using
+the player and party references to disambiguate transcript speakers without
 treating those references as event evidence. Effects describe the session as
 played: model rules knowledge cannot supplement or correct the transcript, and
 nonstandard adjudication is attributed to the GM or table rather than stated as

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

@@ -2,14 +2,19 @@ Source references must use integer source-unit IDs from the transcript. Provide
 start_unit_id and end_unit_id for each source reference; the extractor assigns
 source_id automatically.
 
-For each artifact, its source references must collectively support every
+Report only the casting declaration or action and its immediate resolution.
-factual claim in caster, spell, effect, and narrative_description. Include the
+This may include an immediately resolved target, saving throw, damage, healing,
-casting declaration or action and every later transcript unit needed to support
+condition, interruption, or outcome. Do not follow summoned creatures,
-reported targets, saving throws, damage, healing, conditions, interruptions,
+persistent effects, or other downstream consequences through the rest of the
-and outcomes. When supporting evidence is non-contiguous, provide multiple
+scene.
-narrow source references. Do not use one broad range merely to bridge unrelated
+
-table conversation. If a detail is not supported by the cited transcript
+For every detail you report, cite all supporting transcript units. The source
-units, omit that detail or describe only the supported attempt or declaration.
+references for an artifact must collectively support every factual claim in
+caster, spell, effect, and narrative_description. When immediate supporting
+evidence is non-contiguous, provide multiple narrow source references. Do not
+use one broad range merely to bridge unrelated table conversation. If a detail
+is not supported by the cited transcript units, omit that detail or describe
+only the supported attempt or declaration.
 
 Return only D&D spell-cast artifacts. For each spell cast, identify the in-world
 caster, spell name, effect, narrative description, and source references.

internal/modules/dnd/extract/spells/assets/schemas/dnd_spells_llm.v1.json

@@ -31,17 +31,17 @@
           "effect": {
             "type": "string",
             "minLength": 1,
-            "description": "Concise effect or resolution established by the cited transcript units; do not infer mechanics from general D&D rules knowledge."
+            "description": "Concise immediate effect or resolution established by the cited transcript units; do not infer mechanics from general D&D rules knowledge or follow persistent downstream consequences."
           },
           "narrative_description": {
             "type": "string",
             "minLength": 1,
-            "description": "Short session-grounded description containing only details established by the cited transcript units."
+            "description": "Short session-grounded description of the casting declaration and immediate resolution, containing only details established by the cited transcript units."
           },
           "source_refs": {
             "type": "array",
             "minItems": 1,
-            "description": "One or more narrow transcript ranges that collectively support every factual claim in this spell-cast object, including any reported resolution or outcome.",
+            "description": "One or more narrow transcript ranges that collectively support every factual claim about the casting declaration and immediate resolution in this spell-cast object.",
             "items": {
               "type": "object",
               "additionalProperties": false,