Критерий, который работает, — зажатые тени. Исходники дня проверены: чистого чёрного в них 0,00 %, значит всё зажатое создаёт лут, а не съёмка. Зажатую тень не вернуть ничем.

исходник в LOG
   ├─ 1. PRE-LUT (необязательно) ── буст динамического диапазона
   ├─ 2. ПРОЯВОЧНЫЙ ── log → Rec.709, ПО КАМЕРЕ И ГАММЕ. Технический шаг.
   └─ 3. ПОКРАСОЧНЫЙ ── look поверх нормальной картинки. ДНК канала.

1. КЛЮЧ ПЛАНА   12_Site_Blessing/RYA-ZVE1-1928.MP4
   слаг         12_Site_Blessing_RYA_ZVE1_1928     # имя без разделителей — ключ выбора человека
   камера       CAM-B_ZVE1

2. ГАММА        сырая строка "s-log3-cine"  →  нормализовано в S-Log3
   источник     кэш (legacy_lut_plan)              # не замер: оригинал — симлинк на карту

3. ПРОФИЛЬ      YTs/YTEVO/color_profile.json → develop["S-Log3"].lut
   develop_source: "профиль: гамма S-Log3"       # откуда взялось — записано рядом

4. КУБ          sony__slog3_sgamut3cine__rec709__neutral__legacy
   в проекте    YTAI_sony__slog3_sgamut3cine__rec709__neutral__legacy.cube

5. ДАЛЬШЕ       экспозиция: витрина +2.0 → Lumetri +4.8  (×2,4)
   покраска     look__newstar                      # одна на канал, к камере не привязана

"12_Site_Blessing/RYA-ZVE1-1928.MP4": {
  "gamma": "S-Log3", "gamma_raw": "s-log3-cine", "source": "legacy_lut_plan",
  "cam": "CAM-B_ZVE1", "pix_fmt": "yuv422p10le", "size": null, "mtime": null,
  "measured": "2026-09-21T10:32:49+0300"
}

# ~/YTAI/YTs/YTEVO/color_profile.json
"develop": {
  "S-Log3": {
    "lut": "sony__slog3_sgamut3cine__rec709__neutral__legacy",
    "cameras": ["CAM-A_FX3", "CAM-B_ZVE1"],
    "decided_by": "roman", "decided_at": "2026-09-22"
  },
  "D-Log2": {
    "lut": "dji_pocket4p__dlog2__rec709__minus",
    "cameras": ["CAM-C_Pocket"],
    "decided_by": "roman", "decided_at": "2026-09-22"
  }
},
"look": { "id": "look__newstar", "decided_by": "roman" },
"exposure": { "target_face_luma": 134 }

Критерий один и измеримый: сколько картинки лут утапливает в чистый чёрный. Зажатую тень не вернуть ничем.

# единственный пропуск дня, как он записан в плане
"skipped": {
  "12_Site_Blessing/RYA-ZVE1-1927.MP4": "снято в Rec.709 — проявка не нужна"
},
"refused": {}

{проект}/01_Source/00_LUT/                       # рабочие кубы ПЛОСКО, без подпапок
   YTAI_sony__slog3_sgamut3cine__rec709__neutral__legacy.cube
   YTAI_dji_pocket4p__dlog2__rec709__minus.cube
   YTAI_look__newstar.cube
   README.md
   _build/                                  # кухня выбора
      {CODE}_color_choice.json                  # выбор человека по дню
      {CODE}_color_plan.json                    # раскладка на таймлайн
      {CODE}_gamma_cache.json                   # замер гамм
      {CODE}_lut_board.html  + _files/          # витрина

{проект}/00_Setup/01_Ingest/{CODE}_lut_plan.json   # ⚠️ ЛЕГАСИ, НЕ переезжает

~/YTAI/YTs/{КАНАЛ}/color_profile.json                          # ДНК канала
~/Library/Application Support/Adobe/Common/LUTs/Input/YTAI/     # проявочные
~/Library/Application Support/Adobe/Common/LUTs/Creative/YTAI/  # покрасочные

• 1Кубы внутри проекта лежат плоско. Только эта копия уезжает к монтажёру; папки Adobe остаются на машине.
• 2Папки Adobe — Creative, Input, Output. Папки Technical не существует — на этом уже обожглись.
• 3{CODE}_lut_plan.json в 00_Setup/01_Ingest/ не переезжает. Это легаси-файл, его читает UXP-панель; он же служит запасным источником гаммы (source: "legacy_lut_plan" в примере выше).
• 4Байты кубов не в git. В git — только manifest.json, 169 записей (develop 137 · look 27 · pre 2 · legacy 3); store/ — 559 МБ, восстанавливается с Shared Drive YTAI (_color/lut_library/). Подробности — 3.8 · 6.

V=~/YTAI/environment/.venv_vlm/bin/python3

# витрина: кадры + кандидаты
$V ~/YTAI/scripts/15_color/1502_lut_pick/lut_board.py --project "<путь>" --frames-from <прокси> --jobs 6
# вернуть выбор человека
$V ~/YTAI/scripts/15_color/1502_lut_pick/lut_board.py --project "<путь>" --feedback <файл.json>

# раскладка: без --apply ничего не пишется
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "<путь>"
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "<путь>" --apply
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "<путь>" --install --apply

# свести луты проекта в один дом 00_LUT
python3 ~/YTAI/scripts/15_color/lut_home.py --project YTEVO03 --apply

• Машина предложила +1.0, человек поставил +2.0 — это один из 18 случаев из 162, где подпись разошлась с рекомендацией; в файле выбора пара лежит целиком: corrected["12_Site_Blessing_RYA_ZVE1_1928"] = [1, 2]. Машина мерит медиану яркости лица и считает промах до цели; человек смотрит на кадр целиком.
• На таймлайн это число уедет как +4.8 — руками его никто не набирает, пересчёт делает код по константе 2,4.
• Гамма взята из кэша, а не измерена заново. Запись замера:

{"gamma":"S-Log3","gamma_raw":"s-log3-cine","source":"legacy_lut_plan",
 "cam":"CAM-B_ZVE1","pix_fmt":"yuv422p10le","size":null,"mtime":null,
 "measured":"2026-09-21T10:32:49+0300"}

{проект}/01_Source/00_LUT/_build/
    YTEVO03_color_choice.json     # exposure[слаг] = 2, corrected[слаг] = [1, 2]
    YTEVO03_color_plan.json       # plan["12_Site_Blessing/RYA-ZVE1-1928.MP4"].exposure = 4.8
    YTEVO03_gamma_cache.json      # запись выше
    YTEVO03_lut_board.html        # витрина; кадры рядом — YTEVO03_lut_board_files/
    YTEVO03_color_plan.20260922_234159.bak.json   # снимок прошлой раскладки, --apply их копит

{проект}/00_Setup/01_Ingest/YTEVO03_lut_plan.json
    # ЛЕГАСИ и НЕ переезжает: это он подписан в кэше как source "legacy_lut_plan",
    # и его же читает UXP-панель

V=~/YTAI/environment/.venv_vlm/bin/python3
# так +2.0 попал в файл выбора: витрина сохраняет и выходит, ничего не рендерит
$V ~/YTAI/scripts/15_color/1502_lut_pick/lut_board.py --project "{путь}" --feedback {файл.json}

• Показываются ВСЕ покрасочные, без урезания. Первая версия резала до восьми «репрезентативных» — и человек выбрал look, не увидев девятнадцати остальных. Покраска — единственное по-настоящему вкусовое решение; урезать выбор за человека тут нельзя.
• Машина только отсекает вред: прочь всё, что режет картинку — пережог > 2 % или зажатое чёрное > 1 %. Из выживших рекомендуется самый насыщенный: насыщенность и есть тот характер, ради которого look ставят.
• Один канал — один look. Он записан в YTs/{КАНАЛ}/color_profile.json вместе с проявками и целью по лицу, и переживает проект.

