First entry in the new specs/ directory. Specifies the layout and
semantics of the per-show .alfred/ sidecar that will back the future
concrete TVShowRepository:
- One .alfred/ directory per show, containing show.yaml + one
season_NN.yaml per season (zero-padded, season_00 for Specials).
- Per-episode entries store file size + mtime so cache lookups skip
a full ffprobe rescan when nothing changed.
- Self-healing on drift (file missing/modified/new) without raising.
- Atomic writes via temp file + os.replace().
- Phased implementation plan (builder + freeze first, then
serializer, then cache validator, then repo, then wiring).
No code yet — spec only, awaiting review before the implementation
phases. Companion entry in CHANGELOG (Added).
francwa
1427c8a54b