Быстрый приём: сохранение в catched, добавление в qBittorrent — шаг worker'а

Приём (Ingest) стал быстрым: синхронно только парс magnet, синтез контекста из
полей ссылки, атомарный дедуп и запись загрузки в новое состояние `catched` —
ответ клиенту сразу. Медленный вывод имени (LLM) и добавление в qBittorrent
вынесены в асинхронный шаг машины состояний, который двигает worker.

- store: состояние `catched` (нетерминальное, активная группа); атомарный
  переход PromoteCatched (catched → downloading + display_name) с гардом
  state='catched' (ре-валидация после сетевых вызовов вне блокировки)
- ingest: убраны namer/qbt из пути приёма; пишем `catched`, отвечаем сразу
- worker.processCatched: вне w.mu выводит имя и qbt.Add, под w.mu — короткий
  переход; сбой add оставляет catched (ретрай тиком); предохранитель
  catch_timeout → failed(qbit_add)+notify; catched исключён из проверок пропажи
- config: worker.catch_timeout (дефолт 10m)
- веб-UI: бейдж catched, активная группа, самозавершающийся htmx-поллинг
  карточки/страницы до перехода в downloading; Telegram-текст без сырого catched
- OpenSpec: дельты ingest/download-tracking/web-ui влиты в спеки, change
  заархивирован

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

openspec/specs/ingest/spec.md

@@ -11,20 +11,22 @@
 ## Requirements
 ### Requirement: Отображаемое имя торрента из контекста
 
-При добавлении загрузки в qBittorrent система SHALL выводить из контекста
-загрузки человекочитаемое отображаемое имя и передавать его в qBittorrent
-(параметр `rename` API `/torrents/add`), чтобы задача в списке qBit не
-показывалась безликим `dn` magnet-ссылки. Это же имя система SHALL **сохранять
-у загрузки** (`download.display_name`) для последующего показа заголовком в
-веб-UI.
+На шаге добавления пойманной загрузки в qBittorrent (worker) система SHALL
+выводить из контекста загрузки человекочитаемое отображаемое имя и передавать
+его в qBittorrent (параметр `rename` API `/torrents/add`), чтобы задача в списке
+qBit не показывалась безликим `dn` magnet-ссылки. Это же имя система SHALL
+**сохранять у загрузки** (`download.display_name`) для последующего показа
+заголовком в веб-UI.
 
 Имя SHALL быть коротким читаемым ярлыком (название, опционально режиссёр и
 год; для сериала — номер сезона, если он определён), а не куском сырого
 контекста. Имя SHALL очищаться от управляющих символов и переводов строк и
 SHALL обрезаться по ограничению длины.
 
-Вывод имени SHALL выполняться синхронно перед отдачей источника в
-qBittorrent (параметр `rename` действует только в момент добавления).
+Вывод имени SHALL выполняться на шаге добавления, непосредственно перед вызовом
+`add` (параметр `rename` действует только в момент добавления), а НЕ в
+синхронном пути ответа приёма. В состоянии `catched` (до добавления)
+`download.display_name` ещё пуст — веб-UI берёт заголовок из фолбека.
 
 Отображаемое имя SHALL влиять только на отображение (в qBittorrent и как
 заголовок в веб-UI) и SHALL NOT влиять на пути файлов на диске, распознавание
@@ -32,17 +34,17 @@ qBittorrent (параметр `rename` действует только в мом
 
 #### Scenario: Имя из контекста передаётся в qBittorrent
 
-- **WHEN** загрузку добавляют с непустым контекстом, из которого удалось
-  получить имя
+- **WHEN** на шаге добавления получен непустой контекст, из которого удалось
+  вывести имя
 - **THEN** система передаёт это имя в qBittorrent в параметре `rename`
 - **AND** имя — короткий читаемый ярлык вида «название (режиссёр, год)»,
   где режиссёр и год опциональны
 
 #### Scenario: Имя сохраняется у загрузки
 
-- **WHEN** при приёме получено непустое отображаемое имя
-- **THEN** система сохраняет его в `download.display_name` вместе с созданием
-  загрузки
+- **WHEN** на шаге добавления выведено непустое отображаемое имя
+- **THEN** система сохраняет его в `download.display_name` (обновлением записи
+  загрузки)
 - **AND** веб-UI использует его заголовком карточки и страницы загрузки
 
 #### Scenario: Контекст пуст или имя не получено
@@ -111,29 +113,37 @@ JSON-вывод), извлекая из контекста тип (movie/series)
 
 ### Requirement: Приём источника и заведение загрузки
 
-Приём SHALL быть единым use-case, общим для всех транспортов (HTTP, Telegram,
-CLI): по источнику (Ф1 — magnet) и текстовому контексту система SHALL извлечь
-инфохэши, дедуплицировать по активной задаче, при отсутствии дубля завести
-загрузку (`download` в состоянии `downloading` + записи `download_infohash`) и
-отдать источник в qBittorrent (категория `qbittorrent.category`, savepath). Если
-добавление в qBittorrent не удалось, система SHALL перевести уже заведённую
-загрузку в `failed` (`error_code` `qbit_add`) и уведомить автора. Заведение
-загрузки и запись её хешей SHALL выполняться атомарно (см. «Атомарность возврата
-загрузки в активное состояние»).
+Приём SHALL быть единым **быстрым** use-case, общим для всех транспортов (HTTP,
+Telegram, CLI): по источнику (Ф1 — magnet) и текстовому контексту система SHALL
+синхронно извлечь инфохэши, синтезировать контекст из полей ссылки (без сети),
+дедуплицировать по активной задаче и при отсутствии дубля завести загрузку
+(`download` в состоянии **`catched`** + записи `download_infohash`), после чего
+**сразу вернуть ответ** транспорту. Заведение загрузки и запись её хешей SHALL
+выполняться атомарно (см. «Атомарность возврата загрузки в активное
+состояние»).
 
-#### Scenario: Успешный приём magnet
+Синхронный путь приёма SHALL NOT обращаться к qBittorrent и SHALL NOT выводить
+отображаемое имя (потенциально медленный LLM): и добавление источника в
+qBittorrent, и вывод имени выполняются отдельным асинхронным шагом машины
+состояний (worker) — см. `download-tracking` «Добавление пойманной загрузки в
+qBittorrent».
+
+`catched` — нетерминальное активное состояние: оно участвует в инварианте «не
+более одной активной загрузки на infohash» наравне с прочими активными.
+
+#### Scenario: Быстрый приём magnet
 
 - **GIVEN** валидная magnet-ссылка и контекст
 - **WHEN** вызывается приём
-- **THEN** создаётся `download` в `downloading` с записями `download_infohash`
-- **AND** источник отдан в qBittorrent с нашей категорией
+- **THEN** создаётся `download` в состоянии `catched` с записями
+  `download_infohash`
+- **AND** ответ транспорту отдан без обращения к qBittorrent и без вывода имени
 
-#### Scenario: Падение добавления в qBittorrent
+#### Scenario: Дубль по активной задаче на быстром пути
 
-- **GIVEN** заведённую загрузку не удалось добавить в qBittorrent
-- **WHEN** обрабатывается ошибка добавления
-- **THEN** загрузка переходит в `failed` с `error_code` `qbit_add`
-- **AND** автор загрузки уведомляется
+- **GIVEN** уже есть активная (в т.ч. `catched`) загрузка с тем же infohash
+- **WHEN** вызывается приём
+- **THEN** новая загрузка не создаётся, возвращается существующая
 
 ### Requirement: Множество инфохэшей загрузки