Normalize the default configuration discovery paths for all three config files, and update documentation and tests accordingly

docs/config.md

@@ -28,7 +28,15 @@ Behavior:
 
 ## 2. Config file discovery
 
-Pipeline config lookup for `run`, `plan`, `resume`, `run-stage`, and `restore`:
+These commands use the same config discovery behavior:
+
+- `narratio run`
+- `narratio plan`
+- `narratio resume`
+- `narratio run-stage`
+- `narratio restore`
+
+Pipeline config lookup:
 
 - if `--config <path>` is provided, that path is used.
 - if omitted, Narratio searches in order:
@@ -36,30 +44,29 @@ Pipeline config lookup for `run`, `plan`, `resume`, `run-stage`, and `restore`:
   2. `/etc/narratio/pipeline.yml`
 - first existing file wins.
 
-Campaign config lookup for `run`, `plan`, `resume`, `run-stage`, and `restore`:
+Campaign config lookup:
 
 - if `--campaign <path>` is provided, that path is used.
 - if omitted, Narratio searches in order:
-  1. `./campaign.yml`
-  2. `/usr/local/etc/narratio/campaign.yml`
-  3. `/etc/narratio/campaign.yml`
+  1. `/usr/local/etc/narratio/campaign.yml`
+  2. `/etc/narratio/campaign.yml`
 - first existing file wins.
 
-## 3. Session file discovery and templating
-
-Session config lookup for `run`, `plan`, `resume`, `run-stage`, and `restore`:
+Session config lookup:
 
 - if `--session <path>` is provided, that path is used.
 - if `--session` is omitted, Narratio searches locally in order:
-  1. `./session.yml`
-  2. `/usr/local/etc/narratio/session.yml`
-  3. `/etc/narratio/session.yml`
+  1. `/usr/local/etc/narratio/session.yml`
+  2. `/etc/narratio/session.yml`
 - first existing local file wins.
 - if no local session file is found, `--session-id <value>` is present, storage is configured, and campaign identity is resolved, Narratio loads remote `session.yml` from:
   - `{root_prefix}/campaigns/{campaign}/sessions/{session_id}/session.yml`
 - local discovery always runs before remote fallback.
+- local files in the current working directory are used only when passed explicitly, for example `--config ./pipeline.yml --campaign ./campaign.yml --session ./session.yml`.
 
-Template behavior:
+## 3. Session templating
+
+Template behavior for local and remote `session.yml`:
 
 - supported placeholders:
   - `{{session_id}}`
@@ -72,7 +79,9 @@ Template behavior:
 - if rendered `session_id` mismatches `--session-id`, load fails.
 - if rendered `previous_session_id` mismatches `--previous-session-id`, load fails.
 
-## 4. Minimal pipeline config
+## 4. Minimal config set
+
+### `pipeline.yml`
 
 ```yaml
 whisperx:
@@ -85,9 +94,7 @@ Why this is sufficient:
 - `workspace.root` defaults to `/var/lib/narratio`.
 - optional sections (`seriatim`, `audita`, `archive`, `scriptorium`, `trim`, `normalize`, etc.) receive defaults or stay inactive.
 
-## 5. Minimal session template
-
-`campaign.yml`:
+### `campaign.yml`
 
 ```yaml
 campaign: sample-campaign
@@ -97,7 +104,12 @@ inputs:
   glossary_file: ./glossary.yml
 ```
 
-`session.yml`:
+Why this is sufficient:
+
+- `campaign` supplies the stable campaign identity.
+- stable input files are required and resolve relative to `campaign.yml` when copied during `prepare`.
+
+### `session.yml`
 
 ```yaml
 session_id: "{{ session_id }}"
