[2026-09-26] eagle: personal/tech/music-tags-final-review.md personal/tech/music-tags-repair-truenas.md

personal/tech/music-tags-final-review.md

@@ -18,32 +18,56 @@ related:
 
 _Обновлено: 2026-09-26. Источник: `~/Downloads/music-tags/tag-fix-plan.csv`._
 
-> ## ✅ 32-я волна ЗАКРЫТА — написания артистов сведены, сводки честные
-> **Построчное чтение завершено: 1–7906 (100%).**
+> ## 🔴 33-я волна — АППРУВ ЗАБЛОКИРОВАН: из сводок пропали 562 сказки
+>
+> **Построчное чтение завершено: 1–7906 (100%).** Правки продолжаются по спискам Alex.
 > 28-я волна: **сквозная нумерация треков по дискам** (9 многодисковых альбомов) — ✅ ГОТОВО.
 > 29-я волна: **5 замечаний Alex** + 597 треков без `new_track` — ✅ применено.
 > 30-я волна: **`single` переопределён** = артист ровно с 1 треком; Benassi добит из треклистов.
 > 31-я волна: **сведены все написания артистов** + срезан номер из `artist` + мусор `.wma`.
-> 32-я волна: **срезан префикс диджея-сборника** (`DJ Tiesto - <артист>` ×13),
-> инициалы → полные имена (`А. Апина`, `Пугачева`, `Губин`, `А.Маршал`, `К. Орбакайте`…),
-> мусор-плейсхолдеры (`Сбрник`, `Классика`), `В. Высоцкий - Песня о друге (Вертикаль OST)`.
-> ✅ **Итог: `single` 652 + `multi` 6650 = 7302** (пустой `artist` выброшен из обеих сводок).
+> 32-я волна: **срезан префикс диджея-сборника** (`DJ Tiesto - <артист>` ×13), инициалы → имена.
+> 33-я волна: **сведены `Алексин`/`Баста`/`Шнуров`/`Бутусов`/`Ю-Питер`** (57 правок, `batchZ`),
+> добиты поля `Noize MC`/`Queen`/`Radiohead` (`batchAA`).
+>
+> 🔴🔴 **ГЛАВНОЕ: из обеих сводок выброшены 562 строки `!Детские/Сказки`.**
+> Причина — фильтр в `rebuild_summaries.py`: `if not art: continue` («пустой artist не артист»).
+> Решение было принято ассистентом **без запроса Alex**. Alex нашёл: «куда блядь сказки проебались?»
+>
+> **Проверка:** `!Детские` в `tag-fix-plan.csv` = 570 строк (562 с пустым artist).
+> В сводках — 0 (только 8 строк с реальным исполнителем: `Мюзикл` 4, `Арабская сказка` 2,
+> `Л.Н. Толстой` 1, Большой детский хор 1).
+>
+> ✅ **Итог правок:** `single` 646 + `multi` 6656 = **7302** ⚠️ (недосчитывает 562 сказки;
+> после восстановления сумма обязана стать **7878** = 7906 − 28 `skip`).
 > ✅ **0 групп «один артист — разные написания»**, `colliding normalized names` = **0**.
-> 👉 Детали — `personal/tech/music-tags-repair-truenas.md` (волна 32).
-> ⚠️ Открытый вопрос: 104 дубля `(album, track)` — копии релизов в разных папках (дедупликация).
-> ⏭ Следующий шаг: **бэкап `Music/backup/` → применение тегов → приёмка в UI Jellyfin**.
+> 👉 Детали — `personal/tech/music-tags-repair-truenas.md` (волна 33).
+>
+> ### ⏸ ЖДЁТ РЕШЕНИЯ ALEX: как вернуть 562 сказки в сводки
+>
+> | # | Вариант | Что получится |
+> |---|---|---|
+> | **1** | писать `(без исполнителя)` в `artist` | 562 сказки = один артист в `multi` (562 трека) |
+> | **2** | писать **имя папки-сказки** в `artist` | каждая сказка — отдельный артист (`multi`) |
+> | **3** | оставить как есть | сказки только в `tag-fix-plan.csv`, сводки — только по артистам |
+>
+> **Рекомендация: вариант 2** — сказки это отдельные релизы, `album` у них уже заполнен
+> (имя сказки), логично поднять его в `artist`. Вариант 1 создаёт фейкового «артиста».
+>
+> ⛔ **Аппрув и применение тегов ЗАБЛОКИРОВАНЫ до решения.** Плюс: инвариант-чекер обязан
+> получить новую проверку **«сумма сводок = 7906 − skip»** — её отсутствие и пропустило баг.
+>
+> ⚠️ Открыто: 104 дубля `(album, track)` — копии релизов в разных папках (дедупликация).
 
 ## Состав файлов
 
 | Файл | Строк | Колонки |
 |---|---|---|
 | `tag-fix-plan.csv` | 7906 | 11 колонок (главный план) |
-| `artists-single-track.csv` | 652 | `artist, album, track, title, path` |
-| `artists-multi-track.csv` | 6650 | `artist, album, track, title, path` |
-| | **7302** | = 7906 − 576 (пустой `artist`) − 28 (`skip`) |
-
-> ⚠️ **Оба файла имеют одинаковый формат** (единый `artist, album, track, title, path`).
-> Разный порядок колонок (дефект 29-й волны) — **исправлен**.
+| `artists-single-track.csv` | 646 | `artist, album, track, title, path` |
+| `artists-multi-track.csv` | 6656 | `artist, album, track, title, path` |
+| | **7302** | ⚠️ = 7906 − 562 (сказки, выброшены) − 28 (`skip`) − 14 |
+>
+> ⚠️ **БАГ:** 562 строки `!Детские/Сказки` не попадают ни в один файл (см. выше).
 > Оба файла **отсортированы**: артист → album → номер трека (числовой) → title → path.
 
 ### ✅ «single-track» = «артист РОВНО с 1 треком» (исправлено в 30-й волне, добито в 31-й)
@@ -54,13 +78,15 @@ _Обновлено: 2026-09-26. Источник: `~/Downloads/music-tags/tag-f
 «ты блядь будешь что в single track artists csv больше нет артистов у которых больше 1 трека?!»).
 
 **Определение теперь честное:**
-- `artists-single-track.csv` — артист ровно с **1** треком (664 артиста, 664 строки)
-- `artists-multi-track.csv` — артист с **>1** треком (295 артистов, 6638 строк)
-- строки с пустым `artist` — **не попадают ни в один файл**
+- `artists-single-track.csv` — артист ровно с **1** треком (646 артистов, 646 строк)
+- `artists-multi-track.csv` — артист с **>1** треком (297 артистов, 6656 строк)
+- строки с пустым `artist` — ⚠️ **выбрасываются** (ЭТО БАГ: 562 сказки пропали, см. волну 33)
 
 Проверено 7 инвариантов — все 0/True (см. `music-tags-repair-truenas.md`, волна 30).
 В т.ч. **пересечение артистов между файлами = 0** как точно, так и **нормализованно**
 (регистр, `ё`/`е`, префикс `группа `, артикль `the `, инициал `А. `, NFC).
+🔴 **НО НЕ ПРОВЕРЯЛАСЬ СУММА** — именно поэтому пропажа 562 строк прошла незамеченной.
+**Добавить инвариант 8: `single + multi + skip == 7906`.**
 
 ### ✅ 31-я волна: 0 групп «один артист — разные написания»
 
@@ -100,8 +126,8 @@ Alex трижды указывал на это. Причина была **не
 
 | action | строк | смысл |
 |---|---|---|
-| `fix` | 7007 | теги будут перезаписаны |
-| `no_change` | 871 | теги корректны, файл не трогаем |
+| `fix` | 7011 | теги будут перезаписаны |
+| `no_change` | 867 | теги корректны, файл не трогаем |
 | `skip` | 28 | AppleDouble-мусор `._*` (15) + мусорные `.wma` без названия (13) |
 
 ## Источник правки (`source`)
@@ -122,13 +148,16 @@ Alex трижды указывал на это. Причина была **не
 - 0 нечисловых номеров треков
 - **0 дублей-артистов** (регистр / ё / латиница-кириллица)
 - 576 строк без artist — из них **562 это `!Детские/Сказки`** (artist пуст намеренно)
+- 🔴 **НОВАЯ ПРОВЕРКА (обязательна):** `single + multi + skip == 7906`. Сейчас **7302 + 28 = 7330**
+  → **недостача 576 строк**, из них 562 сказки. Чекер обязан падать на этой проверке.
 
 ## Приёмка (глазами)
 
-1. Открой `artists-single-track.csv` — 652 артиста, у каждого ровно 1 трек, отсортировано
-2. Открой `artists-multi-track.csv` — 301 артист, 6650 треков, отсортировано по альбому и номеру
+1. Открой `artists-single-track.csv` — 646 артистов, у каждого ровно 1 трек, отсортировано
+2. Открой `artists-multi-track.csv` — 297 артистов, 6656 треков, отсортировано по альбому и номеру
 3. Найди свой артист, проверь названия
-4. Скажи «go» → бэкап в `Music/backup/` → применение → приёмка в UI Jellyfin
+4. 🔴 **Блокер:** 562 сказки отсутствуют в сводках — сначала решить (см. варианты выше)
+5. Скажи «go» → бэкап в `Music/backup/` → применение → приёмка в UI Jellyfin
 
 ## Что найдено в последнем проходе (6402–7906, 27-я волна)
 
@@ -207,7 +236,38 @@ Alex трижды указывал на это. Причина была **не
 | `fix_manual_batchL.py` | 10 номеров: Re Sfaction 1–6, Pumphonia-дубли, сборники | ✅ |
 | `fix_manual_batchM.py` | 12 номеров: Miami Sampler, Energy, Loveparade, Dancefloor Killers | ✅ |
 | `fix_manual_batchN.py` | `группа Секрет` → `Секрет` (дубль внутри `single`) | ✅ |
-| `rebuild_summaries.py` | **переписан**: `single` = артист с 1 треком, + сортировка, пустой `artist` выброшен | ✅ |
+| `fix_manual_batchW.py` | `DJ Tiesto - <артист>` ×13 → артисты сборника; инициалы → имена; `Сбрник`, `Классика`, `D.I.P project` (25 + 5) | ✅ |
+| `fix_manual_batchX.py` | В. Высоцкий: artist+title+album; Пахмутова (2-й файл) (4) | ✅ |
+| `fix_manual_batchY.py` | `Paffendorf vs.` → `Paffendorf Vs.` (1) | ✅ |
+| `fix_manual_batchZ.py` | **Свод написаний:** `Алексин`, `Баста`/`Нагано`, `Сергей Шнуров`, `Вячеслав Бутусов`, `Ю-Питер` (57) | ✅ |
+| `fix_manual_batchAA.py` | `Noize MC` title-транслит + album; `Queen` album-дубль; `Radiohead` album `In Rainbows` (4) | ✅ |
+| `rebuild_summaries.py` | **переписан**: `single` = артист с 1 треком, + сортировка, ⚠️ пустой `artist` выброшен (БАГ, см. волну 33) | ✅ |
+
+## 🔴🔴 ГЛАВНЫЙ УРОК 33-й ВОЛНЫ: НЕЛЬЗЯ МОЛЧА ВЫБРАСЫВАТЬ СТРОКИ ИЗ СВОДОК
+
+`rebuild_summaries.py` содержит фильтр `if not art: continue` — и **562 строки
+`!Детские/Сказки`** (artist пуст намеренно) исчезли из обеих сводок. Это решение ассистент
+принял сам, Alex не просил. Alex нашёл: «**куда блядь сказки проебались?**»
+
+Пропажа прошла **три волны** (30, 31, 32) незамеченной, потому что чекер проверял 7 инвариантов,
+но **не проверял сумму**. `single + multi` давало 7302, и все сверялись с этим числом как с нормой.
+
+**Урок:** переопределяя метрику, сохраняй **полноту данных**. Каждая строка `tag-fix-plan.csv`
+обязана быть представлена в сводках или попадать под `skip`. Инвариант-чекер обязан включать
+**арифметику полноты**: `single + multi + skip == 7906`.
+
+### 🔴 ВТОРОЙ УРОК: «АРТИСТ В `single`» — СИМПТОМ ДВУХ НАПИСАНИЙ, А НЕ ПОВОД ОБЪЯСНЯТЬ
+
+Alex прислал шесть артистов из `single` со словами «они явно не single track». Ассистент
+ответил «нормальные, не тронул» — **не понял задачу**. Корень: тот же артист в двух написаниях,
+из-за чего ровно одна строка уходила в `single`. **Список артистов из сводки = «найди и почини
+причину», а не «оцени эти имена».**
+
+### 🔴 ТРЕТИЙ УРОК: АРТИСТ В `single` ПРОВЕРЯТЬ НА ДИСКЕ, НЕ ПО CSV
+
+`Noize MC`, `Queen`, `Radiohead` — реально по 1 файлу (`find -iname` по `Music`).
+single формально корректен. Но у всех трёх были грязные поля — починены.
+**Проверка существования файлов — только `find` на TrueNAS, не логика CSV.**
 
 ## 🔴 ГЛАВНЫЙ УРОК 30-й ВОЛНЫ: ИМЯ ФАЙЛА-СВОДКИ ДОЛЖНО ОТВЕЧАТЬ СВОЕМУ СОДЕРЖИМОМУ
 
@@ -277,8 +337,9 @@ Alex указал на это **четыре раза** («я до сих пор
 | 5 | один артист в разных написаниях внутри `single` | **0** |
 | 6 | пустых `artist` в обоих | **0** |
 | 7 | оба файла отсортированы | **True** |
+| **8** | 🔴 **`single + multi + skip == 7906`** | **НЕ ПРОВЕРЯЛОСЬ → баг с 562 сказками** |
 
-> ⚠️ В `single` у **294 из 675** строк нет номера трека — одиночные синглы без альбома,
+> ⚠️ В `single` у части строк нет номера трека — одиночные синглы без альбома,
 > номера не существует. Артист ровно один, из `single` их не убрать.
 > ⚠️ 2578 треков в `multi` без номера — папки без нумерации вообще (`!Rock&Folk` 814,
 > `!Pop, Club, Любэ` 679, `!Барды` 277, `z Другое` 260, `!Рэп` 230, `!Retro` 215).

personal/tech/music-tags-repair-truenas.md

@@ -4,7 +4,7 @@ created: '2026-09-26'
 updated: '2026-09-26'
 type: tech
 namespace: personal
-wave: 32
+wave: 33
 tags:
   - music
   - jellyfin
@@ -20,6 +20,100 @@ related:
 
 # Music Tags Repair — TrueNAS (7906 файлов)
 
+> ## ✅ ТРИДЦАТЬ ТРЕТЬЯ ВОЛНА (2026-09-26) — СВОД НАПИСАНИЙ АРТИСТОВ (2-й проход) + 🔴 НАЙДЕН ПРОПАЖ 562 СКАЗОК
+>
+> Триггер: Alex — «В.Бутусов и Юпитер / почему не тронул: `Алексин`, `Нагано`, `Шнуров`(46),
+> `Noize MC`, `Radiohead`, `Queen`? **это из single track списка я тебе кидаю! они явно не
+> single track**» → «Noize MC до сих пор в single списке» → «**куда блядь сказки проебались?**»
+>
+> ### 🔴 ГЛАВНЫЙ УРОК ВОЛНЫ: АРТИСТ В `single` — ЭТО СИМПТОМ ДВУХ НАПИСАНИЙ
+> Alex кидает список артистов **из `single`** — это не «проверь эти имена», а
+> **«объясни, почему артист, у которого явно >1 трека, лежит в single»**.
+> Ассистент в первый заход ответил «нормальные, не тронул» — прямое непонимание задачи.
+> **Корень всех шести:** один и тот же артист существовал в **двух написаниях**, из-за чего
+> ровно одна строка уходила в `single`, остальные — в `multi`.
+>
+> | Single-строка | Multi | Сведено в | Строк |
+> |---|---|---|---:|
+> | `Алексин и группа Колючки` | `Алексин` (17) | `Алексин` | 1 |
+> | `Баста (Нагано)` + `Нагано` | — | **`Баста`** (`Нагано` — это АЛЬБОМ, не артист) | 2 |
+> | `Сергей Шнуров и DJ Кефир` | `Сергей Шнуров` (46) | `Сергей Шнуров` | 1 |
+> | `В.Бутусов и Юпитер` | `В. Бутусов` (42) | `Вячеслав Бутусов` | 1 |
+> | `В. Бутусов` (42) | | `Вячеслав Бутусов` | 42 |
+> | `Вячеслав Бутусов и Ю-Питер` | | `Вячеслав Бутусов` | 1 |
+> | `Бутусов & Ю-Питер` (9) | `Ю-Питер` (14) | **`Ю-Питер`** («Имя рек» — его альбом) | 9 |
+>
+> Скрипт `fix_manual_batchZ.py` — **57 правок**, идемпотентен, бэкап `bak-batchZ`.
+>
+> **Детектор этого класса** (обязателен после каждой волны): нормализованный группировщик
+> артистов по всей библиотеке — регистр, `ё`→`е`, `группа `, `the `, инициал `А. `, NFC.
+> Ноль групп = класс закрыт. На 33-й волне после `batchZ` → **0 групп**.
+>
+> ### 🔴 `Noize MC` / `Queen` / `Radiohead` — ПРОВЕРКА ПОДТВЕРДИЛА, ЧТО ЭТО НЕ ДЕФЕКТ
+> Это реально **по одному файлу** в библиотеке (`find -iname` по `Music` = 1 файл у каждого).
+> Но поля у них были грязные — починены (`fix_manual_batchAA.py`, 4 правки):
+> - `Noize MC`: `new_title = 'Round 2 : Za Zakrqtoi dverju'` (транслит-плейсхолдер) →
+>   `В коморке что за актовым`; album-сборник батла → пусто
+> - `Queen`: `new_album == new_title == 'Show must go on'` (дубль) → album пусто
+> - `Radiohead`: album пусто → **`In Rainbows`** (`Nude` — трек оттуда)
+>
+> **Урок: «артист в `single`» проверяется на ДИСКЕ (`find`), а не по CSV.** Если файл один —
+> single формально корректен, но остальные поля всё равно проверять.
+>
+> ### 🔴🔴 КРИТИЧНЫЙ ПРОВАЛ, НАЙДЕННЫЙ В ЭТОЙ ВОЛНЕ: 562 СКАЗКИ ВЫБРОШЕНЫ ИЗ СВОДОК
+> Alex: «**куда блядь сказки проебались?**»
+>
+> В `rebuild_summaries.py` (переписан в 30-й волне) стоял фильтр:
+> ```python
+> art = (r.get('new_artist') or '').strip()
+> if not art:
+>     continue          # нет исполнителя -> не артист
+> ```
+> Под него попали **562 строки `!Детские/Сказки`** (artist пуст намеренно — это аудиосказки)
+> и 14 прочих. Они **исчезли из ОБЕИХ сводок** — ассистент сам решил, что «пустой artist
+> не артист», и **никто его об этом не просил**.
+>
+> **Проверка:** `!Детские` в `tag-fix-plan.csv` = 570 строк, из них 562 с пустым artist.
+> В сводках их осталось 0 (в single 2 + в multi 6 = только 8 строк с реальным исполнителем:
+> `Мюзикл` 4, `Арабская сказка` 2, `Л.Н. Толстой` 1, Большой детский хор 1).
+>
+> **Урок (жестёкий):** переопределяя метрику сводки, **нельзя молча выкидывать данные**.
+> Каждая строка `tag-fix-plan.csv` обязана быть представлена в сводках. Если у строки нет
+> артиста — это надо записать явно (плейсхолдер или папка-сказка как artist), а не удалять.
+> **Инвариант-чекер обязан считать сумму: `single + multi + skip == 7906`.**
+> Сейчас он этого НЕ делал — поэтому пропажа 562 строк прошла 30-ю, 31-ю и 32-ю волны незамеченной.
+>
+> **Статус: ОТКРЫТ, ждёт решения Alex** (варианты в `music-tags-final-review.md`):
+> 1. писать `(без исполнителя)` как artist → 562 сказки станут одним артистом в `multi`;
+> 2. писать **имя папки-сказки** как artist → каждая сказка отдельным артистом;
+> 3. оставить как есть (сказки только в `tag-fix-plan.csv`).
+>
+> ### 📊 ИТОГ 33-й ВОЛНЫ (сводки — ДО восстановления сказок)
+>
+> | Показатель | Волна 32 | **Волна 33** |
+> |---|---:|---:|
+> | `tag-fix-plan.csv` | 7906 (0 битых) | **7906 (0 битых)** |
+> | `fix` / `no_change` / `skip` | 7007 / 871 / 28 | **7011 / 867 / 28** |
+> | `artists-single-track.csv` | 652 | **646** |
+> | `artists-multi-track.csv` | 6650 | **6656** |
+> | Сумма сводок | 7302 | **7302** ⚠️ недосчитывает 562 сказки |
+> | `colliding normalized names` | 0 | **0** |
+> | Групп с >1 написанием артиста | 0 | **0** |
+>
+> ### ✅ ПРАВКИ ВОЛНЫ
+> | Класс | Строк | Скрипт |
+> |---|---:|---|
+> | Свод написаний: `Алексин`, `Баста`/`Нагано`, `Сергей Шнуров`, `Вячеслав Бутусов`, `Ю-Питер` | 57 | `fix_manual_batchZ.py` |
+> | `Noize MC` title-транслит + album, `Queen` album-дубль, `Radiohead` album `In Rainbows` | 4 | `fix_manual_batchAA.py` |
+>
+> **Бэкапы 33-й волны:** `bak-*-batchZ`, `bak-*-batchAA`.
+> **Сводка для аппрува:** `personal/tech/music-tags-final-review.md`.
+>
+> ⏭ **СЛЕДУЮЩИЙ ШАГ:** (1) решить судьбу 562 сказок → починить `rebuild_summaries.py`
+> + добавить инвариант «сумма = 7906 − skip»; (2) только потом аппрув и применение тегов.
+>
+> ---
+>
 > ## ✅ ТРИДЦАТЬ ВТОРАЯ ВОЛНА (2026-09-26) — ЗАКРЫТИЕ НАЙДЕННЫХ КЛАССОВ ДЕФЕКТОВ
 >
 > Триггер: Alex — «В. Высоцкий - Песня о друге (Вертикаль OST)» +