{проект}/01_Source/00_LUT/                   # дом лутов: рабочие кубы ПЛОСКО, без подпапок
├── YTAI_sony__slog3_sgamut3cine__rec709__neutral__legacy.cube   # проявка Sony · 101 клип · chmod 0444
├── YTAI_dji_pocket4p__dlog2__rec709__minus.cube                 # проявка DJI · 61 клип · chmod 0444
├── YTAI_look__newstar.cube                                      # покраска канала · 162 клипа
├── 01_bright_scene.cube · 02_normal_scene.cube · 03_dark_scene.cube
│                                            # ⚠️ одноступенчатая тройка прошлого поколения — ЕЩЁ ЛЕЖИТ РЯДОМ
├── README.md                                # пишет lut_home; ⚠️ в v1.0 «рабочей тройкой» названа ещё старая
└── _build/                                  # кухня выбора — монтажёру не нужна, нам через полгода нужна
    ├── YTEVO03_color_choice.json            # выбор человека: 162 экспозиции, 18 правок, look
    ├── YTEVO03_color_plan.json  (+ .bak)    # раскладка: клип → проявка + стопы + look
    ├── YTEVO03_gamma_cache.json             # гаммы 163 клипов; переживает размонтированную карту
    ├── YTEVO03_lut_board.html + _files/     # витрина, по которой выбирали
    └── YTEVO03_lut_review.html + _files/    # витрина прошлого поколения — оставлена как история

{проект}/00_Setup/01_Ingest/YTEVO03_lut_plan.json   # ⚠️ ЛЕГАСИ — НЕ переезжает: его читает UXP-панель

~/YTAI/YTs/YTEVO/color_profile.json              # ДНК канала: проявки по гаммам, look, цель по лицу 134
~/YTAI/scripts/15_color/1501_lut_library/
    ├── manifest.json                        # 169 записей — В GIT
    └── store/                               # 559 МБ байтов — НЕ в git, тянется с Drive

~/Library/Application Support/Adobe/Common/LUTs/Input/YTAI/      # проявочные → Basic Correction → Input LUT
~/Library/Application Support/Adobe/Common/LUTs/Creative/YTAI/   # покрасочные → Lumetri → Creative → Look

• Один дом на проект — 01_Source/00_LUT/. Всё, как выбирали, — в _build/, рядом с кубами, а не в 00_Setup, куда никто не пойдёт. Правило папки: ничего не удаляем, лишнее — в _build/.
• В YTEVO03 в папке пока шесть кубов, а не три. Рядом с новыми YTAI_* лежит одноступенчатая тройка 01_bright_scene · 02_normal_scene · 03_dark_scene, и README.md версии lut_home v1.0 называет рабочей именно её. Пока это не разведено, «открыл папку и взял» не работает: монтажёру надо говорить, какие три из шести.
• К монтажёру уезжает только копия в проекте. Папки Adobe остаются на этой машине: они — способ показать кубы Premiere, а не способ их передать. Так и записано в плане: install.project_dir — единственный путь, который едет.
• {CODE}_lut_plan.json остаётся в 00_Setup/01_Ingest/. Это легаси-файл, его читают UXP-панель и lut_board.py; план ссылается на него как на sources.legacy_lut_plan. Перенести его «для порядка» — сломать чужой работающий код.

python3 ~/YTAI/scripts/15_color/lut_home.py --project YTEVO03            # сухо: расскажет, что сделал бы
python3 ~/YTAI/scripts/15_color/lut_home.py --project YTEVO03 --apply    # свести луты в один дом

develop/  {vendor}[_{camera}]__{gamma}_{gamut}__rec709__{family}[__{variant}].cube
look/     look__{name}[__{variant}].cube
pre/      pre__{scope}__{target}.cube
legacy/   {author_slug}/legacy_{author_slug}__{gamma}__rec709__{role}.cube

# герой дня YTEVO03 — проявка, которой покрашен 101 клип из 162
sony__slog3_sgamut3cine__rec709__neutral__legacy
│     │     │            │       │        └───── variant : авторский вариант
│     │     │            │       └────────────── family  : семейство, характер проявки
│     │     │            └────────────────────── выход   : всегда Rec.709 у проявки
│     │     └─────────────────────────────────── gamut   : S-Gamut3.Cine
│     └───────────────────────────────────────── gamma   : S-Log3 — вход
└─────────────────────────────────────────────── vendor  : Sony

