# Maintained Examples

These files are safe, copyable starting points for Narratio configuration and
input structure. Replace placeholder identifiers, storage names, integration
URLs, and paths for the target environment. Field meanings and defaults belong
in the [configuration reference](../docs/config.md).

## Pipeline Configuration

- [Minimal pipeline](pipeline.minimal.yml): campaign discovery plus the required
  WhisperX URL.
- [Production-shaped pipeline](pipeline.production.yml): S3 storage, publish,
  external tools, and configured Scriptorium artifacts.
- [Production/testing split bundle](production-testing/pipeline.yml): explicit
  `conf.d` imports, a production default, and selectable production/testing
  overlays. It also demonstrates canonical-party artifact families and a
  testing-only disabled artifact. Validate it with:

  ```sh
  narratio config validate --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml
  narratio config diff production testing --config examples/production-testing/pipeline.yml --campaign-file examples/campaigns/sample-campaign/campaign.yml
  ```

  `config show` and `config sources` accept the same selectors and remain
  read-only.
- [Full annotated pipeline](pipeline.full.annotated.yml): every implemented
  pipeline section with explanatory comments.
- [Extraction subset pipeline](pipeline.extraction-subset.yml): a focused
  Scriptorium artifact consuming only three declared Notarius lanes.

The existing `internal/config` example test loads and validates each pipeline
with the sample campaign and a compatible local- or S3-audio session.

## Campaign And Session Configuration

- [Sample campaign](campaigns/sample-campaign/campaign.yml), its
  [session template](campaigns/sample-campaign/session.template.yml), and its
  adjacent stable inputs provide a complete campaign directory shape.
- [Local-audio session](session.local-audio.yml) and
  [S3-audio session](session.s3-audio.yml) are concrete session files.
- [Session template](session.template.yml) and the campaign-local equivalent
  demonstrate the narrow placeholder syntax consumed by `session init`; they
  are templates, not runtime session files.

## Input Fixtures

- [Speakers](speakers.yml), [autocorrect](autocorrect.yml), and
  [glossary](glossary.yml) show the standalone input shapes.
- The sample campaign references its local
  [speakers](campaigns/sample-campaign/speakers.yml),
  [autocorrect](campaigns/sample-campaign/autocorrect.yml),
  [glossary](campaigns/sample-campaign/glossary.yml), and canonical
  [party](campaigns/sample-campaign/party.yml) fixture, plus an optional
  [spell-catalog overlay](campaigns/sample-campaign/spell_catalog.json) that
  follows the Notarius v0.6 contract. Narratio derives the players projection
  from this party source; the campaign deliberately has no `players_file`.
- [Sample speaker audio](audio/sample-speaker.flac) is a text placeholder that
  reserves the expected filename and directory shape. Replace it with a real
  FLAC file before running transcription.

The examples contain environment-variable names but no credential values. They
use fictional campaign content and reserved example domains.