[2026-09-27] eagle: personal/plans/music-artist-albumartist-repair.md personal/tech/id3-tag-repair.md

personal/tech/id3-tag-repair.md

@@ -22,6 +22,7 @@ related:
 
 > Зеркало скилла `id3-tag-repair` (категория `media`, `~/.hermes/hermes-whale/skills/media/id3-tag-repair/`).
 > Скилл — для исполнения, этот док — для контекста проекта и истории.
+> **Текущая версия скилла — v2.8.0** (правила D1–D35, W1–W30, A1–A8, G1–G5).
 >
 > ⚠️ **Скилл обновлён до v1.4.0** — добавлены правила **D1–D6** (слой диффа планов,
 > раздел «🔵 Слой ДИФФА планов» ниже). Полные формулировки — в `SKILL.md` скилла.
@@ -80,6 +81,22 @@ related:
 > весь — из-за ПОЯВЛЕНИЯ колонки, `old_38='<КОЛОНКИ НЕ БЫЛО>'`, ср. D3). Инвентарь
 > актуального диффа — `personal/plans/music-artist-albumartist-repair.md` §СЕССИЯ 18-ДОП.
 
+> ⚠️ **Обновлён до v2.5.0 (сессия 18-доп, вечер):** **D32** — 🔴 **счёт ФАЙЛОВ: дифф завышает,
+> правда в ПЛАНЕ.** Развёртка ПАПКА-строки в файлы папки дала `7963` по `genre`; верное число
+> `4359` (по `APPLY-PLAN.csv`: `cur_X != new_X`). Причина — файлы с уже правильным тегом тоже
+> попадают в развёртку (3393 фантома). Плюс **D33** — отвечая «где список, который ты готовил»,
+> всегда давать путь + md5 + число строк + пометку ПРОМЕЖУТОЧНЫЕ/ФИНАЛЬНЫЕ значения
+> (`ALBUM-FIX-TABLE.csv` промежуточный vs `ALBUM-FIX-306.csv` финальный).
+> Разбивка диффа по 633 папкам — §СЕССИЯ 18-ДОП плана.
+>
+> ⚠️ **Обновлён до v2.6.0 (сессия 18-доп, вечер-2):** **D34** — 🔴 **«откуда взялось поле?» →
+> сравнить ЗАГОЛОВКИ обеих версий плана.** В `tag-fix-plan.csv` (волна 38) колонки `genre`
+> **не было вообще** → все `4359` по `genre` = первая запись тега (прямое продолжение D3).
+> Генератора `new_genre` на диске нет. **D35** — 🔴 **не называть в одном ответе числа двух
+> разных артефактов**: «306» (файл `ALBUM-FIX-306.csv`) и дифф — разные артефакты; в диффе
+> `306` отсутствует (0 ячеек), те же строки схлопнуты в **15 записей** по D16.
+> Мой дефект был в **изложении** — Alex прочитал как подмену числа.
+
 ## 📁 Артефакты проекта
 
 **Путь:** `~/Developer/personal-os/tools/music-tags/`
@@ -359,6 +376,125 @@ md5 out.csv && python3 gen.py > /tmp/run.log 2>&1 && md5 out.csv   # MD5 обя
 **Скрипт:** `~/Downloads/music-tags/fix_junk_album.py` (dry-run по умолчанию, `--apply` пишет).
 **Верификация:** `verify_junk_album.py` — перечитывает файл, сверяет контрольные точки.
 
