2026-08-30 14:15:57 +00:00
package config
import (
"path/filepath"
"reflect"
"sort"
"strings"
"testing"
)
2026-09-07 03:54:41 +00:00
func absolutePath ( t * testing . T , path string ) string {
t . Helper ( )
absolute , err := filepath . Abs ( path )
if err != nil {
t . Fatal ( err )
}
return absolute
}
2026-08-30 14:15:57 +00:00
func TestArtifactFamiliesExpandCanonicalCharactersDeterministically ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , dir + "/party.yml" , ` schema_version : narratio . party . v1
characters :
zeta :
player : { name : Zara }
character :
name : Zeta
alias : [ Z ]
classes : [ { name : wizard , level : 8 } , { name : fighter } ]
alpha :
player : { name : Ada }
character :
name : Alpha
alias : [ A , The First ]
classes : [ { name : ranger } ]
` )
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , artifactFamilyPipelineYAML ( `
character_items :
enabled : false
for_each : party . characters
prompt_id : dnd . character_items
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / items . md
inputs :
transcript : { source : narratio . transcript . final_trimmed , required : true }
member_vars :
id : character_id
player : player . name
name : character . name
classes : character . class_summary
aliases : character . alias_summary
vars :
static_flag : true
character_meta :
enabled : true
for_each : party . characters
prompt_id : dnd . character_meta
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / meta . md
inputs :
transcript : { source : narratio . transcript . final_trimmed , required : true }
` ) )
cfg , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err != nil {
t . Fatalf ( "LoadWithSessionOptions() error = %v" , err )
}
if err := Validate ( cfg ) ; err != nil {
t . Fatalf ( "Validate() error = %v" , err )
}
if len ( cfg . Pipeline . Scriptorium . ArtifactFamilies ) != 0 {
t . Fatalf ( "adapter-facing artifact families = %#v, want none" , cfg . Pipeline . Scriptorium . ArtifactFamilies )
}
keys := sortedArtifactKeys ( cfg . Pipeline . Scriptorium . Artifacts )
wantKeys := [ ] string { "character_items_alpha" , "character_items_zeta" , "character_meta_alpha" , "character_meta_zeta" }
if ! reflect . DeepEqual ( keys , wantKeys ) {
t . Fatalf ( "artifact keys = %#v, want %#v" , keys , wantKeys )
}
alpha := cfg . Pipeline . Scriptorium . Artifacts [ "character_items_alpha" ]
if alpha . Enabled || alpha . OutputPath != "artifacts/characters/alpha/items.md" {
t . Fatalf ( "alpha artifact = %#v" , alpha )
}
if ! reflect . DeepEqual ( alpha . Vars , map [ string ] any {
"static_flag" : true , "id" : "alpha" , "player" : "Ada" , "name" : "Alpha" , "classes" : "ranger" , "aliases" : "A, The First" ,
} ) {
t . Fatalf ( "alpha vars = %#v" , alpha . Vars )
}
zeta := cfg . Pipeline . Scriptorium . Artifacts [ "character_items_zeta" ]
if got := zeta . Vars [ "classes" ] ; got != "wizard 8 / fighter" {
t . Fatalf ( "zeta class summary = %#v" , got )
}
catalog := ArtifactFamilies ( cfg . Pipeline )
2026-10-04 13:34:27 +00:00
if got , want := catalog . Families [ "character_meta" ] . Sources , [ ] string { absolutePath ( t , pipelinePath ) } ; ! reflect . DeepEqual ( got , want ) {
t . Fatalf ( "family sources = %#v, want %#v" , got , want )
2026-08-30 14:56:22 +00:00
}
2026-08-30 14:15:57 +00:00
if got := catalog . Families [ "character_meta" ] . Members ; ! reflect . DeepEqual ( got , [ ] string { "character_meta_alpha" , "character_meta_zeta" } ) {
t . Fatalf ( "meta members = %#v" , got )
}
2026-10-04 13:34:27 +00:00
if got := catalog . Members [ "character_items_zeta" ] ; got . Family != "character_items" || got . CharacterID != "zeta" {
2026-08-30 14:15:57 +00:00
t . Fatalf ( "zeta origin = %#v" , got )
}
firstDigest := EffectivePipelineDigest ( cfg . Pipeline )
writePartyResolutionFile ( t , dir + "/party.yml" , ` schema_version : narratio . party . v1
characters :
alpha :
player : { name : Ada }
character :
name : Alpha
alias : [ A , The First ]
classes : [ { name : ranger } ]
zeta :
player : { name : Zara }
character :
name : Zeta
alias : [ Z ]
classes : [ { name : wizard , level : 8 } , { name : fighter } ]
` )
again , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err != nil {
t . Fatalf ( "reordered LoadWithSessionOptions() error = %v" , err )
}
if ! reflect . DeepEqual ( cfg . Pipeline . Scriptorium . Artifacts , again . Pipeline . Scriptorium . Artifacts ) || ! reflect . DeepEqual ( ArtifactFamilies ( cfg . Pipeline ) , ArtifactFamilies ( again . Pipeline ) ) || firstDigest != EffectivePipelineDigest ( again . Pipeline ) {
t . Fatalf ( "reordered source maps changed expansion" )
}
}
func TestArtifactFamiliesRejectInvalidExpansionDeclarations ( t * testing . T ) {
tests := [ ] struct {
name string
party string
families string
wantError string
} {
2026-09-02 11:57:51 +00:00
{ name : "unversioned party" , party : "characters: {}\n" , families : validFamilyYAML , wantError : "schema_version is required" } ,
2026-08-30 14:15:57 +00:00
{ name : "invalid iteration" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "party.characters" , "party.players" , 1 ) , wantError : ".for_each must be" } ,
{ name : "invalid token" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "{character_id}" , "{character_name}" , 1 ) , wantError : "must contain exactly one" } ,
{ name : "repeated token" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "meta.md" , "{character_id}.md" , 1 ) , wantError : "must contain exactly one" } ,
{ name : "member selector" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "character.name" , "character.unknown" , 1 ) , wantError : "selector" } ,
{ name : "static variable collision" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "member_vars:\n character_name" , "vars:\n character_name: static\n member_vars:\n character_name" , 1 ) , wantError : "conflicts with static vars" } ,
{ name : "unsafe output" , party : canonicalPartyFixture , families : strings . Replace ( validFamilyYAML , "artifacts/characters/{character_id}/meta.md" , "../{character_id}.md" , 1 ) , wantError : "must not contain path traversal" } ,
}
for _ , test := range tests {
t . Run ( test . name , func ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , dir + "/party.yml" , test . party )
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , artifactFamilyPipelineYAML ( test . families ) )
_ , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err == nil || ! strings . Contains ( err . Error ( ) , test . wantError ) {
t . Fatalf ( "LoadWithSessionOptions() error = %v, want %q" , err , test . wantError )
}
} )
}
}
func TestArtifactFamilyStrictDecodeRejectsUnknownFields ( t * testing . T ) {
dir := t . TempDir ( )
pipelinePath , _ , _ := writeArtifactFamilyConfig ( t , dir , artifactFamilyPipelineYAML ( validFamilyYAML + " unsupported: true\n" ) )
_ , err := LoadPipeline ( pipelinePath )
2026-09-07 03:54:41 +00:00
if err == nil || ! strings . Contains ( err . Error ( ) , "decode.unknown_field" ) {
2026-08-30 14:15:57 +00:00
t . Fatalf ( "LoadPipeline() error = %v" , err )
}
}
func TestArtifactFamiliesRejectGeneratedKeyAndOutputCollisions ( t * testing . T ) {
document , err := ParseParty ( [ ] byte ( canonicalPartyFixture ) )
if err != nil {
t . Fatal ( err )
}
base := ScriptoriumArtifactFamilyConfig {
ForEach : partyCharactersFamilySource , PromptID : "dnd.character_meta" ,
OutputPathPattern : "artifacts/characters/{character_id}/meta.md" ,
}
for _ , test := range [ ] struct {
name string
artifacts map [ string ] ScriptoriumArtifactConfig
wantError string
} {
{
name : "generated key" , artifacts : map [ string ] ScriptoriumArtifactConfig {
"character_meta_arannis" : { OutputPath : "artifacts/other.md" } ,
} , wantError : "generates artifact key" ,
} ,
{
name : "generated output" , artifacts : map [ string ] ScriptoriumArtifactConfig {
"existing" : { OutputPath : "artifacts/characters/arannis/meta.md" } ,
} , wantError : "generates output path" ,
} ,
} {
t . Run ( test . name , func ( t * testing . T ) {
pipeline := & PipelineConfig {
Scriptorium : & ScriptoriumConfig { Artifacts : test . artifacts } ,
resolution : & pipelineResolutionMetadata { artifactFamilies : map [ string ] ScriptoriumArtifactFamilyConfig { "character_meta" : base } } ,
}
2026-09-02 12:04:35 +00:00
err := expandPipelineArtifactFamilies ( pipeline , ResolvedParty { Canonical : document } )
2026-08-30 14:15:57 +00:00
if err == nil || ! strings . Contains ( err . Error ( ) , test . wantError ) {
t . Fatalf ( "expandPipelineArtifactFamilies() error = %v, want %q" , err , test . wantError )
}
} )
}
}
2026-08-30 14:20:03 +00:00
func TestArtifactFamiliesExpandSameMemberDependenciesAndInputs ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , filepath . Join ( dir , "party.yml" ) , ` schema_version : narratio . party . v1
characters :
arannis :
player : { name : Eric }
character : { name : Arannis , classes : [ { name : wizard } ] }
bryn :
player : { name : Bri }
character : { name : Bryn , classes : [ { name : fighter } ] }
` )
families := `
character_meta :
enabled : true
for_each : party . characters
prompt_id : dnd . character_meta
output_path_pattern : artifacts / characters / { character_id } / meta . md
character_items :
enabled : true
for_each : party . characters
prompt_id : dnd . character_items
output_path_pattern : artifacts / characters / { character_id } / items . md
depends_on : [ session_recap ]
inputs :
transcript : { source : narratio . transcript . final_trimmed , required : true }
prior_meta : { source : narratio . member_artifact . character_meta , required : true }
`
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , strings . Replace ( artifactFamilyPipelineYAML ( families ) , " artifact_families:" , " artifacts:\n session_recap:\n enabled: false\n output_path: artifacts/session_recap.md\n artifact_families:" , 1 ) )
cfg , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err != nil {
t . Fatal ( err )
}
items := cfg . Pipeline . Scriptorium . Artifacts [ "character_items_arannis" ]
2026-09-07 04:39:49 +00:00
if ! reflect . DeepEqual ( items . DependsOn , [ ] string { "character_meta_arannis" , "session_recap" } ) {
2026-08-30 14:20:03 +00:00
t . Fatalf ( "member dependencies = %#v" , items . DependsOn )
}
if got := items . Inputs [ "prior_meta" ] . Source ; got != "narratio.artifact.character_meta_arannis" {
t . Fatalf ( "rewritten member source = %q" , got )
}
catalog := ArtifactFamilies ( cfg . Pipeline )
if got := catalog . Members [ "character_items_arannis" ] ; ! reflect . DeepEqual ( got . Dependencies , items . DependsOn ) || got . Inputs [ "prior_meta" ] != "narratio.artifact.character_meta_arannis" {
t . Fatalf ( "member provenance = %#v" , got )
}
for key , artifact := range cfg . Pipeline . Scriptorium . Artifacts {
for name , input := range artifact . Inputs {
if strings . Contains ( input . Source , "narratio.member_artifact." ) {
t . Fatalf ( "unresolved source at %s.%s = %q" , key , name , input . Source )
}
}
}
}
func TestArtifactFamiliesRejectInvalidMemberDependenciesAndSources ( t * testing . T ) {
for _ , test := range [ ] struct { name , families , want string } {
{ name : "missing family" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "member_dependencies: [missing]\n member_vars:" , 1 ) , want : "unknown family" } ,
{ name : "self dependency" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "member_dependencies: [character_meta]\n member_vars:" , 1 ) , want : "must not reference its own family" } ,
{ name : "duplicate dependency" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "member_dependencies: [other, other]\n member_vars:" , 1 ) + `
other :
for_each : party . characters
output_path_pattern : artifacts / characters / { character_id } / other . md
` , want : "duplicates family" } ,
2026-09-07 04:39:49 +00:00
{ name : "missing inferred family dependency" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "inputs:\n prior: {source: narratio.member_artifact.missing, required: true}\n member_vars:" , 1 ) , want : "pipeline.scriptorium.artifact_families.character_meta.inputs.prior.source" } ,
{ name : "self inferred family dependency" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "inputs:\n prior: {source: narratio.member_artifact.character_meta, required: true}\n member_vars:" , 1 ) , want : "pipeline.scriptorium.artifact_families.character_meta.inputs.prior.source" } ,
2026-08-30 14:20:03 +00:00
{ name : "transitive cycle" , families : strings . Replace ( validFamilyYAML , "member_vars:" , "member_dependencies: [other]\n member_vars:" , 1 ) + `
other :
for_each : party . characters
output_path_pattern : artifacts / characters / { character_id } / other . md
member_dependencies : [ character_meta ]
` , want : "dependencies must not contain cycles" } ,
} {
t . Run ( test . name , func ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , filepath . Join ( dir , "party.yml" ) , canonicalPartyFixture )
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , artifactFamilyPipelineYAML ( test . families ) )
_ , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err == nil || ! strings . Contains ( err . Error ( ) , test . want ) {
t . Fatalf ( "error = %v, want %q" , err , test . want )
}
} )
}
pipeline := & PipelineConfig {
Scriptorium : & ScriptoriumConfig { Artifacts : map [ string ] ScriptoriumArtifactConfig {
"explicit" : { Inputs : map [ string ] ScriptoriumInputConfig {
"bad" : { Source : "narratio.member_artifact.character_meta" } ,
} } ,
} } ,
resolution : & pipelineResolutionMetadata { artifactFamilies : map [ string ] ScriptoriumArtifactFamilyConfig {
"character_meta" : { ForEach : partyCharactersFamilySource , OutputPathPattern : "artifacts/{character_id}.md" } ,
} } ,
}
document , err := ParseParty ( [ ] byte ( canonicalPartyFixture ) )
if err != nil {
t . Fatal ( err )
}
2026-09-02 12:04:35 +00:00
if err := expandPipelineArtifactFamilies ( pipeline , ResolvedParty { Canonical : document } ) ; err == nil || ! strings . Contains ( err . Error ( ) , "outside an artifact family" ) {
2026-08-30 14:20:03 +00:00
t . Fatalf ( "concrete member source error = %v" , err )
}
pipeline . Scriptorium . Artifacts [ "explicit" ] = ScriptoriumArtifactConfig { Inputs : map [ string ] ScriptoriumInputConfig { "bad" : { Source : "narratio.member_artifact." } } }
pipeline . resolution . artifactFamiliesExpanded = false
2026-09-02 12:04:35 +00:00
if err := expandPipelineArtifactFamilies ( pipeline , ResolvedParty { Canonical : document } ) ; err == nil || ! strings . Contains ( err . Error ( ) , "malformed member artifact source" ) {
2026-08-30 14:20:03 +00:00
t . Fatalf ( "malformed concrete member source error = %v" , err )
}
}
2026-08-30 14:30:07 +00:00
func TestFamilyPublishRulesExpandToConcreteArtifacts ( t * testing . T ) {
required := true
cfg := & PipelineConfig {
Scriptorium : & ScriptoriumConfig { Artifacts : map [ string ] ScriptoriumArtifactConfig {
"character_meta_alpha" : { OutputPath : "artifacts/characters/alpha/meta.md" } ,
"character_meta_zeta" : { OutputPath : "artifacts/characters/zeta/meta.md" } ,
} } ,
2026-10-04 13:10:53 +00:00
Publish : & PublishConfig { } ,
2026-08-30 14:30:07 +00:00
}
catalog := ArtifactFamilyCatalog { Families : map [ string ] ArtifactFamilyOrigin {
"character_meta" : { Members : [ ] string { "character_meta_alpha" , "character_meta_zeta" } , Publish : & ScriptoriumArtifactFamilyPublishConfig { Enabled : true , Required : required , DestPattern : "published/{character_id}.md" } } ,
} , Members : map [ string ] ArtifactFamilyMemberOrigin {
"character_meta_alpha" : { CharacterID : "alpha" } , "character_meta_zeta" : { CharacterID : "zeta" } ,
} }
if err := expandFamilyPublishRules ( cfg , catalog ) ; err != nil {
t . Fatal ( err )
}
if got := cfg . Publish . Outputs ; len ( got ) != 2 || got [ 0 ] . Source != "narratio.artifact.character_meta_alpha" || got [ 0 ] . Dest != "published/alpha.md" || got [ 0 ] . Required == nil || ! * got [ 0 ] . Required {
t . Fatalf ( "generated publish rules = %#v" , got )
}
cfg . Publish . Outputs = nil
catalog . Families [ "character_meta" ] = ArtifactFamilyOrigin { Members : [ ] string { "character_meta_alpha" } , Publish : & ScriptoriumArtifactFamilyPublishConfig { Enabled : true } }
2026-10-04 13:10:53 +00:00
cfg . Publish = nil
2026-08-30 14:30:07 +00:00
if err := expandFamilyPublishRules ( cfg , catalog ) ; err == nil || ! strings . Contains ( err . Error ( ) , "requires pipeline.publish" ) {
t . Fatalf ( "missing publish error = %v" , err )
}
}
2026-10-04 13:10:53 +00:00
func TestArtifactFamilyInheritanceAcrossImports ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , filepath . Join ( dir , "party.yml" ) , ` schema_version : narratio . party . v1
characters :
alice :
player : { name : Alice Player }
character :
name : Alice
classes : [ { name : wizard } ]
` )
2026-11-17 21:59:19 +00:00
pipeline := ` config :
2026-10-04 13:10:53 +00:00
imports :
- path : families / summary . yml
- path : families / notes . yml
whisperx :
transcribe_url : https : //transcription.example.test/transcribe
`
writePipelineFixture ( t , dir , "families/summary.yml" , ` scriptorium :
artifact_families :
character_summary :
enabled : true
for_each : party . characters
prompt_id : dnd . character_summary
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / summary . md
publish :
enabled : true
required : true
dest_pattern : published / characters / { character_id } / summary . md
` )
writePipelineFixture ( t , dir , "families/notes.yml" , ` scriptorium :
artifact_families :
character_notes :
extends : character_summary
output_path_pattern : artifacts / characters / { character_id } / notes . md
publish :
dest_pattern : published / characters / { character_id } / notes . md
` )
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , pipeline )
cfg , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err != nil {
t . Fatal ( err )
}
for key , wantPath := range map [ string ] string {
"character_summary_alice" : "artifacts/characters/alice/summary.md" ,
"character_notes_alice" : "artifacts/characters/alice/notes.md" ,
} {
artifact , ok := cfg . Pipeline . Scriptorium . Artifacts [ key ]
if ! ok {
t . Fatalf ( "inherited family member %q is missing" , key )
}
if ! artifact . Enabled || artifact . PromptID != "dnd.character_summary" || artifact . ProfileID != "production" || artifact . OutputPath != wantPath {
t . Fatalf ( "expanded family member %q = %#v" , key , artifact )
}
}
wantPublish := map [ string ] string {
"narratio.artifact.character_summary_alice" : "published/characters/alice/summary.md" ,
"narratio.artifact.character_notes_alice" : "published/characters/alice/notes.md" ,
}
for _ , rule := range cfg . Pipeline . Publish . Outputs {
if want , ok := wantPublish [ rule . Source ] ; ok {
if rule . Dest != want {
t . Errorf ( "family publish destination for %q = %q, want %q" , rule . Source , rule . Dest , want )
}
delete ( wantPublish , rule . Source )
}
}
if len ( wantPublish ) != 0 {
t . Fatalf ( "inherited family publish rules missing: %#v" , wantPublish )
}
}
2026-10-04 14:00:55 +00:00
func TestInheritedAndExpandedConfigurationsHaveEqualEffectiveSemantics ( t * testing . T ) {
load := func ( t * testing . T , expanded bool ) * Config {
t . Helper ( )
dir := t . TempDir ( )
writePartyResolutionFile ( t , filepath . Join ( dir , "party.yml" ) , ` schema_version : narratio . party . v1
characters :
alice :
player : { name : Alice Player }
character :
name : Alice
classes : [ { name : wizard } ]
` )
2026-11-17 21:59:19 +00:00
pipeline := ` config :
2026-10-04 14:00:55 +00:00
imports :
- path : definitions / parent . yml
- path : definitions / child . yml
whisperx :
transcribe_url : https : //transcription.example.test/transcribe
`
if expanded {
pipeline = ` whisperx :
transcribe_url : https : //transcription.example.test/transcribe
scriptorium :
artifacts :
base :
enabled : false
prompt_id : dnd . summary
profile_id : production
output_path : artifacts / base . md
render_debug : false
summary :
enabled : true
prompt_id : dnd . summary
profile_id : production
output_path : artifacts / summary . md
render_debug : false
artifact_families :
character_summary :
enabled : true
for_each : party . characters
prompt_id : dnd . character_summary
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / summary . md
character_notes :
enabled : true
for_each : party . characters
prompt_id : dnd . character_summary
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / notes . md
`
} else {
writePipelineFixture ( t , dir , "definitions/parent.yml" , ` scriptorium :
artifacts :
base :
enabled : false
prompt_id : dnd . summary
profile_id : production
output_path : artifacts / base . md
render_debug : false
artifact_families :
character_summary :
enabled : true
for_each : party . characters
prompt_id : dnd . character_summary
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / summary . md
` )
writePipelineFixture ( t , dir , "definitions/child.yml" , ` scriptorium :
artifacts :
summary :
extends : base
enabled : true
output_path : artifacts / summary . md
artifact_families :
character_notes :
extends : character_summary
output_path_pattern : artifacts / characters / { character_id } / notes . md
` )
}
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , pipeline )
cfg , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if err != nil {
t . Fatalf ( "LoadWithSessionOptions(expanded=%t): %v" , expanded , err )
}
return cfg
}
inherited := load ( t , false )
expanded := load ( t , true )
inheritedValues , err := EffectivePipelineValues ( inherited . Pipeline )
if err != nil {
t . Fatal ( err )
}
expandedValues , err := EffectivePipelineValues ( expanded . Pipeline )
if err != nil {
t . Fatal ( err )
}
if ! reflect . DeepEqual ( inheritedValues , expandedValues ) {
t . Fatalf ( "inherited and expanded effective values differ:\ninherited=%#v\nexpanded=%#v" , inheritedValues , expandedValues )
}
if inheritedDigest , expandedDigest := EffectivePipelineDigest ( inherited . Pipeline ) , EffectivePipelineDigest ( expanded . Pipeline ) ; inheritedDigest != expandedDigest {
t . Fatalf ( "inherited and expanded digests differ: %q != %q" , inheritedDigest , expandedDigest )
}
}
2026-09-07 11:52:57 +00:00
func TestExplicitFamilyMemberPublishDestinationResolution ( t * testing . T ) {
dir := t . TempDir ( )
writePartyResolutionFile ( t , filepath . Join ( dir , "party.yml" ) , ` schema_version : narratio . party . v1
characters :
alice :
player : { name : Alice Player }
character :
name : Alice
classes : [ { name : wizard } ]
` )
for _ , test := range [ ] struct {
name string
source string
dest string
wantDest string
wantErr string
} {
{
name : "derive generated member output" ,
source : "narratio.artifact.meta_alice" ,
wantDest : "artifacts/alice.md" ,
} ,
{
name : "preserve explicit override" ,
source : "narratio.artifact.meta_alice" ,
dest : "published/alice-summary.md" ,
wantDest : "published/alice-summary.md" ,
} ,
{
name : "reject unknown source" ,
source : "narratio.artifact.missing" ,
wantErr : "is unsupported" ,
} ,
} {
t . Run ( test . name , func ( t * testing . T ) {
publishDestination := ""
if test . dest != "" {
publishDestination = " dest: " + test . dest + "\n"
}
pipeline := artifactFamilyPipelineYAML ( `
meta :
enabled : true
for_each : party . characters
prompt_id : dnd . meta
profile_id : production
output_path_pattern : artifacts / { character_id } . md
` ) + `
publish :
outputs :
- source : ` + test . source + "\n" + publishDestination
pipelinePath , campaignPath , sessionPath := writeArtifactFamilyConfig ( t , dir , pipeline )
cfg , err := LoadWithSessionOptions ( pipelinePath , campaignPath , sessionPath , SessionLoadOptions { } )
if test . wantErr != "" {
if err == nil || ! strings . Contains ( err . Error ( ) , test . wantErr ) {
t . Fatalf ( "LoadWithSessionOptions() error = %v, want %q" , err , test . wantErr )
}
return
}
if err != nil {
t . Fatalf ( "LoadWithSessionOptions() error = %v" , err )
}
if got := cfg . Pipeline . Publish . Outputs [ 0 ] . Dest ; got != test . wantDest {
t . Fatalf ( "resolved runtime destination = %q, want %q" , got , test . wantDest )
}
effective , err := MarshalEffectivePipeline ( cfg . Pipeline )
if err != nil {
t . Fatal ( err )
}
if ! strings . Contains ( string ( effective ) , "dest: " + test . wantDest + "\n" ) {
t . Fatalf ( "effective pipeline omitted resolved destination:\n%s" , effective )
}
} )
}
}
2026-08-30 14:15:57 +00:00
const validFamilyYAML = `
character_meta :
enabled : true
for_each : party . characters
prompt_id : dnd . character_meta
profile_id : production
output_path_pattern : artifacts / characters / { character_id } / meta . md
member_vars :
character_name : character . name
`
func artifactFamilyPipelineYAML ( families string ) string {
lines := strings . Split ( strings . TrimPrefix ( families , "\n" ) , "\n" )
for index , line := range lines {
if line != "" {
lines [ index ] = " " + line
}
}
return "workspace:\n root: /tmp/narratio-work\nwhisperx:\n transcribe_url: https://example.test/transcribe\nnotification:\n mode: noop\nscriptorium:\n binary: scriptorium\n artifact_families:\n" + strings . Join ( lines , "\n" )
}
func writeArtifactFamilyConfig ( t * testing . T , dir , pipeline string ) ( string , string , string ) {
t . Helper ( )
pipelinePath := writePartyResolutionFile ( t , filepath . Join ( dir , "pipeline.yml" ) , pipeline )
campaignPath := writePartyResolutionFile ( t , filepath . Join ( dir , "campaign.yml" ) , "campaign_id: campaign\ninputs:\n speakers_file: speakers.yml\n autocorrect_file: autocorrect.yml\n glossary_file: glossary.yml\n party_file: party.yml\n" )
sessionPath := writePartyResolutionFile ( t , filepath . Join ( dir , "session.yml" ) , "session_id: session\ncampaign: campaign\ninputs:\n audio_dir: audio\n" )
return pipelinePath , campaignPath , sessionPath
}
func sortedArtifactKeys ( artifacts map [ string ] ScriptoriumArtifactConfig ) [ ] string {
keys := make ( [ ] string , 0 , len ( artifacts ) )
for key := range artifacts {
keys = append ( keys , key )
}
sort . Strings ( keys )
return keys
}