Updated documentation

docs/CLI.md

@@ -66,6 +66,7 @@ uv run stt-daemon clear
 uv run stt-daemon clear --yes
 ```
 
+The provisioning state lives in `audio.json` (or `$STT_DAEMON_STATE`) in the current directory.
 This unloads all tracked modules and removes the state file. If
 `audio.json` is already gone (reboot, manual
 delete, crash), `clear --yes` still finds orphaned modules by name
@@ -114,7 +115,7 @@ uv run stt-tui
 ### `speaker-enroll` — Pre-enroll a speaker from WAV files
 
 ```bash
-uv run stt-daemon speaker-enroll --name Efren --wav audio/2026-09-28/143022-123-pause.wav
+uv run stt-daemon speaker-enroll --name Efren --wav transcripts/2026-09-28-14-30-22/audio/143022-123-pause.wav
 ```
 
 Registers a known speaker up front, without waiting for the daemon to mint a provisional id
@@ -138,14 +139,14 @@ Example with several clips:
 
 ```bash
 uv run stt-daemon speaker-enroll --name Efren \
-  --wav audio/2026-09-28/143022-123-pause.wav \
-  --wav audio/2026-09-28/150210-456-end_of_turn.wav
+  --wav transcripts/2026-09-28-14-30-22/audio/143022-123-pause.wav \
+  --wav transcripts/2026-09-28-14-30-22/audio/150210-456-end_of_turn.wav
 ```
 
 ### `speaker-enroll-seed` — Assisted enrollment from a seed clip
 
 ```bash
-uv run stt-daemon speaker-enroll-seed --name "Efren Yevale Varela" --seed audio/efren-seed.wav
+uv run stt-daemon speaker-enroll-seed --name "Efren Yevale Varela" --seed clips/efren-seed.wav
 ```
 
 Enrolls from ONE clip you are certain is the speaker. The command scans `--audio-dir` (default
@@ -175,7 +176,7 @@ Example, accepting three reviewed clips non-interactively:
 
 ```bash
 uv run stt-daemon speaker-enroll-seed --name "Efren Yevale Varela" \
-  --seed audio/efren-seed.wav --count 3 --yes
+  --seed clips/efren-seed.wav --count 3 --yes
 ```
 
 **Tuning and rebuilding.** Running either enrollment command for a name that already exists

docs/CONFIGURATION.md

@@ -66,7 +66,7 @@ monitor_output        = false                  # Loop sink.monitor → default s
 stdout          = true               # Print transcripts to stdout
 jsonl           = false              # Persist transcripts to JSONL files (off by default for agent-only use)
 session_dir     = "transcripts"      # Conversation root: one folder per conversation, named by the first transcription's YYYY-MM-DD-HH-MM-SS
-save_audio      = false              # Also write each transcribed utterance as a 16 kHz mono WAV
+save_audio      = false              # Also write each transcribed utterance as a 16 kHz mono WAV under <session_dir>/<id>/audio/
 session_gap_min = 5.0                # Quiet gap in minutes before a new conversation starts; <= 0 disables rollover
 
 [daemon]

docs/SPEAKERS.md

@@ -149,16 +149,16 @@ speaker up front from clips you already have, run `stt-daemon speaker-enroll` wi
 more WAV files:
 
 ```bash
-uv run stt-daemon speaker-enroll --name Efren --wav audio/2026-09-28/143022-123-pause.wav
-```
+uv run stt-daemon speaker-enroll --name Efren \
+  --wav transcripts/2026-09-28-14-30-22/audio/143022-123-pause.wav
 
 Repeat `--wav` to enroll from several clips; each file contributes one prototype, capped at
 `max_prototypes` with the oldest evicted:
 
 ```bash
 uv run stt-daemon speaker-enroll --name Efren \
-  --wav audio/2026-09-28/143022-123-pause.wav \
-  --wav audio/2026-09-28/150210-456-end_of_turn.wav
+  --wav transcripts/2026-09-28-14-30-22/audio/143022-123-pause.wav \
+  --wav transcripts/2026-09-28-14-30-22/audio/150210-456-end_of_turn.wav
 ```
 
 On success the command prints `enrolled 'Efren' as spk_0002 (2 clip(s), 7.4s)`. The `--name`
@@ -167,7 +167,8 @@ is the same global override as every other subcommand.
 
 Each WAV must be **16 kHz mono 16-bit PCM**. No resampling is performed: stereo, a different
 sample rate, or a non-WAV file is rejected with a clear error. The clips the daemon saves
-under `<session_dir>/<YYYY-MM-DD-HH-MM-SS>/audio/` when `[output].save_audio = true` are already in that format, so
+under `<session_dir>/<YYYY-MM-DD-HH-MM-SS>/audio/` (default `transcripts/…`) when
+`[output].save_audio = true` are already in that format, so
 they need no conversion. Each clip must also be at least `[speaker].min_enroll_s` seconds
 (default `2.0`); shorter clips are rejected. This is the "is it enough audio?" check.
 
@@ -196,7 +197,7 @@ clip you are certain is the speaker, finds the clips in the audio directory that
 to it, and lets you review each one before it joins the profile:
 
 ```bash
-uv run stt-daemon speaker-enroll-seed --name "Efren Yevale Varela" --seed audio/efren-seed.wav
+uv run stt-daemon speaker-enroll-seed --name "Efren Yevale Varela" --seed clips/efren-seed.wav
 ```
 
 Flags: