jellybit/openspec/changes/large-release-recognition/proposal.md

## Why

Раздача «Отчаянные домохозяйки» — один торрент на 8 сезонов, 180 файлов — распозналась
негодно: в план попало ровно 100 файлов, потому что промпт усекает список файлов жёсткой
константой `defaultMaxFiles = 100`. Остальные 80 файлов модель не видела, в интерфейсе они
не показаны никак, а причины ревью распухли до сорока строк «пропуск серий в сезоне N».
Порядок строк раскладки в UI — тот, в каком их вернула модель, то есть вперемешку по
сезонам.

Просто поднять лимит нельзя: каждый элемент плана обязан нести дословную копию пути
(~70 токенов на кириллице), 180 файлов дают ~15k выходных токенов при нашем же потолке
`defaultMaxTokens = 4000`. Обрыв генерации при этом неотличим от мусора — `finish_reason`
из ответа разбирается, но не проверяется, и обрыв уходит в три бессмысленных ретрая
с полным промптом. Вход тут не проблема (12–15k токенов промпта — ничто для современной
модели), проблема целиком на стороне ответа.

## What Changes

- **BREAKING (контракт с моделью, не с пользователем)**: элемент `files[]` в ответе LLM
  адресует файл номером из напечатанного нами списка (`i`), а не дословной копией пути.
  `src` заполняем сами резолвом индекса. Выход падает с ~85 до ~14 токенов на файл; путь,
  которого нет в торренте, становится невыразимым. Старый формат с `src` принимается как
  запасной, чтобы привычка модели не давала ретрая на пустом месте.
- Негодный элемент ответа (номер вне диапазона, повторная адресация файла, элемент без
  номера и пути) отбрасывается поимённой причиной, а не роняет весь план: иначе одна
  ошибка в одном из 180 элементов воспроизводит ровно тот отказ, против которого change и
  затевается. Элемент, несущий и номер, и путь, резолвится по номеру, а расхождение между
  ними становится причиной ревью — бесплатной сверкой против сдвига адресации.
- Жёсткое усечение списка файлов снимается: модели показываются все файлы раздачи.
  `max_files` и `max_tokens` выводятся в `[recognition]` с дефолтами 500 и 8000 — сейчас
  оба зашиты в код и на проде не крутятся.
- Повторная попытка перестаёт переприсылать список файлов: номера названы в первом
  сообщении диалога, и цена неудачного распознавания больше не растёт вместе с числом
  попыток.
- Порядок файлов, напечатанных в промпте, детерминирован и совпадает с порядком резолва
  индексов — иначе повторное распознавание из ревью сдвинет привязку.
- Обрыв генерации (`finish_reason` = `length`) распознаётся как отдельная причина ухода
  в review и не ретраится тем же промптом.
- В раскладке видны все файлы торрента: попавшие в план — с ролью и целью, не попавшие —
  отдельной строкой. Молчаливый пропуск файла моделью перестаёт быть невидимым. Загрузки,
  распознанные до этого изменения, списка файлов не имеют — и виджет говорит об этом
  прямо, вместо того чтобы показать план как полный перечень.
- Строки раскладки упорядочены полностью — разложенные по (сезон, серия, путь), затем
  файлы плана без цели, затем файлы вне плана, — а не по порядку ответа модели.
- Причины ревью по нумерации серий сворачиваются: перечисление недостающих серий по
  сезону одной строкой и сводка покрытия плана вместо строки на каждый разрыв. Покрытие
  показывается, когда покрыты не все файлы, но блокирует авто-раскладку только
  непокрытый видеофайл: иначе опущенный моделью `.nfo` выключил бы авто-путь на типовых
  раздачах. Отсюда же следствие для решения: `Reasons` перестают быть однородным
  списком «причин не-авто» — в них появляются информационные строки, и решение
  считается по блокирующим причинам, а не по длине списка.

Вне объёма: детерминированный разбор сезона/серии из имён файлов и сверка с ответом
модели — следующий change (этап B). Здесь модель по-прежнему единственный источник
разметки файлов.

## Capabilities

### New Capabilities

Нет.

### Modified Capabilities

- `recognition`: контракт ответа LLM (адресация файла индексом вместо дословного пути),
  отказ от усечения списка файлов и вывод лимитов в конфиг, обрыв генерации как
  отдельная причина review, форма причин по нумерации серий, решение auto/review
  считается по блокирующим причинам (в `Reasons` появились информационные строки).
- `web-ui`: раскладка показывает все файлы раздачи, включая не попавшие в план, и
  упорядочена по сезону и серии.

## Impact

- `internal/recognize`: `prompt.go` (нумерация и печать списка, схема в промпте,
  correction-сообщение без повторной печати списка), `validate.go` (резолв индекса вместо
  поиска пути, отбраковка негодных элементов, свёртка предупреждений, покрытие по
  видеофайлам), `recognize.go` (упорядочивание входного списка в самом узле, лимиты,
  обработка обрыва).
- `internal/llm`: `finish_reason` доводится до вызывающего в `Response`.
- `internal/config`: `[recognition].max_files`, `[recognition].max_tokens`;
  `config.example.toml` и `docs/database.md` (настройки с числовым значением).
- `internal/httpapi/files.go` и `web/templates/partials/layout_widget.html`: сортировка,
  файлы вне плана, колонка `#` (номер строки виджета обязан совпасть с номером адресации
  либо исчезнуть), строка о недоступном списке файлов.
- Хранилище: миграция `0012` — колонка со списком файлов раздачи в таблице `recognition`,
  и правка ER-схемы в `docs/database.md` (без неё краснеет шаг `canon` гейта).
- Совместимость: сохранённые планы в БД хранят `src` путями и не меняются. Записи,
  созданные до миграции, списка файлов не имеют — виджет называет это явно. Уже
  применённые раскладки не затрагиваются.
- Риск: ошибка модели в индексе становится тихой (валидный, но не тот файл). Смягчение —
  требование уникальности индексов и сводка покрытия в причинах; перекрёстная проверка
  разметки приходит в этапе B.