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

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

@@ -100,7 +100,63 @@ related:
 > Файлы в сборниках (`disk/`, `disk_v2/`) **удалять нельзя** — указание Alex:
 > «они корректно живут в сборниках». Удаляем ТОЛЬКО дубли альбомов.
 
-> ## 🔴 АКТУАЛЬНОЕ СОСТОЯНИЕ (2026-09-27, сессия ~30) — ЧИТАЙ ЭТО ПЕРВЫМ
+> ## 🔴 АКТУАЛЬНОЕ СОСТОЯНИЕ (2026-09-27, сессия ~36) — ЧИТАЙ ЭТО ПЕРВЫМ
+>
+> 🔴🔴 **`apply` НЕ ЗАПУСКАТЬ БЕЗ ПРЯМОГО ПОДТВЕРЖДЕНИЯ ALEX.** Дословно 27 сен:
+> «**без подтверждения никакого apply блядь**». Дифф и dry-run — можно, запись — только «go».
+>
+> ✅ **ДИФФ ОТ БД ГОТОВ И СВЕРЕН С ПЛАНОМ.** `DIFF-db-to-fix.csv` — 16 857 B, **91 запись**
+> (ПАПКА 26 · ТРЕК 65), md5 `a5f2b910826dcc46474b6e26513f414f`. Поля: `album` 6 ·
+> `albumartist` 11 · `artist` 16 · `track` 58. План `apply-plan-v5.csv` — 7861 стр,
+> md5 `d4392b11f143844c590a0a9c4a752208`, **меняется 159 файлов**, 7702 без изменений.
+> `title 0 · genre 0` — эти поля не трогаются.
+>
+> ⚠️ **ЕДИНИЦА СЧЁТА — главная ловушка этой сверки.** Одни и те же правки считаются так:
+> ```
+> DIFF-db-to-fix.csv   92 строки файла = 91 ЗАПИСЬ  (91 + заголовок)
+>                      87 уникальных (файл,поле)     (2 файла с двойной правкой:
+>                                                     Тема дороги album+artist, Птаха album)
+> план v5              159 ФАЙЛОВ, разбивка по ПОЛЯМ (albumartist 157 · artist 154 ·
+>                      album 60 · track 58)
+> дифф                 ПАПКИ, не файлы: 11 папок Трофима × 14 файлов = 154
+> ```
+> Сверка 1:1 по всем полям — скрипт `verify_v5_vs_diff.py`. Дифф↔план РАСХОЖДЕНИЙ НЕТ.
+> **Называть единицу счёта вслух** (папки ≠ строки ≠ файлы) — иначе Alex видит
+> противоречие там, где его нет.
+>
+> ✅ **ДИФФ v3 (`APPLY-PLAN-v3-changes.csv`) — СПРАВОЧНИК, НЕ источник правды В ЭТОМ ДИФФЕ.**
+> 31 запись (album: Забугр, Руки вверх, Ария/Кипелов, Юрий Никулин, Дискотека Авария…),
+> md5 `2c6d2f0bb1d732d7e3e70ef1b210e7d8`, **уже применена прогоном v3**. В v5 её нет:
+> v5 — отдельная волна, 87 из 87 правок это Трофим + Ленинград + Птаха.
+> ⚠️ **Не смешивать: v3-changes = journal ДО прогона (album), v5 = дифф ПОСЛЕ прогона
+> от БД (4 поля).** Общего пересечения — 0.
+>
+> 🔴 **ЦИФРА «215 АЛЬБОМОВ-ОДИНОЧЕК» — НЕВЕРНА. ПРАВИЛЬНО `56`.** `215` посчитано по
+> СТРОКАМ отчёта `REPORT-album-kept-all-folders.csv`, а не по папкам. Пересчёт по плану v5:
+> **633 папки · однотрековых 56 · многотрековых 577**; `album == title` (настоящий дефект)
+> лишь у **11**; `album != title` у 45; `album == имя папки` у 15.
+> **В плане v5 однотрековых, которые меняются — 0** (сборщик их не знает).
+>
+> 🔴 **ПРАВИЛО ОДИНОЧЕК ОТ ALEX (27 сен):** `album` = **имя ПАПКИ-ВЛАДЕЛЬЦА**
+> (`rock_o_pop` → `rock_o_pop`, `Retro` → `Retro`), **`artist` СОХРАНИТЬ** («artist нужно
+> сохранить»). Про `albumartist` — **ОТКРЫТО**: по `9999 - Разное` он должен быть
+> `Агата Кристи` (уже так), но по `rock_o_pop`/`Retro` в БД стоит `Various Artists`
+> у 100% файлов. `!Rock&Folk/Ария, Кипелов` в v5 отсутствует — правки по ней уже в v3.
+> Разбор — [[personal/plans/music-artist-albumartist-repair]] § ПРАВИЛО ALEX ДЛЯ ОДИНОЧЕК.
+>
+> ✅ **АРТЕФАКТ «КАК СТРОИЛСЯ APPLY-PLAN И ДИФФ» — ЗАПИСАН.** Zulip DB показала:
+> `APPLY-PLAN.csv` собран в `/Users/admin/milestones/music-csv-2026-09-26/`
+> (`tag-inventory3.csv` → `APPLY-PLAN-FINAL.csv` → `APPLY-PLAN-FINAL2.csv` → канон),
+> **скрипта-сборщика как единого файла НЕТ** — сведение шло несколькими скриптами
+> (`add_track.py`, `fix_track_and_selfcheck.py`) + ручные решения по 51 файлу.
+> 🔴 **Папка `milestones/music-csv-2026-09-26/` БОЛЬШЕ НЕ СУЩЕСТВУЕТ** (`ls` → No such file).
+> `build_fix_plan2.py` — **другой скрипт** (волна 38), канон НЕ писал, `albumartist` не умеет.
+>
+> 🔴 ПИТФОЛЛ ЗАПУСКА (без изменений): у образа `tagwriter:latest` в `CMD` прописан
+> `--dry-run` → явно передавать `--apply`, иначе прогон молча уходит в dry-run.
+> Два шага: `docker create` затем `docker start` (составная команда прерывается по таймауту).
+
+> ## 🔴 АКТУАЛЬНОЕ СОСТОЯНИЕ (сессия ~29-35) — АРХИВ
 >
 > ✅ **БОЕВОЙ ПРОГОН ВЫПОЛНЕН:** 7653/7653 ok, err=0.
 > `TCON 4359 · TPE2 7213 · TALB 2031 · TPE1 381 · TRCK 437 · TIT2 8`.