Adjust the prompt FS layout and test strategy

docs/config.md

@@ -23,7 +23,7 @@ pipelines:
   dnd-session:
     input: seriatim
     references:
-      roster: ./dnd-spells-roster.txt
+      party: ./dnd-spells-roster.txt
       glossary: ./dnd-spells-glossary.txt
     chunk:
       module: generic
@@ -164,7 +164,8 @@ pipelines:
   dnd-session:
     input: seriatim
     references:
-      roster: ./campaign/party-roster.txt
+      players: ./campaign/players.txt
+      party: ./campaign/party-roster.txt
       glossary: ./campaign/glossary.txt
     artifacts:
       spells:
@@ -188,7 +189,7 @@ pipelines:
         extract:
           module: dnd/spells
           references:
-            roster: ./campaign/session-roster.txt
+            party: ./campaign/session-party.txt
 ```
 
 `chunk.references` and `normalize.references` are accepted in object-form
@@ -253,12 +254,16 @@ The `generic` chunker accepts:
 
 The `dnd/scenes` chunker requires transcript source capabilities, calls the
 configured structured LLM runtime, and does not accept module options. It
-declares optional `roster` and `glossary` references for scene disambiguation.
+declares optional `players`, `party`, and `glossary` references for scene
+disambiguation, and accepts `roster` as a deprecated compatibility alias for
+`party`.
 
 The `dnd/spells` extractor declares optional reference slots:
 
-- `roster`
+- `players`
+- `party`
 - `glossary`
+- `roster` as a deprecated compatibility alias for `party`
 
 Both modules accept UTF-8 plain text, Markdown, YAML, or JSON reference files.
 The extractor uses references only as supporting disambiguation material; spell

docs/internal/modules.md

@@ -108,7 +108,8 @@ converts each scene into a deterministic source chunk.
 
 Its prompt definition lives under `assets/prompts` and its schema under
 `assets/schemas`. Shared reusable prompt fragments are provided by
-`internal/modules/sharedassets`.
+`internal/modules/sharedassets` and referenced from prompt definitions under
+`./sharedassets/`.
 
 Requires:
 
@@ -146,7 +147,8 @@ validators.
 
 Its prompt definition lives under `assets/prompts` and its schema under
 `assets/schemas`. Shared reusable prompt fragments are provided by
-`internal/modules/sharedassets`.
+`internal/modules/sharedassets` and referenced from prompt definitions under
+`./sharedassets/`.
 
 Requires:
 
@@ -167,10 +169,11 @@ metadata under `artifact_lanes[].metadata.extractor`. Durable artifact payload
 details belong in the
 [D&D spell artifact contract](../integrations/dnd-spell-artifacts.md).
 
-The `dnd/scenes` chunker and `dnd/spells` extractor declare optional `roster`
-and `glossary` reference slots accepting UTF-8 plain text, Markdown, YAML, or
-JSON. Their prompts frame references as supporting disambiguation material only;
-spell-cast artifacts must still be grounded in the source transcript.
+The `dnd/scenes` chunker and `dnd/spells` extractor declare optional `players`,
+`party`, and `glossary` reference slots accepting UTF-8 plain text, Markdown,
+YAML, or JSON. They also accept `roster` as a deprecated compatibility alias for
+`party`. Their prompts frame references as supporting disambiguation material
+only; spell-cast artifacts must still be grounded in the source transcript.
 
 ## D&D Spell Validators