eric/narratio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 18 Wiki Activity

Add configuration source reporting

Browse Source
This commit is contained in:
Eric Rakestraw
2026-08-30 14:56:22 +00:00
parent a102db36af
commit dde7f76ecb
11 changed files with 654 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/config.md
View File

@@ -44,10 +44,10 @@ the durable copied session input.
### Read-only effective pipeline inspection
`narratio config validate` and `narratio config show` use the same `--config`,
`--campaign`, `--campaign-file`, and `--profile` selection rules as pipeline
commands, but do not select, discover, or load a session. They do not read
credential values or create runtime state.
`narratio config validate`, `narratio config show`, and `narratio config
sources` use the same `--config`, `--campaign`, `--campaign-file`, and
`--profile` selection rules as pipeline commands, but do not select, discover,
or load a session. They do not read credential values or create runtime state.
Campaign selection is optional only when the resolved pipeline has no
`scriptorium.artifact_families`. When families are declared, Narratio selects a
@@ -56,7 +56,11 @@ then parses the campaign-owned party and expands concrete artifacts and any
family publish rules before validation. `config validate` prints the resulting
root, profile, and effective digest. `config show` emits the normalized
effective pipeline YAML, with defaults and concrete expansion included but
composition and family declarations omitted. The [CLI reference](cli.md#config-validate-and-config-show)
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-and-config-sources)
owns command syntax and output conventions.
### Identity segments