# 1 · имя автора — как пришло из архива, живёт в манифесте и больше нигде
orig_name      = "Neutral A7s3-Legacy.cube"
origin.archive = "Проявочные LUTs для LOG (sony, canon, panasonic, apple)/Sony SLOG3.zip"
origin.member  = "SLOG3/Neutral A7s3-Legacy.cube"

# 2 · id — вечный адрес: по нему ссылаются профиль канала, план и витрина
sony__slog3_sgamut3cine__rec709__neutral__legacy
store/develop/sony__slog3_sgamut3cine__rec709__neutral__legacy.cube   # байты, chmod 0444

# 3 · имя при установке — выводится из id префиксом YTAI_
YTAI_sony__slog3_sgamut3cine__rec709__neutral__legacy.cube
  → {проект}/01_Source/00_LUT/                                        # уезжает к монтажёру
  → ~/Library/…/Adobe/Common/LUTs/Input/YTAI/                         # видит Premiere

YTAI_look__newstar.cube
  → ~/Library/…/Adobe/Common/LUTs/Creative/YTAI/

• Префикс обязателен, потому что Lumetri ссылается на ИМЯ ФАЙЛА. look__newstar.cube в общей Creative-папке рядом с чужими кубами — столкновение, ждущее своего часа: у проекта «тот же Look», а куб под ним другой.
• Имя выводится из id, а не из orig_name. Переименовывать луты в сданных проектах нельзя никогда, значит имя должно быть выводимым и вечным: из id оно получается одной строкой — YTAI_{id}.cube, — а из авторского Neutral A7s3-Legacy.cube не получается ниоткуда.
• Новое имя — это новый куб, а не правка старого. Байты кладутся в библиотеку неизменяемыми (chmod 0444): руками не редактируются и не переименовываются. В проекте у трёх YTAI_* права тоже 0444 — это проверяется глазом в ls -l.

V=~/YTAI/environment/.venv_vlm/bin/python3
L=~/YTAI/scripts/15_color/1501_lut_library/lut_lib.py

$V $L --validate --deep        # проверить store и манифест, посчитать метрики
$V $L --list --stage develop --camera pocket4p   # фильтр по камере — по СЛАГУ манифеста, не по маркетинговому имени
$V $L --sync --push --apply    # зеркало store → Shared Drive YTAI (--push — режим по умолчанию)
$V $L --sync --pull --apply    # восстановить 559 МБ на новой машине

python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "<путь>"            # сухо
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "<путь>" --install --apply

V=~/YTAI/environment/.venv_vlm/bin/python3
P="/Volumes/T9-Black-RYA/YTEVO/YTEVO03_Plechko_day"

# 1 — витрина: кадры дня через каждого кандидата
$V ~/YTAI/scripts/15_color/1502_lut_pick/lut_board.py \
    --project "$P" --frames-from ~/Desktop/YTEVO03_01_Source_Proxy --jobs 6

# 2 — подпись: кнопка «скопировать» в витрине отдаёт JSON
$V ~/YTAI/scripts/15_color/1502_lut_pick/lut_board.py \
    --project "$P" --feedback "~/Downloads/choice.json"

# 3 — раскладка: СНАЧАЛА сухо, файл не пишется
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "$P"
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "$P" --apply

# 4 — кубы по местам: папки Adobe + дом лутов проекта
python3 ~/YTAI/scripts/15_color/1503_color_apply/color_apply.py --project "$P" --install --apply
python3 ~/YTAI/scripts/15_color/lut_home.py --project YTEVO03 --apply   # свести луты в один дом

{проект}/01_Source/00_LUT/
├── YTAI_sony__slog3_sgamut3cine__rec709__neutral__legacy.cube   # рабочие кубы ПЛОСКО
├── YTAI_dji_pocket4p__dlog2__rec709__minus.cube
├── YTAI_look__newstar.cube
├── README.md                          # что это, откуда, почему выбрано
└── _build/                            # кухня выбора, монтажёру не нужна
    ├── YTEVO03_color_choice.json      # выбор человека по дню
    ├── YTEVO03_color_plan.json        # раскладка по клипам, ждёт панель
    ├── YTEVO03_gamma_cache.json       # гаммы клипов, 163 записи
    ├── YTEVO03_lut_board.html + _files/
    └── *.bak.json                     # прошлые версии плана и кэша

{проект}/00_Setup/01_Ingest/YTEVO03_lut_plan.json   # ⚠️ ЛЕГАСИ, НЕ переезжает
~/YTAI/YTs/YTEVO/color_profile.json                 # ДНК канала
~/Library/Application Support/Adobe/Common/LUTs/Input/YTAI/      # проявочные
~/Library/Application Support/Adobe/Common/LUTs/Creative/YTAI/   # покрасочные

Герой — 12_Site_Blessing/RYA-ZVE1-1928.MP4, один из 18 клипов дня, где человек пошёл против машины.

// YTEVO03_gamma_cache.json → clips — откуда мы знаем гамму
"12_Site_Blessing/RYA-ZVE1-1928.MP4": {
  "gamma": "S-Log3", "gamma_raw": "s-log3-cine", "source": "legacy_lut_plan",
  "cam": "CAM-B_ZVE1", "pix_fmt": "yuv422p10le",
  "size": null, "mtime": null,        // оригинал — симлинк на снятую карту
  "measured": "2026-09-21T10:32:49+0300"
}

// YTEVO03_color_plan.json → clips — паспорт клипа: что мы про него выяснили
"12_Site_Blessing/RYA-ZVE1-1928.MP4": {
  "scene": "12_Site_Blessing", "clip": "RYA-ZVE1-1928.MP4",
  "slug": "12_Site_Blessing_RYA_ZVE1_1928",
  "cam": "CAM-B_ZVE1", "gamma": "S-Log3",
  "gamma_source": "кэш (legacy_lut_plan)",
  "develop_source": "профиль: гамма S-Log3",
  "exposure_preview": 2.0, "exposure_source": "roman",
  "src": ".../01_Source/12_Site_Blessing/CAM-B_ZVE1/RYA-ZVE1-1928.MP4"
}

// YTEVO03_color_plan.json → plan — ровно то, что панель поставит на клип
"12_Site_Blessing/RYA-ZVE1-1928.MP4": {
  "develop": "sony__slog3_sgamut3cine__rec709__neutral__legacy",
  "exposure": 4.8,        // 2.0 витрины × 2,4 = стопы Lumetri
  "look": "look__newstar"
}

• clips отвечает «почему», plan — «что ставить». Панели нужен второй блок, человеку через полгода — первый. Разделены намеренно: plan читается машиной и не разрастается, clips хранит происхождение каждого решения.
• Проявку не выбирали на этот клип — её принёс профиль канала. develop_source: "профиль: гамма S-Log3", и в color_profile.json у S-Log3 стоит sony__slog3_sgamut3cine__rec709__neutral__legacy с камерами CAM-A_FX3 и CAM-B_ZVE1. Решает гамма, камера идёт справкой.
• Экспозицию выбрал человек, и в файле это видно: corrected["12_Site_Blessing_RYA_ZVE1_1928"] = [1, 2] — машина предлагала +1, Роман поставил +2. Пара хранится целиком, а не одним итогом: иначе не на чем учить цель target_face_luma 134, которая и выучена по таким расхождениям.
• ⚠️ Гамма не измерялась ни у одного клипа дня. Все 163 записи кэша имеют source: "legacy_lut_plan", живых замеров 0: оригиналы — симлинки на съёмную карту, и пока карта не в слоте, size и mtime остаются null. Отсюда правило: легаси-файл 00_Setup/01_Ingest/{CODE}_lut_plan.json не переносят и не удаляют.

• Имя файла — не доказательство. DJI Action basic.cube содержит внутри # Mavic 3 Pro, D-Log M, и байт-в-байт тот же файл лежит как DJI OSMO Osmo Nano D-Log M.cube. Модель принимается, только если её подтверждает комментарий внутри куба или человек.
• Вендора искать по basename архива и внутреннему пути, а не по полному пути. Верхняя папка коллекции перечисляет вендоров в своём названии — поиск по пути пометит все панасониковские кубы как Canon.
• Pre-LUT в коллекции физически один: семь копий под именами Dji / Slog2 / Slog3 / Pocket 4 байт-в-байт идентичны, имена врут про вендора.
• Дефис внутри слова ≠ отдельно стоящий знак. S-Log3 → slog3, D-Log2 → dlog2; но «Contr −» и «Contr +» — часть названия, и дописываются явно. Через общую таблицу замен «S-Log3» превращается в sminuslog3.
• Кириллицу в именах считать ДО дедупликации: единственный кириллический файл коллекции — байт-дубль, после дедупа счётчик молча покажет ноль.
• Один zip со снятым UTF-8-флагом даёт мохибейк 4р вместо 4р; лечится name.encode('cp437').decode('utf-8'). Имена папок macOS приходят в NFD — любое сравнение только после normalize('NFC', …).
• AppleDouble ._*.cube внутри архивов имеют собственные sha256 и без фильтра по префиксу заводят фантомные записи в манифест.
• *.cube в .gitignore глобально — нельзя: под git уже лежат 12 кубов (шаблоны папок проектов и бандл UXP-панели). Игнорируется только store/.
• store не может лежать внутри коллекции-источника — импорт читал бы собственный вывод; проверка стоит на старте.

• Автоклассификатор ступени отвергнут как решающий. Ни одна метрика не делит коллекцию чисто: identity_rmse255 — перекрытие 158 из 166, neutral_drift255 — полное, black_share — 141, slope_mid — 43. В папке «проявочные для DJI» лежат 19 кубов с наклоном 0,97–1,38, то есть по поведению look'и. Папка говорит о замысле автора, метрики — о поведении, и это разные вещи.
• В .cube быстрее всего меняется КРАСНЫЙ: reshape(N,N,N,3) даёт индексацию [b,g,r]. Перепутать — получить куб, переставляющий каналы в тенях; на глаз ловится не сразу, поэтому самопроверка гоняется на каждом запуске.
• Два диалекта .cube: Resolve (пробелы, LF) и LUT Editor (таб после LUT_3D_SIZE, CRLF, без TITLE). line.split() без аргумента ест оба.
• white_share для проявки — не флаг: проявки уходят в белое со входа 0,855–0,867, это осознанный ролловф. Предупреждение остаётся только для look'ов.
• Монотонность — величина, а не булев флаг: настоящие кубы дрожат на доли кодового значения (Canon Vision — просадка 0,59/255, это квантование), а перевёрнутая кривая теряет десятки. Отсюда порог 2,0/255.
• Выход за [0,1] у pre — смысл, а не ошибка: Alexa709 to WDR доходит до 1,051, 3,03 % значений вне диапазона. Для develop и look это ошибка.

• Серый клин не заменяет реальные кадры. Пара DJI + / − различается на клине на 3 пункта (9,2 % против 6,2 %), а на материале дня — на 23 (23,4 % против 0,04 %, замер по 76 кадрам). Клин отбирает кандидатов, решают кадры.
• Имя проб-кадра несёт id проявки. Иначе кадры переживают смену рекомендации и остаются от прошлого прогона — а в самом первом прогоне гамма ещё не определялась, и вся экспозиция считалась бы по логарифмическим кадрам.
• Целость кадра — не по весу файла. Вес JPEG зависит от детальности, а не от целости: тёмный интерьер — 1234 байта при luma 17, ровная светлая стена — 1504 байта при luma 161, оба кадра идеальны, а порог по весу забраковал шесть таких из 163. Настоящая проверка — im.load().
• 1110 картинок на одной странице — без content-visibility:auto и contain-intrinsic-size браузер считает раскладку для всех сразу, и прокрутка дёргается.