Organize D&D extensions by domain

docs/internal/llm.md

@@ -80,7 +80,9 @@ configuration facts in [Configuration](../config.md#defaults).
 `AssetRegistry` combines caller-owned prompt filesystems under stable prefixes
 and rejects invalid or conflicting registrations. Production module packages
 register their own prompt and schema assets; generic framework code contains no
-D&D prompt content.
+D&D prompt content. `internal/framework/promptfs` provides the domain-neutral
+filesystem composition helper used to combine module-owned files with shared
+domain prompt fragments.
 
 Schema helpers load embedded JSON Schema with identity and digest metadata,
 return defensive copies, and expose a diagnostics map that omits schema bytes.

docs/internal/modules.md

@@ -1,7 +1,7 @@
 # Module And Validator Internals
 
-Production module implementations and generic validators live under
-`internal/modules`; the current D&D validators live under `internal/validators`.
+Production module and validator implementations live under their domain-first
+trees in `internal/modules`.
 The selectable keys, configuration options, reference slots, and default
 validator chain are canonical in the
 [module](../config.md#implemented-production-modules) and
@@ -26,10 +26,10 @@ that agreement. Runtime delivery uses the corresponding stage request's
 
 LLM-backed extensions own their prompt definitions and response schemas under
 package-local embedded assets. Shared filesystem composition belongs in
-`internal/modules/sharedassets`; reusable D&D prompt fragments, reference
+`internal/framework/promptfs`; reusable D&D prompt fragments, reference
 declarations, prompt-input assembly, and source-unit helpers belong in
-`internal/modules/sharedassets/dnd`. Stage contracts expose only Notarius
-structured-completion types, not Scriptorium public types.
+`internal/modules/dnd/shared`. Stage contracts expose only Notarius structured-
+completion types, not Scriptorium public types.
 
 Reference material may inform a module or prompt but must not become source
 evidence. The resolver and materializer behavior is described in
@@ -62,7 +62,7 @@ The accepted options and defaults are defined in
 [Configuration](../config.md#implemented-production-modules). Generic
 framework validation canonicalizes the returned unit slices before extraction.
 
-### `internal/modules/chunk/dnd/scenes`
+### `internal/modules/dnd/chunk/scenes`
 
 The scene chunker prepares a structured Scriptorium request from the full
 transcript, session, and optional D&D reference inputs. It validates the model's
@@ -82,7 +82,7 @@ file types remain canonical in [Configuration](../config.md).
 
 ## Extractor
 
-### `internal/modules/extract/dnd/spells`
+### `internal/modules/dnd/extract/spells`
 
 The spell extractor prepares a structured request from one chunk, the
 chunk-scoped source input, the session, and optional D&D reference inputs. It
@@ -141,7 +141,7 @@ from schema loading or compilation errors. Neither validator calls the LLM.
 
 ## D&D Spell Validators
 
-`internal/validators/extract/dnd/spells/spellpayload` provides strict decoding,
+`internal/modules/dnd/validate/spells/spellpayload` provides strict decoding,
 shape checks, source-reference candidates, and cited-text lookup shared by the
 three validators.
 
@@ -199,5 +199,7 @@ does not inventory implementations.
   defaults.
 - `internal/cli/run_test.go`: production catalog, config resolution, and
   end-to-end CLI composition.
-- `internal/modules/sharedassets/**/*_test.go`: shared prompt and reference
-  assembly.
+- `internal/framework/promptfs/*_test.go` and
+  `internal/modules/dnd/shared/*_test.go`: shared prompt and reference assembly.
+- `internal/modules/integration/*_test.go`: black-box composition across
+  production extension domains.

docs/internal/overview.md

@@ -42,6 +42,7 @@ a sorted set of artifact lanes before the runner constructs any stage module.
 | `internal/framework/pipeline` | Registries, profile resolution, capability checks, reference materialization, validator-chain resolution, retries, orchestration, warnings, and manifest population. |
 | `internal/framework/validate` | Shared validator decision and cardinality helpers. |
 | `internal/framework/llm` | Scriptorium-backed structured completions, prompt/schema registration, scheduling, profile recording, and secret redaction. |
+| `internal/framework/promptfs` | Builds module prompt filesystems from module-owned and caller-provided shared prompt assets. |
 | `internal/framework/checkpoint` | Workspace-backed checkpoint loading, recording, and payload serialization. |
 | `internal/framework/debug` | Workspace-backed framework and LLM debug recording. |
 
@@ -60,26 +61,25 @@ Configuration. The implemented module packages are:
 | --- | --- |
 | `internal/modules/seriatim/input/transcript` | Parses the supported Seriatim transcript format into the generic source model. |
 | `internal/modules/generic/chunk/units` | Splits ordered source units by unit count and overlap. |
-| `internal/modules/chunk/dnd/scenes` | Produces contiguous D&D scene chunks from structured model output. |
-| `internal/modules/extract/dnd/spells` | Produces source-grounded D&D spell-cast raw output. |
+| `internal/modules/dnd/chunk/scenes` | Produces contiguous D&D scene chunks from structured model output. |
+| `internal/modules/dnd/extract/spells` | Produces source-grounded D&D spell-cast raw output. |
 | `internal/modules/generic/merge/appendorder` | Combines accepted extraction results in chunk order. |
 | `internal/modules/generic/normalize/noop` | Preserves accepted merged output. |
 | `internal/modules/generic/output/json` | Encodes manifests, lane payloads, warnings, and rejections as logical JSON files. |
 
-`internal/modules/sharedassets` composes shared prompt filesystems.
-`internal/modules/sharedassets/dnd` owns reusable D&D prompt fragments,
+`internal/modules/dnd/shared` owns reusable D&D prompt fragments,
 reference declarations, prompt input assembly, and source-unit reference
-helpers.
+helpers. Domain-neutral prompt filesystem composition lives in
+`internal/framework/promptfs`.
 
 Generic validators under `internal/modules/generic/validate` provide
 unconditional test decisions, JSON syntax validation, and JSON Schema
-validation. D&D spell validators remain under `internal/validators` and provide
-shape, source-reference, and source-relatedness decisions, with `spellpayload`
-holding their shared parser and lookup helpers.
+validation. D&D spell validators under `internal/modules/dnd/validate/spells`
+provide shape, source-reference, and source-relatedness decisions, with
+`spellpayload` holding their shared parser and lookup helpers.
 
-Production composition is grouped behind package-family registrars. Generic
-and Seriatim implementations use their domain-first trees; D&D implementations
-remain in their current stage-oriented packages:
+Production composition is grouped behind package-family registrars, and every
+implemented production extension uses its domain-first tree:
 
 | Package | Implemented responsibility |
 | --- | --- |