Add spell catalog overlay resolution

This commit is contained in:
2026-07-20 19:10:44 +00:00
parent 7806dba509
commit 3bfe05ab56
4 changed files with 781 additions and 0 deletions

View File

@@ -70,6 +70,17 @@ license details live beside the asset in `SOURCES.md`. This domain-owned data is
separate from `internal/modules/dnd/shared`, which is reserved for reusable
prompt and source-reference machinery.
`ResolveEffectiveCatalog` builds the immutable recognition view used by later
D&D consumers. It starts with the embedded SRD catalog and optionally applies
one strict JSON overlay from the `spell_catalog` item in a materialized
reference set. Overlay catalogs are ordered by ID, may add names and aliases,
and may augment an existing canonical spell without replacing its display
name. Cross-spell lookup collisions are errors. The effective view exposes
sorted canonical names, normalized lookup, overlay identities, and a semantic
digest; overlay content remains contextual reference material rather than
source evidence. Its external JSON contract is defined in the
[spell-catalog overlay contract](../integrations/dnd-spell-catalog-overlays.md).
## Input Adapter
### `internal/modules/seriatim/input/transcript`