@@ -105,7 +117,14 @@ inputs:
   audio_dir: ./audio
 ```
 
-Usage:
+Why this is sufficient:
+
+- `session_id` is required and can be rendered from `--session-id`.
+- `campaign` can be omitted because it is supplied by `campaign.yml`.
+- stable input paths can be omitted because `campaign.yml` supplies defaults.
+- local `audio_dir` resolves relative to `session.yml`.
+
+Minimal local-file usage:
 
 ```bash
 narratio run --config /path/to/pipeline.yml --campaign ./campaign.yml --session ./session.yml --session-id 2026-05-03
@@ -124,7 +143,9 @@ inputs:
 narratio run --config /path/to/pipeline.yml --campaign ./campaign.yml --session ./session.yml --session-id 2026-05-03 --previous-session-id 2026-04-26
 ```
 
-## 6. Production-oriented config
+## 5. Production-oriented config set
+
+### `pipeline.yml`
 
 ```yaml
 workspace:
@@ -176,6 +197,42 @@ scriptorium:
           required: false
 ```
 
+### `campaign.yml`
+
+```yaml
+campaign: forsaken
+inputs:
+  speakers_file: /srv/narratio/campaigns/forsaken/speakers.yml
+  autocorrect_file: /srv/narratio/campaigns/forsaken/autocorrect.yml
+  glossary_file: /srv/narratio/campaigns/forsaken/glossary.yml
+```
+
+### Local `session.yml`
+
+```yaml
+session_id: "{{ session_id }}"
+previous_session_id: "{{ previous_session_id }}"
+date: 2026-05-03
+title: The Black Cabin
+inputs:
+  audio_s3:
+    prefix: audio/
+```
+
+### S3-first session config
+
+For S3-first operation, upload the same `session.yml` content to:
+
+```text
+{root_prefix}/campaigns/{campaign}/sessions/{session_id}/session.yml
+```
+
+Then run with explicit or discovered pipeline/campaign config and no `--session`:
+
+```bash
+narratio run --config /usr/local/etc/narratio/pipeline.yml --campaign /usr/local/etc/narratio/campaign.yml --session-id 2026-05-03 --previous-session-id 2026-04-26
+```
+
 Operational notes:
 
 - archive promotion is explicit and source-based via `archive.promote_artifacts`.
@@ -184,7 +241,7 @@ Operational notes:
 - Narratio does not auto-promote all generated analyze artifacts.
 - `restore` reads the same config/campaign/session inputs and restore scope is bounded by committed archive current state.
 
-## 7. Full pipeline reference
+## 6. Full pipeline reference
 
 | Path | Type | Required | Default |
 | --- | --- | --- | --- |
@@ -336,7 +393,7 @@ Restore-related implications:
 - restore remote identity requires archive S3 identity to resolve (`pipeline.storage.s3.bucket` and session prefix derivation inputs).
 - restore scope considers committed current state and durable paths (`manifest.json`, `transcripts/**`, `artifacts/**`, `previous/**`, optional `audio/**`).
 
-## 8. Full campaign reference
+## 7. Full campaign reference
 
 | Path | Type | Required | Default |
 | --- | --- | --- | --- |
@@ -347,7 +404,7 @@ Restore-related implications:
 
 Campaign input paths may be absolute or relative. Relative paths resolve from the directory containing `campaign.yml`.
 
-## 9. Full session reference
+## 8. Full session reference
 
 | Path | Type | Required | Default |
 | --- | --- | --- | --- |
@@ -378,7 +435,7 @@ Previous-session rule:
 - if `session.previous_session_id` is set, it must not equal `session.session_id`.
 - canonical previous-session sources (`narratio.previous_session.artifact.<name>`) are hydrated during `prepare` from archive current state when required by enabled configured artifacts.
 
-## 10. Secrets
+## 9. Secrets
 
 Narratio supports filesystem-based secret injection via `pipeline.secrets.env_dir`.
 
@@ -397,7 +454,7 @@ Guidance:
 - do not put secret values directly in YAML.
 - configure env var names in config and provide values via env/secrets files.
 
-## 11. Examples
+## 10. Examples
 
 Maintained examples: