Tidy up logging and rework tests from scratch

requirements/architecture.md

@@ -32,7 +32,7 @@
 ## High-Level Building Blocks
 
 - Frontend, CLI, API, or worker:
-  - A Click-based CLI in [`src/ffx/ffx.py`](/home/osgw/.local/src/codex/ffx/src/ffx/ffx.py).
+  - A Click-based CLI in [`src/ffx/cli.py`](/home/osgw/.local/src/codex/ffx/src/ffx/cli.py), exposed as the `ffx` command and via `python -m ffx`.
   - A Textual terminal UI rooted in [`src/ffx/ffx_app.py`](/home/osgw/.local/src/codex/ffx/src/ffx/ffx_app.py) with screens for shows, patterns, file inspection, tracks, tags, and shifted seasons.
 - Core business logic:
   - Descriptor objects model media files, shows, and tracks.
@@ -50,7 +50,7 @@
 - Key entities or records:
   - `Show`: canonical TV show metadata plus digit-formatting rules for generated filenames.
   - `Pattern`: regex rule tying filenames to one show and one target media schema.
-  - `Track` and `TrackTag`: persisted target stream layout, codec, dispositions, audio layout, and stream-level tags.
+  - `Track` and `TrackTag`: persisted target stream records, codec, dispositions, audio layout, and stream-level tags. Detailed source-to-target mapping rules live in `requirements/subtrack_mapping.md`.
   - `MediaTag`: persisted container-level metadata for a pattern.
   - `ShiftedSeason`: mapping from source numbering ranges to adjusted season and episode numbers.
   - `Property`: internal key-value storage currently used for database versioning.
@@ -63,7 +63,6 @@
   - Only supported media-file extensions are accepted for conversion.
   - Stored database version must match the runtime-required version.
   - A normalized descriptor may have at most one default and one forced stream per relevant track type.
-  - Stored target tracks must refer to valid source tracks of matching types.
   - Shifted-season ranges are intended not to overlap for the same show and season.
   - TMDB lookups require a show ID and season and episode numbers.
 - Error-handling approach: