jellybit/openspec/changes/archive/2026-07-11-field-resolution-display-name/proposal.md at 098695011f7e1ee98a71ee5d374f255315398c84

av/jellybit

Fork 0

Files

T

avandClaude Opus 4.8 02d4ecc2aa

display_name: слоистое разрешение полей + сохранение режиссёра из контекста

Единый источник полей отображаемого имени и один рендер полного ярлыка на
всех путях (старт и «Обновить имя»/авто-перелив). Раньше старт давал полный
«Название (режиссёр, год). Сезон N» но выбрасывал структуру, а перелив по
распознаванию — усечённый «Title (Year)».

- Слоистое разрешение скаляров имени: override → recognition(+match) →
новый базовый слой «контекст» (download.parsed_context, JSON naming.Fields).
- naming: публичные Fields/Label/Derive, вынесен единый рендер; удалён
FormatTitleYear. Сводка сезонов вынесена в recognize.SeasonSummary.
- Режиссёр из метабазы (решение A2): TMDB/TVDB credits через опциональный
metadata.DirectorProvider; авто-матч кладёт в plan.Director, ручной выбор
кандидата тянет credits и пиннит ovrDirector. Метабаза бьёт контекст.
- refreshDisplayNameLocked строит полный ярлык из эффективных полей;
инфо-панель ревью показывает загруженного режиссёра.
- Миграция 0011_parsed_context + ER-схема. Всё косметика: на пути/раскладку
не влияет, приём/вывод имени не валятся (best-effort).

Закрывает беклог-задачу «Кнопка „Обновить имя“: полный формат ярлыка».
OpenSpec: archive/2026-07-11-field-resolution-display-name (ingest,
recognition, metadata-match, review).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-11 11:50:08 +03:00

6.4 KiB

Raw Blame History

Why

Отображаемое имя (download.display_name) сейчас выводится по двум расходящимся правилам. На шаге добавления naming извлекает из контекста структуру (тип/название/год/режиссёр/сезон) и рендерит полный ярлык «Название (режиссёр, год). Сезон N», но структуру после рендера выбрасывает. А обновление имени по распознаванию (ручная кнопка «Обновить имя» и авто-перелив при матче) даёт усечённый Title (Year) — без режиссёра и сезона. В итоге режиссёр, добытый из контекста, теряется, а перелив ухудшает уже показанное имя.

Причина расхождения — у распознавания нет поля режиссёра, а извлечение из контекста нигде не сохраняется. Решаем в общем виде: поля имени приходят из разных источников в разное время (контекст — на старте; метабаза — при распознавании; правки — в ревью), поэтому вводим единый слоистый источник и одну функцию рендера ярлыка.

What Changes

Слоистое разрешение скалярных полей имени (тип, название, ориг. название, год, режиссёр, сезон-для-ярлыка): эффективное значение поля — первый непустой слой сверху вниз override (человек) → recognition (LLM + матч метабазы) → новый базовый слой «контекст» (извлечение naming на старте). Слои override→recognition уже существуют (effectivePlan/applyOverrides); добавляем нижний слой и единый хелпер разрешения.
Извлечение из контекста становится persistent. Структуру, которую naming извлекает на шаге добавления, сохраняем у загрузки в новой JSON-колонке (download.parsed_context), чтобы переиспользовать без повторного вызова LLM.
Режиссёр из метабазы. Подтверждённый матч TMDB/TVDB несёт режиссёра (credits), он вкладывается в план так же, как уже вкладываются каноничные название/год, и в разрешении бьёт контекстного (более проверенный источник).
Единый рендер ярлыка display_name. Одна функция строит полный ярлык «Название (режиссёр, год)» (+ для сериала сводка сезонов «. Сезон N» / «. Сезоны 1–3» / «спецвыпуски») из эффективных полей и зовётся и на старте, и при обновлении по распознаванию. Усечённый формат Title (Year) при обновлении убирается. Это закрывает беклог-задачу «Кнопка „Обновить имя“: полный формат».
Инфо-часть ревью показывает загруженного режиссёра (ранее — пустое зарезервированное место).

Всё перечисленное — косметика отображения: не влияет на пути файлов, распознавание или раскладку. Приём и вывод имени по-прежнему не валят загрузку.

Capabilities

New Capabilities

(нет — вводится слой внутри существующих capability, новых доменов нет)

Modified Capabilities

ingest: извлечение из контекста сохраняется у загрузки (parsed_context); обновление отображаемого имени переходит с Title (Year) на полный ярлык из эффективных полей (слоистое разрешение + сводка сезонов).
recognition: план несёт опциональное скалярное поле director (источник — подтверждённый матч, не LLM); режиссёр — недоверенное косметическое поле.
metadata-match: подтверждённый матч и кандидат несут режиссёра (TMDB/TVDB credits), когда он доступен, для вывода имени.
review: подтверждение матча обновляет имя полным ярлыком; инфо-часть выбранного источника показывает загруженного режиссёра.

Impact

Код: internal/naming (публичный рендер из эффективных полей, экспорт извлечённой структуры), internal/recognize (Plan.Director), internal/metadata (Candidate.Director + выборка credits в клиентах TMDB/TVDB), internal/worker (сохранение parsed_context на старте; хелпер effectiveFields; полный формат в refreshDisplayNameLocked), internal/store (миграция goose: колонка download.parsed_context; чтение/ запись), internal/httpapi (инфо-часть режиссёра; переиспользование seasonSummary).
БД: новая колонка download.parsed_context (TEXT, JSON) — обновить ER-схему docs/specs/database.md.
Внешние вызовы: дополнительный запрос credits к TMDB/TVDB при подтверждённом матче (best-effort, недоступность не валит распознавание).
Беклог: закрывается docs/backlog/knopka-obnovit-imya-polnyj-format.md.

6.4 KiB Raw Blame History

Why