+### 🔴 D32 — счёт ФАЙЛОВ: дифф завышает, правда — в ПЛАНЕ (сессия 18-доп)
+
+На вопрос «сколько файлов реально меняет `<поле>`» я развернул каждую ПАПКА-строку диффа
+в файлы папки и сложил → получил `7963` по `genre`. Alex: «**Чё за нахуй?! В смысле блядь 7963?!!!**»
+— и он прав. **Правильное число `4359`.**
+
+```
+по диффу (НЕВЕРНО)              по плану (ВЕРНО)
+911 genre-строк                 7861 строк всего
+  700 ПАПКА -> 7752 файла       для каждой строки: cur_X != new_X ?
+  211 ТРЕК  ->  211 файлов        genre 4359  albumartist 7213  album 2003
+  объединение = 7963              artist 381  track 344  title 8
+                                   ANY field 7651
+```
+
+**Почему дифф завышает:** ПАПКА-строка означает «значение в папке однородно И отличается от
+38-го прогона». Это **не** значит, что у каждого файла папки значение отличается от целевого —
+файлы, у которых тег **уже равен** целевому, тоже попадают в развёртку. **3393 файла-фантома.**
+
+🔴 **Правило: две разные базы счёта, не смешивать.**
+
+| Вопрос | Считать по | Предикат |
+|---|---|---|
+| «что изменилось против прошлого прогона?» | **диффу** | строки диффа |
+| «сколько файлов реально меняется?» | **`APPLY-PLAN.csv`** | `cur_X != new_X` построчно |
+
+Та же семья, что D8 (`changed` ≠ изменение на диске) и D24 (`new == cur` = pass-through).
+**Никогда не разворачивать ПАПКА-строку в список файлов папки и не называть сумму «файлов меняется».**
+
+**Форма отчёта по папкам (что сработало):** на каждую папку
+`правок · файлов в папке · файлов меняется · счётчики по полям`, по алфавиту; корневые папки
+считать отдельно от вложенных. Архив — `/tmp/folders_report.txt` (633 папки: **6 корневых** —
+`!Pop, Club, Любэ`, `!Retro`, `!Детские`, `!Классика`, `!Рэп`, `z Другое, Enigma, Ленинград` —
+и **627 вложенных**). Важно: у `!Rock&Folk` и `!Барды` **нет** корневых строк — они затронуты
+только через вложенные папки.
+
+### 🔴 D33 — «где список, который ты готовил?» → путь + md5 + какой из них ФИНАЛЬНЫЙ
+
+Alex спрашивал про список снятия скобок дважды; оба раза ответ должен быть **фактом о файле**,
+а не описанием. Существовали два артефакта, и было неочевидно, какой главный:
+
+| Файл | md5 | Строк | Роль |
+|---|---|---:|---|
+| `~/Downloads/music-tags/ALBUM-FIX-TABLE.csv` | `1597f2716ac5a2881efabaec13755d4c` | **306** | механическое снятие скобок (`folder,cur_album,new_album,path,title`) |
+| `~/Downloads/music-tags/ALBUM-FIX-306.csv` | `49ba645462964cc299da7dcffb55ca09` | **306** | + `new_album_was` / `new_album_now` — несёт ПОЗДНЕЙШЕЕ решение |
+
+**Промежуточный список — ловушка.** В `ALBUM-FIX-TABLE.csv` стоит `(Авария)` → `Авария`,
+но ФИНАЛЬНОЕ решение (D27) — `Москва пьёт пиво` / `Дискотека Авария`. Механическое снятие скобок
+**неверно** везде, где скобочный мусор лежал ПОВЕРХ уже правильного имени подпапки.
+
+🔴 **Правило: отвечая «где список», всегда указывать (1) путь, (2) md5 + число строк,
+(3) значения ПРОМЕЖУТОЧНЫЕ или ФИНАЛЬНЫЕ — и указывать файл с колонками `was`/`now`,
+если значения позже уточнялись.** Таблицу из 306 строк, где 17 пар сводятся к 9 финальным
+значениям, нельзя утверждать по одной только форме.
+
+**Факт для проверки:** `cur_album` начинается с `(` — 306 из 306; значение целиком в скобках —
+306 из 306; уникальных путей 306; уникальных пар «папка+было→стало» — 17.
+Скрипт: `/tmp/verify_alb_fix.py`.
+
+### 🔴 D34 — «откуда взялось это поле?» → сравнить ЗАГОЛОВКИ обеих версий плана
+
+Alex: «**Откуда там правка жанра то??**». Ответ оказался одним фактом: **в волне 38 колонки
+`genre` не существовало вообще.**
+
+```
+tag-fix-plan.csv (волна 38), 11 колонок:
+  path, current_verdict, cur_title, cur_artist, cur_album,
+  new_title, new_artist, new_album, new_track, action, source
+                                            ↑ genre ОТСУТСТВУЕТ
+
+APPLY-PLAN.csv (текущий), 16 колонок:
+  ... cur_genre, ... new_genre, new_track, changed   ← genre ПОЯВИЛСЯ
+```
+
+**Следствие (прямое продолжение D3):** жанр не писался ни разу. Любое непустое `new_genre` =
+**первая запись тега** → отсюда весь объём `4359`.
+
+**Состав — 137 пар `cur_genre → new_genre`:** заполнение пустого (1136 `''`→`Rock`, 439 `''`→`Pop`,
+322 `''`→`Детские`, 252 `''`→`Бардовская песня`, 237 `''`→`Сказки`), нормализация (`Рок`→`Rock` 182,
+`Punk Rock`→`Punk` 82, `Metal`→`Heavy Metal` 52, `Поп`→`Pop` 16), омоглифы (`Psy Årance`→`Psy-Trance` 41,
+`Psy Еrance`→`Psy-Trance` 30 — ср. G2), и **поле прочитано неверно** (`(17)`→`Rock` на 32 файлах ДДТ,
+`Разное`→`Бардовская песня` на 22 файлах Высоцкого — ср. G3).
+
+🔴 **Генератора `new_genre` на диске НЕТ.** `~/Downloads/music-tags/fix_apply_plan.py` содержит
+**одну** genre-правку (`яюElectronic`→`Electronic` в `JUNK_FIX`) + пересчёт `changed`. Скрипт
+правит готовый план, а не строит его. Аудитор жанра — `rc_gen_check.py`, `fix_klassika.py`,
+`fix_radio_format.py` (точечные).
+
+> 🔑 **МЕТОД-УРОК:** на вопрос «откуда правка в поле X» **первым делом сравнивать заголовки**
+> обеих версий плана. Отсутствие колонки объясняет весь объём одним фактом и не требует
+> рассуждений о логике заполнения. Дешёвая проверка, снимающая целый класс споров.
+
+### 🔴 D35 — не называть в одном ответе числа ДВУХ РАЗНЫХ артефактов
+
+Alex: «**Ты только что блядь сказал что в диффе 306 сука файлов! Какие нахуй 4359?!**»
+
+**Он прав — 306 в диффе не существует.** Проверено literal-поиском по всем ячейкам
+(`/tmp/find_306.py`):
+
+```
+DIFF-new-vs-38-v2.csv
+  строк всего                  2854
+  album-строк                   164
+  из них old_38 в скобках        15  (12 ПАПКА + 3 ТРЕК)
+  ячеек, содержащих "306"         0
+```
+
+Те же самые 306 файлов дифф держит как **15 записей** — по схлопыванию **D16** (одна запись
+папки = N файлов). Разница `306 → 15` — это схлопывание, **не превращение одного числа в другое**.
+
+🔴 **Мой дефект был в изложении, не в данных:** я сказал «306» и «дифф» в **одном ответе**,
+хотя `306` — из счётного файла `ALBUM-FIX-306.csv` (построчные пути), а дифф — отдельный артефакт.
+Alex прочитал это как подмену числа, и повторение цифры только усугубляло (см. профиль: повтор
+цифры = «не услышал»).
+
+**Правило:** отвечая про артефакт A, называть **только** числа A. Числа артефакта B давать
+отдельным абзацем с явной пометкой («это счётный файл, не дифф»). Никогда не склеивать два
+артефакта в одну фразу — читатель свяжет числа, которых вместе не существует.
+
 ## 🔴 Классы порчи `albumartist` (сессия 7, 2026-09-27)
 
 Три класса, найденных сплошным поиском по `APPLY-PLAN.csv`. Все три — из-за того, что правило