Implemented new campaign/session stable inputs and corresponding input source references

2026-05-27 09:34:05 -05:00
parent 3ddb3a947b
commit 717451512a
32 changed files with 529 additions and 19 deletions
--- a/internal/config/campaign_config_test.go
+++ b/internal/config/campaign_config_test.go
@@ -37,7 +37,7 @@ notification:

 func TestCampaignStrictDecodeAcceptsCampaignID(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -52,7 +52,7 @@ func TestCampaignStrictDecodeAcceptsCampaignID(t *testing.T) {

 func TestCampaignStrictDecodeRejectsLegacyCampaignField(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -67,7 +67,7 @@ func TestCampaignStrictDecodeRejectsLegacyCampaignField(t *testing.T) {

 func TestCampaignStrictDecodeRejectsUnknownFields(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\nunknown: true\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign_id: sample-campaign\nunknown: true\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -82,7 +82,7 @@ func TestCampaignStrictDecodeRejectsUnknownFields(t *testing.T) {

 func TestCampaignStrictDecodeAcceptsSessionTemplateFile(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\nsession_template_file: ./session.template.yml\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign_id: sample-campaign\nsession_template_file: ./session.template.yml\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -97,7 +97,7 @@ func TestCampaignStrictDecodeAcceptsSessionTemplateFile(t *testing.T) {

 func TestCampaignSessionMergeFillsStableInputs(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./campaign-speakers.yml\n  autocorrect_file: ./campaign-autocorrect.yml\n  glossary_file: ./campaign-glossary.yml\n",
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./campaign-speakers.yml\n  autocorrect_file: ./campaign-autocorrect.yml\n  glossary_file: ./campaign-glossary.yml\n  players_file: ./campaign-players.yml\n  party_file: ./campaign-party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -114,12 +114,14 @@ func TestCampaignSessionMergeFillsStableInputs(t *testing.T) {
 	assertResolvedStableInput(t, cfg.StableInputs.SpeakersFile, "./campaign-speakers.yml", campaignPath, "campaign_config")
 	assertResolvedStableInput(t, cfg.StableInputs.AutocorrectFile, "./campaign-autocorrect.yml", campaignPath, "campaign_config")
 	assertResolvedStableInput(t, cfg.StableInputs.GlossaryFile, "./campaign-glossary.yml", campaignPath, "campaign_config")
+	assertResolvedStableInput(t, cfg.StableInputs.PlayersFile, "./campaign-players.yml", campaignPath, "campaign_config")
+	assertResolvedStableInput(t, cfg.StableInputs.PartyFile, "./campaign-party.yml", campaignPath, "campaign_config")
 }

 func TestCampaignSessionMergeSessionOverridesStableInputs(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./campaign-speakers.yml\n  autocorrect_file: ./campaign-autocorrect.yml\n  glossary_file: ./campaign-glossary.yml\n",
-		"session_id: 2026-05-03\ncampaign: sample-campaign\ninputs:\n  audio_dir: ./audio\n  speakers_file: ./session-speakers.yml\n",
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./campaign-speakers.yml\n  autocorrect_file: ./campaign-autocorrect.yml\n  glossary_file: ./campaign-glossary.yml\n  players_file: ./campaign-players.yml\n  party_file: ./campaign-party.yml\n",
+		"session_id: 2026-05-03\ncampaign: sample-campaign\ninputs:\n  audio_dir: ./audio\n  speakers_file: ./session-speakers.yml\n  players_file: ./session-players.yml\n  party_file: ./session-party.yml\n",
 	)

 	cfg, err := LoadWithSessionOptions(pipelinePath, campaignPath, sessionPath, SessionLoadOptions{})
@@ -132,11 +134,32 @@ func TestCampaignSessionMergeSessionOverridesStableInputs(t *testing.T) {
 	assertResolvedStableInput(t, cfg.StableInputs.SpeakersFile, "./session-speakers.yml", sessionPath, "session_config")
 	assertResolvedStableInput(t, cfg.StableInputs.AutocorrectFile, "./campaign-autocorrect.yml", campaignPath, "campaign_config")
 	assertResolvedStableInput(t, cfg.StableInputs.GlossaryFile, "./campaign-glossary.yml", campaignPath, "campaign_config")
+	assertResolvedStableInput(t, cfg.StableInputs.PlayersFile, "./session-players.yml", sessionPath, "session_config")
+	assertResolvedStableInput(t, cfg.StableInputs.PartyFile, "./session-party.yml", sessionPath, "session_config")
+}
+
+func TestCampaignRequiresPlayersAndPartyInputs(t *testing.T) {
+	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
+	)
+
+	cfg, err := LoadWithSessionOptions(pipelinePath, campaignPath, sessionPath, SessionLoadOptions{})
+	if err != nil {
+		t.Fatalf("LoadWithSessionOptions() error = %v", err)
+	}
+	err = Validate(cfg)
+	if err == nil {
+		t.Fatal("expected validation error, got nil")
+	}
+	if !strings.Contains(err.Error(), "campaign.inputs.players_file is required") {
+		t.Fatalf("error = %q, want players_file required", err.Error())
+	}
 }

 func TestCampaignSessionMismatchFails(t *testing.T) {
 	pipelinePath, campaignPath, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ncampaign: other-campaign\ninputs:\n  audio_dir: ./audio\n",
 	)

@@ -151,7 +174,7 @@ func TestCampaignSessionMismatchFails(t *testing.T) {

 func TestLoadMissingCampaignFileFails(t *testing.T) {
 	pipelinePath, _, sessionPath := writeCampaignConfigTestFiles(t,
-		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n",
+		"campaign_id: sample-campaign\ninputs:\n  speakers_file: ./speakers.yml\n  autocorrect_file: ./autocorrect.yml\n  glossary_file: ./glossary.yml\n  players_file: ./players.yml\n  party_file: ./party.yml\n",
 		"session_id: 2026-05-03\ninputs:\n  audio_dir: ./audio\n",
 	)
 	missingCampaignPath := filepath.Join(filepath.Dir(sessionPath), "missing-campaign.yml")
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -51,6 +51,8 @@ type CampaignInputsConfig struct {
 	SpeakersFile    string `yaml:"speakers_file"`
 	AutocorrectFile string `yaml:"autocorrect_file"`
 	GlossaryFile    string `yaml:"glossary_file"`
+	PlayersFile     string `yaml:"players_file"`
+	PartyFile       string `yaml:"party_file"`
 }

 // SessionConfig contains per-session inputs and metadata.
@@ -265,6 +267,8 @@ type SessionInputsConfig struct {
 	SpeakersFile    string               `yaml:"speakers_file"`
 	AutocorrectFile string               `yaml:"autocorrect_file"`
 	GlossaryFile    string               `yaml:"glossary_file"`
+	PlayersFile     string               `yaml:"players_file"`
+	PartyFile       string               `yaml:"party_file"`
 }

 // SessionAudioS3Input configures S3 session-audio input discovery.
@@ -278,6 +282,8 @@ type ResolvedStableInputs struct {
 	SpeakersFile    ResolvedInputFile
 	AutocorrectFile ResolvedInputFile
 	GlossaryFile    ResolvedInputFile
+	PlayersFile     ResolvedInputFile
+	PartyFile       ResolvedInputFile
 }

 // ResolvedInputFile records one merged config path and its source config file.
--- a/internal/config/load.go
+++ b/internal/config/load.go
@@ -226,11 +226,25 @@ func mergeCampaignSession(campaignCfg *CampaignConfig, sessionCfg *SessionConfig
 			campaignPath,
 			sessionPath,
 		),
+		PlayersFile: selectStableInput(
+			campaignCfg.Inputs.PlayersFile,
+			sessionCfg.Inputs.PlayersFile,
+			campaignPath,
+			sessionPath,
+		),
+		PartyFile: selectStableInput(
+			campaignCfg.Inputs.PartyFile,
+			sessionCfg.Inputs.PartyFile,
+			campaignPath,
+			sessionPath,
+		),
 	}

 	sessionCfg.Inputs.SpeakersFile = stable.SpeakersFile.Path
 	sessionCfg.Inputs.AutocorrectFile = stable.AutocorrectFile.Path
 	sessionCfg.Inputs.GlossaryFile = stable.GlossaryFile.Path
+	sessionCfg.Inputs.PlayersFile = stable.PlayersFile.Path
+	sessionCfg.Inputs.PartyFile = stable.PartyFile.Path
 	return stable, nil
 }

--- a/internal/config/load_validate_test.go
+++ b/internal/config/load_validate_test.go
@@ -36,6 +36,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			checkDefault: true,
 			wantRoot:     "/tmp/narratio",
@@ -55,6 +57,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			checkDefault: true,
 			wantRoot:     "/tmp/narratio",
@@ -72,6 +76,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			checkDefault: true,
 			wantRoot:     DefaultWorkspaceRoot,
@@ -88,6 +94,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "pipeline file",
 		},
@@ -106,6 +114,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -123,6 +133,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -143,6 +155,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -163,6 +177,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.secrets.env_dir must be non-empty when pipeline.secrets is configured",
 		},
@@ -177,6 +193,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 unknown_field: true
 `,
 			wantLoadErr: "session file",
@@ -196,6 +214,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "session config \"session.yml\" invalid: session.session_id is required",
 		},
@@ -215,6 +235,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 		},
 		{
@@ -233,6 +255,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "session config \"session.yml\" invalid: session.previous_session_id must not equal session.session_id",
 		},
@@ -250,6 +274,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.transcribe_url is required",
 		},
@@ -268,6 +294,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.transcribe_url must be a valid URL",
 		},
@@ -287,6 +315,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.timeout must be a valid duration",
 		},
@@ -306,6 +336,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.retry_delay must be a valid duration",
 		},
@@ -325,6 +357,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.retries must be >= 0",
 		},
@@ -344,6 +378,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.whisperx.concurrency must be > 0",
 		},
@@ -363,6 +399,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -383,6 +421,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -401,6 +441,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 		},
 		{
@@ -419,6 +461,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.seriatim.timeout must be a valid duration",
 		},
@@ -438,6 +482,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.seriatim.output_schema must be one of: seriatim-minimal, seriatim-intermediate, seriatim-full",
 		},
@@ -457,6 +503,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.seriatim.coalesce_gap must be >= 0",
 		},
@@ -477,6 +525,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.seriatim.env.overlap_word_run_gap must be > 0 when provided",
 		},
@@ -498,6 +548,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -518,6 +570,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 		},
 		{
@@ -538,6 +592,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.timeout must be a valid duration",
 		},
@@ -559,6 +615,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 		},
 		{
@@ -581,6 +639,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.modules[1] must be non-empty",
 		},
@@ -604,6 +664,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.modules[1] must be one of: glossary, homophones, spoken_word, grammar",
 		},
@@ -625,6 +687,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.base_url must be a valid URL",
 		},
@@ -646,6 +710,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantLoadErr: "strict decode failed",
 		},
@@ -667,6 +733,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.total_llm_concurrency must be > 0",
 		},
@@ -688,6 +756,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.proposal_llm_concurrency must be > 0",
 		},
@@ -709,6 +779,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.validation_llm_concurrency must be > 0",
 		},
@@ -730,6 +802,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.output_schema must be one of: bare-segments, audita-v1",
 		},
@@ -751,6 +825,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantValidate: "pipeline config \"pipeline.yml\" invalid: pipeline.audita.work_dir_retention must be one of: always, auto, never",
 		},
@@ -916,7 +992,16 @@ func TestValidateMissingAudioSource(t *testing.T) {
 				Report:                   boolPtr(true),
 			},
 		},
-		Campaign: &CampaignConfig{CampaignID: "sample-campaign"},
+		Campaign: &CampaignConfig{
+			CampaignID: "sample-campaign",
+			Inputs: CampaignInputsConfig{
+				SpeakersFile:    "speakers.yml",
+				AutocorrectFile: "autocorrect.yml",
+				GlossaryFile:    "glossary.yml",
+				PlayersFile:     "players.yml",
+				PartyFile:       "party.yml",
+			},
+		},
 		Session: &SessionConfig{
 			SessionID: "2026-05-03",
 			Campaign:  "sample-campaign",
@@ -924,6 +1009,8 @@ func TestValidateMissingAudioSource(t *testing.T) {
 				SpeakersFile:    "speakers.yml",
 				AutocorrectFile: "autocorrect.yml",
 				GlossaryFile:    "glossary.yml",
+				PlayersFile:     "players.yml",
+				PartyFile:       "party.yml",
 			},
 		},
 	}
@@ -1009,6 +1096,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(campaignPath, []byte(campaignYAML), 0o644); err != nil {
 		t.Fatalf("write campaign.yml: %v", err)
--- a/internal/config/scriptorium_test.go
+++ b/internal/config/scriptorium_test.go
@@ -215,6 +215,27 @@ func TestScriptoriumLoadAndValidate(t *testing.T) {
        transcript_markdown:
          source: narratio.transcript.final_markdown
          required: true
+`,
+		},
+		{
+			name: "prepared stable input sources are accepted",
+			scriptoriumYAML: `scriptorium:
+  binary: scriptorium
+  artifacts:
+    session_recap:
+      enabled: true
+      prompt_id: dnd.session_recap
+      output_path: artifacts/session_recap.md
+      inputs:
+        players:
+          source: narratio.input.players
+          required: true
+        party:
+          source: narratio.input.party
+          required: true
+        glossary:
+          source: narratio.input.glossary
+          required: false
 `,
 		},
 		{
@@ -575,4 +596,6 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
--- a/internal/config/session_template_test.go
+++ b/internal/config/session_template_test.go
@@ -17,6 +17,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
@@ -40,6 +42,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
@@ -65,6 +69,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
@@ -93,6 +99,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
@@ -124,6 +132,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
@@ -148,6 +158,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	if err := os.WriteFile(sessionPath, []byte(sessionYAML), 0o644); err != nil {
 		t.Fatalf("write session.yml: %v", err)
--- a/internal/config/storage_publish_test.go
+++ b/internal/config/storage_publish_test.go
@@ -238,6 +238,15 @@ func TestPublishOutputValidation(t *testing.T) {
 `,
 			wantErr: "source \"narratio.unknown\" is unsupported",
 		},
+		{
+			name: "prepared input source rejected",
+			ruleYML: `publish:
+  outputs:
+    - source: "narratio.input.players"
+      dest: "inputs/players.yml"
+`,
+			wantErr: "source \"narratio.input.players\" is unsupported",
+		},
 		{
 			name: "duplicate destination rejected",
 			ruleYML: `publish:
@@ -426,6 +435,15 @@ publish:
 `,
 			wantErr: "pipeline.publish.locks[0].source \"narratio.unknown\" is unsupported",
 		},
+		{
+			name: "prepared input source rejected",
+			pipelineYML: testPipelineBaseYAML + `
+publish:
+  locks:
+    - source: narratio.input.players
+`,
+			wantErr: "pipeline.publish.locks[0].source \"narratio.input.players\" is unsupported",
+		},
 		{
 			name: "duplicate source rejected",
 			pipelineYML: testPipelineBaseYAML + `
@@ -579,6 +597,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 		},
 		{
@@ -591,6 +611,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantErr: "session.inputs.audio_s3.prefix must be a relative path",
 		},
@@ -604,6 +626,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantErr: "session.inputs.audio_s3.prefix must not contain path traversal",
 		},
@@ -618,6 +642,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `,
 			wantErr: "mutually exclusive",
 		},
@@ -664,6 +690,8 @@ inputs:
  speakers_file: ./speakers.yml
  autocorrect_file: ./autocorrect.yml
  glossary_file: ./glossary.yml
+  players_file: ./players.yml
+  party_file: ./party.yml
 `
 	pipelinePath, sessionPath := writeConfigFiles(t, pipelineYAML, sessionYAML)
 	cfg, err := Load(pipelinePath, sessionPath)
--- a/internal/config/validate.go
+++ b/internal/config/validate.go
@@ -51,6 +51,21 @@ func validateCampaign(cfg *CampaignConfig) error {
 	if CampaignID(cfg) == "" {
 		return fmt.Errorf("campaign.campaign_id is required")
 	}
+	if strings.TrimSpace(cfg.Inputs.SpeakersFile) == "" {
+		return fmt.Errorf("campaign.inputs.speakers_file is required")
+	}
+	if strings.TrimSpace(cfg.Inputs.AutocorrectFile) == "" {
+		return fmt.Errorf("campaign.inputs.autocorrect_file is required")
+	}
+	if strings.TrimSpace(cfg.Inputs.GlossaryFile) == "" {
+		return fmt.Errorf("campaign.inputs.glossary_file is required")
+	}
+	if strings.TrimSpace(cfg.Inputs.PlayersFile) == "" {
+		return fmt.Errorf("campaign.inputs.players_file is required")
+	}
+	if strings.TrimSpace(cfg.Inputs.PartyFile) == "" {
+		return fmt.Errorf("campaign.inputs.party_file is required")
+	}
 	return nil
 }

@@ -595,6 +610,12 @@ func validateSession(cfg *SessionConfig) error {
 	if strings.TrimSpace(cfg.Inputs.GlossaryFile) == "" {
 		return fmt.Errorf("session.inputs.glossary_file is required")
 	}
+	if strings.TrimSpace(cfg.Inputs.PlayersFile) == "" {
+		return fmt.Errorf("session.inputs.players_file is required")
+	}
+	if strings.TrimSpace(cfg.Inputs.PartyFile) == "" {
+		return fmt.Errorf("session.inputs.party_file is required")
+	}

 	hasAudioDir := strings.TrimSpace(cfg.Inputs.AudioDir) != ""
 	hasAudioFiles := len(cfg.Inputs.AudioFiles) > 0