Reject unversioned party documents

docs/config.md

@@ -62,8 +62,7 @@ effective pipeline YAML, with defaults and concrete expansion included but
 composition and family declarations omitted. `config sources` prints a stable
 source projection instead of effective values: root/import/profile/default
 ownership plus campaign/party and generated-family records. Canonical derived
-players trace to the party; a legacy configured players file is explicitly
-marked as a legacy player source. The [CLI reference](cli.md#config-validate-config-show-config-sources-and-config-diff)
+players trace to the party. The [CLI reference](cli.md#config-validate-config-show-config-sources-and-config-diff)
 owns command syntax and output conventions.
 
 `config diff` compares normalized field values rather than YAML text or source
@@ -83,8 +82,8 @@ selected overlay, and retain a production `default_profile`. Convert campaign
 rosters to [canonical party input](integrations/party.md), remove a separate
 `players_file`, then express character work as families. Inspect the result
 with `config validate`, `config show`, and `config sources`; use `config diff`
-to review profiles before running a session. Unversioned parties and their
-`players_file` remain a clearly bounded legacy compatibility path.
+to review profiles before running a session. Unversioned party documents are
+rejected.
 
 ### Identity segments
 
@@ -116,12 +115,10 @@ remote state with an unsafe legacy identity must be migrated before use.
   `party_file`) and the optional `spell_catalog_file` resolve from session
   overrides when provided, otherwise from campaign defaults. An empty or
   omitted session spell-catalog value inherits the campaign value.
-- `party_file` is classified when pipeline and campaign configuration are
-  combined. A versioned [canonical party](integrations/party.md) is
+- `party_file` is parsed when pipeline and campaign configuration are combined.
+  It must be a versioned [canonical party](integrations/party.md), is
   campaign-owned, derives the players input internally, and forbids both a
-  separate `players_file` and a session `party_file` override. An unversioned
-  party remains a bounded legacy input and requires `players_file`; its normal
-  campaign/session overrides continue to apply.
+  separate `players_file` and a session `party_file` override.
 - Exactly one audio mode must be configured in session input:
   - local (`audio_dir` or `audio_files`), or
   - S3 (`audio_s3.prefix`).
@@ -213,7 +210,6 @@ inputs:
   speakers_file: ./speakers.yml
   autocorrect_file: ./autocorrect.yml
   glossary_file: ./glossary.yml
-  players_file: ./players.yml
   party_file: ./party.yml
 ```
 
@@ -476,7 +472,8 @@ does not provide adapter-specific input passthrough fields.
 `pipeline.scriptorium.artifact_families` declares a shared artifact template
 for every canonical campaign character. Configuration resolution expands each
 family into ordinary `pipeline.scriptorium.artifacts` entries before analyze
-planning or Scriptorium invocation. A legacy party cannot be used for a family.
+planning or Scriptorium invocation. Party parsing rejects unsupported document
+schemas before family expansion.
 
 For each `pipeline.scriptorium.artifact_families.<name>`:
 
@@ -524,7 +521,7 @@ integration.
 | `inputs.speakers_file` | string | Yes | stable input default |
 | `inputs.autocorrect_file` | string | Yes | stable input default |
 | `inputs.glossary_file` | string | Yes | stable input default |
-| `inputs.players_file` | string | Conditional | required only with an unversioned legacy `party_file`; forbidden for a canonical party |
+| `inputs.players_file` | string | No | retained temporarily for configuration compatibility; forbidden with the required canonical party |
 | `inputs.party_file` | string | Yes | stable campaign party source; relative paths resolve from `campaign.yml` |
 | `inputs.spell_catalog_file` | string | No | optional spell-catalog overlay default; required when a Notarius reference selects `narratio.input.spell_catalog` |
 
@@ -540,8 +537,8 @@ integration.
 | `inputs.speakers_file` | string | No | overrides campaign stable input |
 | `inputs.autocorrect_file` | string | No | overrides campaign stable input |
 | `inputs.glossary_file` | string | No | overrides campaign stable input |
-| `inputs.players_file` | string | No | legacy-party override; forbidden for a canonical party |
-| `inputs.party_file` | string | No | legacy-party override; forbidden for a canonical campaign party |
+| `inputs.players_file` | string | No | retained temporarily for configuration compatibility; forbidden with the required canonical party |
+| `inputs.party_file` | string | No | retained temporarily for configuration compatibility; forbidden for a canonical campaign party |
 | `inputs.spell_catalog_file` | string | No | overrides the optional campaign spell catalog; empty or omitted inherits the campaign value |
 | `inputs.audio_dir` | string | Conditional | local audio mode |
 | `inputs.audio_files[]` | list[string] | Conditional | local audio mode |

docs/integrations/party.md

@@ -1,8 +1,8 @@
 # Canonical Party Input
 
-`party.yml` is a campaign-owned roster input. Narratio recognizes the
-versioned `narratio.party.v1` document below when it resolves a pipeline,
-campaign, and session together.
+`party.yml` is a campaign-owned roster input. It must be a single, versioned
+`narratio.party.v1` document when Narratio resolves a pipeline, campaign, and
+session together.
 
 ```yaml
 schema_version: narratio.party.v1
@@ -34,19 +34,20 @@ non-empty, trimmed display strings without control characters. Character names
 and aliases must be unique across the full roster under Unicode-aware
 case-insensitive comparison; player names may repeat.
 
-The document has exactly one YAML document and accepts no unknown fields. A
-wrong or malformed `schema_version` is an error.
+The document has exactly one YAML document and accepts no unknown fields.
+`schema_version` is required: a missing, wrong, or malformed value is an error.
 
-## Legacy migration boundary
+## Migration
 
-An unversioned party input remains supported only as opaque legacy reference
-material while campaigns migrate. It requires a separate `players_file` and
-retains the existing session override behavior. It cannot be mixed with a
-canonical party: canonical campaigns must omit `players_file`, and sessions
-must not override their party or players inputs.
+Unversioned party inputs are rejected. Replace each legacy party document with
+the versioned structure above, move each roster entry under `characters`, and
+remove separate player and session-party overrides from the selected campaign
+and session configuration. The configuration-key removal itself is staged
+separately; current configurations must already omit those competing values
+when using a canonical party.
 
-Use the canonical document for new campaigns. The configuration rules and
-source-relative path behavior are defined in the [Configuration Reference](../config.md).
+The configuration rules and source-relative path behavior are defined in the
+[Configuration Reference](../config.md).
 
 ## Derived players document
 

docs/internal/configuration.md

@@ -75,8 +75,7 @@ each contributor as root, import, profile, or centralized default. The
 projection replaces generated concrete member paths with paired family and
 canonical-party records, and does the same for generated publish rules.
 Campaign records identify campaign-owned fields and party inputs; canonical
-derived players point to the party source, while legacy players retain a
-dedicated legacy-player role. The application command only joins these sorted
+derived players point to the party source. The application command only joins these sorted
 records with selection metadata and never reparses configuration files.
 
 `config diff` uses a paired profile loader that parses the root, imports, and
@@ -90,28 +89,24 @@ Values are compact deterministic JSON representations for command output, not
 raw YAML fragments, ownership records, or secret material. A differing digest
 with no projected difference is treated as an internal consistency error.
 
-Campaign context construction also reads and classifies the campaign-owned
-party source through `ParseParty`. A canonical party retains its raw bytes and
-normalized roster in runtime-only `ResolvedParty` provenance, while a legacy
-party remains opaque. Canonical resolution creates a virtual
-`derived_from_party` players input and rejects competing campaign or session
-players files and session party overrides. The compact legacy compatibility
-path resolves the effective campaign/session party and players files together.
+Campaign context construction reads the campaign-owned party source through
+`ParseParty`. The required canonical party retains its raw bytes and normalized
+roster in runtime-only `ResolvedParty` provenance. Canonical resolution creates
+a virtual `derived_from_party` players input and rejects competing campaign or
+session players files and session party overrides.
 
 ## Canonical Party Domain
 
-`ParseParty` is the package-owned boundary for classifying a party source.
-When a top-level `schema_version` is present, it strictly validates the
+`ParseParty` is the package-owned boundary for parsing a party source. It
+requires a top-level `schema_version` and strictly validates the
 `narratio.party.v1` contract into ordered character domain values. The
 canonical value retains a separate exact byte copy of its source so consumers
 can materialize the authored party document without reserializing it. Its
 `PlayersYAML` method deterministically derives the versioned players-only
 projection.
 
-An unversioned source is classified by the small legacy compatibility boundary
-in `party_legacy.go`; it deliberately exposes no parsed roster information.
-That boundary exists solely to isolate removable compatibility behavior from
-the canonical parser.
+An unversioned source is rejected before resolution, family expansion, or
+prepare-stage materialization.
 
 ## Diagnostics And Runtime Metadata
 
@@ -153,8 +148,7 @@ configuration tests continue to protect defaults and validation after assembly.
 `party_test.go` protects the versioned party schema, domain invariants, and
 deterministic players projection without involving campaign or runtime wiring.
 `party_resolution_test.go` protects campaign-owned party loading, canonical
-input restrictions, legacy overrides, source provenance, and virtual players
-input selection.
+input restrictions, source provenance, and virtual players input selection.
 
 ## Artifact Family Resolution
 

docs/roadmap/implementation.md

@@ -150,7 +150,7 @@ branches.
 
 ## Stage 2 — Reject Unversioned Party Documents
 
-**Status: Pending**
+**Status: Completed**
 
 ### Goal
 

docs/troubleshooting.md

@@ -76,6 +76,27 @@ Safe fix:
 
 Relevant reference: [Configuration](./config.md).
 
+## Party schema version rejected
+
+Symptom:
+
+- configuration loading reports that `party.schema_version` is required or
+  unsupported.
+
+Likely cause:
+
+- the campaign `party.yml` is an unversioned legacy document, or names a
+  schema other than `narratio.party.v1`.
+
+Safe fix:
+
+- replace the file with one exact, single-document
+  [`narratio.party.v1` party](./integrations/party.md); do not add a version
+  marker to an otherwise incompatible legacy structure. Remove competing
+  player and session-party settings while migrating.
+
+Relevant reference: [Canonical Party Input](./integrations/party.md).
+
 ## Unexpected imported or profile value
 
 Symptom: