docs: проект переведён на канон документов версии 4

- каталог задач: PLAN.md → ROADMAP.md с каноническими секциями, все 44 записи получили тип, заголовки приведены к форме своего типа - расхождения, найденные судьями канона: исключения инварианта «источник неприкосновенен», инвариант про один активный infohash, UTC в logging.md, поведение из architecture.md заменено ссылками на спеки - триггеры профиля ревью переписаны под умолчание standard
2026-08-06 13:32:06 +03:00
parent 905a1ee4d3
commit 66d39297c5
66 changed files with 334 additions and 204 deletions
@@ -1,8 +1,8 @@
 # Беклог

 Что **можно взять**. Одна задача = один файл `items/<slug>.md`
-+ строка здесь. Целей тут нет — они в [PLAN.md](PLAN.md): беклог — то, что берут,
-план — то, подо что берут. Порядка внутри секции нет: «что делать
+ строка здесь. Целей тут нет — они в [ROADMAP.md](ROADMAP.md): беклог — то, что
+берут, роадмап — то, подо что берут. Порядка внутри секции нет: «что делать
 дальше» отвечает набор спринта. Ведётся скиллом `tasks`.

 Секции «блокеры» здесь нет и не заводится: блокер — это состояние
@@ -10,43 +10,45 @@
 человека, а его следы — вопросами в файлах задач.

 ## Ядро продукта
- [Аниме с абсолютной нумерацией](items/anime-absolute-numbering.md) — аниме со сквозной нумерацией (#137) не раскладывается в SxxEyy, который ждёт Jellyfin — нужен пересчёт абсолютной нумерации
- [`addReq` не пересобирается из свежего `source_type` перед `Add` (окно namer'а)](items/catched-source-type-refresh.md) — При апгрейде magnet→.torrent в окне namer'а добавится magnet из устаревшего снимка; самоисцеляется через magnet_timeout→failed→Retry _(аудит 2026-07-17)_
- [Раздачи-копии диска (DVD/BluRay: VIDEO_TS/BDMV)](items/disc-image-releases.md) — раздача-образ диска (VIDEO_TS/BDMV) сейчас разбирается пофайлово вместо раскладки каталога целиком — редкий, но реальный случай
- [Веб-UI зовёт Cancel вместо Dismiss на не-терминальных → теряется `user_dismiss`](items/dismiss-marker-lost.md) — Функционально ок (Cancel даёт cancelled), но маркер user_dismiss в error_code теряется; расхождение с буквой спеки _(аудит 2026-07-17)_
- [Фетч .torrent по URL — остаток «единого окна»](items/torrent-url-fetch.md) — magnet и .torrent-файл приняты; остался фетч .torrent по URL (нужен SSRF-гард)
- [Confidence-гейт авто-раскладки: узаконить в спеке + сделать выключаемым (дефолт 0.7)](items/auto-link-confidence-gate.md) — Решено (B): гейт оставляем как доп. проверку на ревью — выключаемый порог, дефолт 0.85→0.7, записать в спеку
- [[idea] guessit как сервис-спутник](items/guessit-sidecar.md) — go-ptn слабее питоновского guessit — если точности пред-парса не хватит, завернуть guessit в сервис-спутник рядом с бинарём
- [Согласование канона нумерации серий с провайдером тега](items/episode-numbering-canon.md) — Косметика/редкость: порядок просмотра ок, но у тайтлов со спорным порядком (Бибоп) Jellyfin подтягивает не те подписи серий, если канон файлов ≠ дефолтный порядок провайдера тега
- [Раздачи с докачиванием (merge при повторном добавлении)](items/merge-incremental-redownload.md) — повторная заливка сериала целиком должна доложить недостающие эпизоды merge-раскладкой, не трогая существующие ссылки — блокирует типовой сценарий свежих сериалов
- [[idea] Многоступенчатая верификация привязки](items/multi-pass-verification.md) — несколько проходов распознавания с консенсусом подняли бы точность ценой стоимости/латентности — проработать, когда включать и как мерджить расхождения
- [Обучение на правках человека (few-shot из прошлых ревью)](items/learn-from-user-corrections.md) — правки человека (матч/тип/нумерация) не переиспользуются — few-shot из прошлых ревью поднял бы точность на «своих» трекерах без смены модели
- [Идентичность инфохэшей: split v1/v2 одного торрента + крафт-магнет отравляет владение (F4, F5)](items/infohash-identity-integrity.md) — split v1/v2 идентичность и крафт-магнет отравляют владение инфохэшами _(ревью 2026-07-08)_
- [Нити приёма: NoName в контексте, устаревшие комментарии, лог без причины, bencode-аллокации (N1, N3, N4, N5)](items/ingest-nits.md) — косметика приёма: NoName в контексте, устаревшие комментарии, лог, bencode-аллокации _(ревью 2026-07-08)_
- [[idea] Сила совпадения кандидата и пересмотр распознавания/матчинга](items/candidate-match-strength.md) — у кандидата метабазы нет метрики силы совпадения — список кандидатов на ревью нечем отсортировать по уверенности (сперва проработать процесс матчинга)
- [[idea] Сложные сериальные раздачи: все сезоны разом, паки, спецраскладки](items/complex-series-releases.md) — сложные раздачи (все сезоны разом, паки, смешанная нумерация) целостно не проработаны — распознавание/ревью/раскладка заточены под один сезон
- [Мгновенные обновления через SSE](items/sse-live-updates.md) — живые обновления на htmx-поллинге дают задержку и холостые запросы — SSE убрал бы то и другое (поллинг работает, поэтому улучшение, не блокер)
- [Проверка свободного места перед copy-fallback](items/free-space-check-copy-fallback.md) — copy-fallback при невозможности хардлинка может упереться в переполненный диск посреди раскладки — нет проверки места до копирования
- [Ревью уведомлений в Telegram (аудит текстов и формата)](items/telegram-messages-audit.md) — зонтичный проход по всем текстам бота: полнота карточек, единый язык, оформление; порождает под-задачи
- [Привязка уведомлений к источнику в ботах (мульти-бот)](items/notification-source-binding.md) — пинги и ревью должен получать автор загрузки в своём транспорте — нет привязки загрузки к источнику/отправителю (нужно для мульти-бота)
- [Версии/качество одного тайтла (репаки, апгрейд 1080p → 2160p)](items/title-versions-repacks.md) — По калибровке болей (2026-07-02) — не боль, из приоритета выпало
- [Внешние субтитры: пары VobSub и языковой суффикс](items/external-subtitles.md) — Привязка субтитр→серия уже работает; остались пары VobSub .idx+.sub и потеря Lang/Flags
- [Современный Web-UI как PWA](items/web-ui-pwa.md) — текущий server-rendered UI функционален — PWA (устанавливаемое, удобное с телефона) это улучшение большого объёма, не блокер
- [Полный редактор маппинга «файл → серия» и ручной режим ревью](items/review-mapping-editor.md) — правка S·E, «нумеровать подряд» и ручной режим при полном провале LLM были запланированы объёмом Ф5 и не заведены задачей — в ревью сегодня можно только подсказать текстом
- [Крайние случаи именования: многофайловый фильм, редакции, двойная серия](items/naming-edge-cases.md) — стэкинг частей (part1/cd1), редакции [edition-…] и двойная серия SxxEyy-Eyy описаны нарративом, но в file-layout не заказаны — раскладка таких раздач не определена
- [Локаль TVDB: перевод названия и оригинальное название](items/tvdb-title-locale.md) — [general].language правит только TMDB и промпт LLM — TVDB отдаёт primary name, и при language=ru в карточку ревью и имя папки попадает 哪吒之魔童降世 вместо «Нэчжа»
+
+- [✨ Пересчитывать абсолютную нумерацию аниме в SxxEyy](items/anime-absolute-numbering.md) — аниме со сквозной нумерацией (#137) не раскладывается в SxxEyy, который ждёт Jellyfin — нужен пересчёт абсолютной нумерации
+- [🐞 Пересобирать `addReq` из свежего `source_type` перед `Add` (окно namer'а)](items/catched-source-type-refresh.md) — При апгрейде magnet→.torrent в окне namer'а добавится magnet из устаревшего снимка; самоисцеляется через magnet_timeout→failed→Retry _(аудит 2026-07-17)_
+- [✨ Раскладывать раздачу-копию диска (VIDEO_TS/BDMV) каталогом целиком](items/disc-image-releases.md) — раздача-образ диска (VIDEO_TS/BDMV) сейчас разбирается пофайлово вместо раскладки каталога целиком — редкий, но реальный случай
+- [🐞 Не терять маркер `user_dismiss` при закрытии не-терминальной загрузки из веб-UI](items/dismiss-marker-lost.md) — Функционально ок (Cancel даёт cancelled), но маркер user_dismiss в error_code теряется; расхождение с буквой спеки _(аудит 2026-07-17)_
+- [✨ Принимать ссылку на .torrent и скачивать файл самим (нужен SSRF-гард)](items/torrent-url-fetch.md) — magnet и .torrent-файл приняты; остался фетч .torrent по URL (нужен SSRF-гард)
+- [✨ Узаконить confidence-гейт авто-раскладки в спеке и сделать его выключаемым (дефолт 0.7)](items/auto-link-confidence-gate.md) — Решено (B): гейт оставляем как доп. проверку на ревью — выключаемый порог, дефолт 0.85→0.7, записать в спеку
+- [✨ Докладывать недостающие эпизоды merge-раскладкой при повторной заливке](items/merge-incremental-redownload.md) — повторная заливка сериала целиком должна доложить недостающие эпизоды merge-раскладкой, не трогая существующие ссылки — блокирует типовой сценарий свежих сериалов
+- [✨ Подмешивать прошлые правки человека в промпт распознавания (few-shot)](items/learn-from-user-corrections.md) — правки человека (матч/тип/нумерация) не переиспользуются — few-shot из прошлых ревью поднял бы точность на «своих» трекерах без смены модели
+- [🐞 Связать v1/v2-хеши одного торрента и не доверять паре xt из магнета (F4, F5)](items/infohash-identity-integrity.md) — split v1/v2 идентичность и крафт-магнет отравляют владение инфохэшами _(ревью 2026-07-08)_
+- [🧹 Закрыть мелочи приёма: NoName в контексте, устаревшие комментарии, лог без причины, bencode-аллокации (N1, N3, N4, N5)](items/ingest-nits.md) — косметика приёма: NoName в контексте, устаревшие комментарии, лог, bencode-аллокации _(ревью 2026-07-08)_
+- [✨ Слать живые обновления через SSE вместо htmx-поллинга](items/sse-live-updates.md) — живые обновления на htmx-поллинге дают задержку и холостые запросы — SSE убрал бы то и другое (поллинг работает, поэтому улучшение, не блокер)
+- [✨ Проверять свободное место перед copy-fallback](items/free-space-check-copy-fallback.md) — copy-fallback при невозможности хардлинка может упереться в переполненный диск посреди раскладки — нет проверки места до копирования
+- [✨ Слать уведомления автору загрузки в его транспорт (мульти-бот)](items/notification-source-binding.md) — пинги и ревью должен получать автор загрузки в своём транспорте — нет привязки загрузки к источнику/отправителю (нужно для мульти-бота)
+- [✨ Заменять разложенную версию тайтла новой (репаки, апгрейд 1080p → 2160p)](items/title-versions-repacks.md) — По калибровке болей (2026-07-02) — не боль, из приоритета выпало
+- [✨ Спаривать VobSub .idx+.sub и проставлять языковой суффикс субтитра](items/external-subtitles.md) — Привязка субтитр→серия уже работает; остались пары VobSub .idx+.sub и потеря Lang/Flags
+- [✨ Переделать веб-UI в устанавливаемое PWA](items/web-ui-pwa.md) — текущий server-rendered UI функционален — PWA (устанавливаемое, удобное с телефона) это улучшение большого объёма, не блокер
+- [✨ Править на ревью маппинг «файл → серия» и раскладывать вручную при провале LLM](items/review-mapping-editor.md) — правка S·E, «нумеровать подряд» и ручной режим при полном провале LLM были запланированы объёмом Ф5 и не заведены задачей — в ревью сегодня можно только подсказать текстом
+- [✨ Заказать спекой крайние случаи именования: многофайловый фильм, редакции, двойная серия](items/naming-edge-cases.md) — стэкинг частей (part1/cd1), редакции [edition-…] и двойная серия SxxEyy-Eyy описаны нарративом, но в file-layout не заказаны — раскладка таких раздач не определена
+- [✨ Брать у TVDB название на языке настройки и оригинальное название](items/tvdb-title-locale.md) — [general].language правит только TMDB и промпт LLM — TVDB отдаёт primary name, и при language=ru в карточку ревью и имя папки попадает 哪吒之魔童降世 вместо «Нэчжа»
+- [🔬 Канон нумерации серий и порядок у провайдера тега](items/episode-numbering-canon.md) — Косметика/редкость: порядок просмотра ок, но у тайтлов со спорным порядком (Бибоп) Jellyfin подтягивает не те подписи серий, если канон файлов ≠ дефолтный порядок провайдера тега
+- [🔬 Тексты и формат уведомлений в Telegram](items/telegram-messages-audit.md) — зонтичный проход по всем текстам бота: полнота карточек, единый язык, оформление; порождает под-задачи
+- [🔬 guessit как сервис-спутник](items/guessit-sidecar.md) — go-ptn слабее питоновского guessit — если точности пред-парса не хватит, завернуть guessit в сервис-спутник рядом с бинарём
+- [🔬 Многоступенчатая верификация привязки](items/multi-pass-verification.md) — несколько проходов распознавания с консенсусом подняли бы точность ценой стоимости/латентности — проработать, когда включать и как мерджить расхождения
+- [🔬 Сила совпадения кандидата и пересмотр распознавания/матчинга](items/candidate-match-strength.md) — у кандидата метабазы нет метрики силы совпадения — список кандидатов на ревью нечем отсортировать по уверенности (сперва проработать процесс матчинга)
+- [🔬 Сложные сериальные раздачи: все сезоны разом, паки, спецраскладки](items/complex-series-releases.md) — сложные раздачи (все сезоны разом, паки, смешанная нумерация) целостно не проработаны — распознавание/ревью/раскладка заточены под один сезон

 ## Инфраструктура
- [Агенты-ревьюверы качества (наименования, архитектура, конвенции, стиль)](items/quality-review-agents.md) — конвейер ревью переехал в плагин `av-dev-pipeline`; осталась калибровка проходов на этом проекте и ревьювер наименований (ждёт словарь единого языка)
- [Авторизация веб-UI (на будущее)](items/web-ui-auth.md) — для v1 решено без авторизации (доверенная LAN, опц. allowlist подсетей) — задел на случай, если понадобится защита
- [Бэкап SQLite](items/sqlite-backup.md) — architecture требует бекапить data-том, но стратегия не описана — сбой или редеплой стирают всё in-flight состояние (проще, пока БД маленькая)
- [Eval-харнес распознавания (корпус кейсов + метрика точности)](items/recognition-eval-harness.md) — смена модели или правка промпта распознавания сейчас вслепую — нет корпуса кейсов и метрики точности, регрессии не видно
- [Глубокий healthcheck и статус зависимостей](items/deep-healthcheck-dependencies.md) — /healthz проверяет только сам сервис — недоступность qBittorrent/LLM/метабазы видна лишь по застрявшим задачам, нет readiness и бейджа в UI
- [История переходов загрузки](items/download-transition-history.md) — хранится только текущий статус загрузки — разбор «как сюда попали» идёт по логам сервера, нет таблицы истории переходов
- [Кэш метабаз (и опционально LLM)](items/metadata-cache.md) — повторные и ретраящиеся прогоны бьют TMDB/TVDB/TVMaze одним запросом — кэш с TTL сэкономил бы лимиты и ускорил «Распознать заново»
- [НФТ: масштаб до 100 одновременных загрузок (потолок — 1000)](items/scale-100-downloads.md) — Зафиксировать в НФТ ориентир 100/1000 загрузок + аудит узких мест (SQLite, воркер, поллинг)
- [Шум ERROR фоновых циклов при недоступной зависимости](items/background-error-noise.md) — Остаток задачи логирования: ext.* ERROR-шторм при недоступном qBittorrent + эскалация устойчивого сбоя тика _(ревью Fable)_
- [Ретеншн и очистка БД](items/db-retention-cleanup.md) — терминальные задачи и сырые ответы LLM копятся вечно — без авточистки список загрузок и БД деградируют по мере эксплуатации
- [Словарь единого языка (ubiquitous language)](items/ubiquitous-language-glossary.md) — наименования домена расходятся между спеками, UI и кодом — нет единого глоссария (на нём же стоит агент-ревьювер наименований)
- [[idea] Завершение загрузки через webhook](items/completion-webhook.md) — завершение сейчас ловим поллингом qBittorrent — webhook реагировал бы быстрее, но связывает нас с его конфигом (решим по опыту эксплуатации)
- [[idea] Кандидаты в конвенции кода](items/convention-candidates.md) — накоплен список кандидатов (внешние клиенты, конкурентность, тесты, CLI, время) — надо решить, что из них стало реальным трением, а что выдумано вперёд
+
+- [🧹 Откалибровать проходы ревью и завести ревьювер наименований](items/quality-review-agents.md) — конвейер ревью переехал в плагин `av-dev-pipeline`; осталась калибровка проходов на этом проекте и ревьювер наименований (ждёт словарь единого языка)
+- [✨ Закрыть веб-UI авторизацией, когда доверенной LAN станет мало](items/web-ui-auth.md) — для v1 решено без авторизации (доверенная LAN, опц. allowlist подсетей) — задел на случай, если понадобится защита
+- [🧹 Бэкапить SQLite по расписанию с ротацией](items/sqlite-backup.md) — architecture требует бекапить data-том, но стратегия не описана — сбой или редеплой стирают всё in-flight состояние (проще, пока БД маленькая)
+- [🧹 Завести eval-харнес распознавания: корпус кейсов и метрику точности](items/recognition-eval-harness.md) — смена модели или правка промпта распознавания сейчас вслепую — нет корпуса кейсов и метрики точности, регрессии не видно
+- [✨ Проверять в healthcheck доступность qBittorrent, LLM и метабаз и показывать её в UI](items/deep-healthcheck-dependencies.md) — /healthz проверяет только сам сервис — недоступность qBittorrent/LLM/метабазы видна лишь по застрявшим задачам, нет readiness и бейджа в UI
+- [✨ Хранить историю переходов загрузки отдельной таблицей](items/download-transition-history.md) — хранится только текущий статус загрузки — разбор «как сюда попали» идёт по логам сервера, нет таблицы истории переходов
+- [🧹 Кэшировать ответы метабаз с TTL (и опционально LLM)](items/metadata-cache.md) — повторные и ретраящиеся прогоны бьют TMDB/TVDB/TVMaze одним запросом — кэш с TTL сэкономил бы лимиты и ускорил «Распознать заново»
+- [🐞 Не штормить ERROR при недоступном qBittorrent и эскалировать устойчивый сбой тика](items/background-error-noise.md) — Остаток задачи логирования: ext.* ERROR-шторм при недоступном qBittorrent + эскалация устойчивого сбоя тика _(ревью Fable)_
+- [✨ Чистить БД от терминальных задач и сырых ответов LLM старше срока хранения](items/db-retention-cleanup.md) — терминальные задачи и сырые ответы LLM копятся вечно — без авточистки список загрузок и БД деградируют по мере эксплуатации
+- [🧹 Свести термины домена в словарь единого языка](items/ubiquitous-language-glossary.md) — наименования домена расходятся между спеками, UI и кодом — нет единого глоссария (на нём же стоит агент-ревьювер наименований)
+- [🔬 Потолок нагрузки: 100 одновременных загрузок, план-максимум 1000](items/scale-100-downloads.md) — Зафиксировать в НФТ ориентир 100/1000 загрузок + аудит узких мест (SQLite, воркер, поллинг)
+- [🔬 Завершение загрузки через webhook](items/completion-webhook.md) — завершение сейчас ловим поллингом qBittorrent — webhook реагировал бы быстрее, но связывает нас с его конфигом (решим по опыту эксплуатации)
+- [🔬 Кандидаты в конвенции кода](items/convention-candidates.md) — накоплен список кандидатов (внешние клиенты, конкурентность, тесты, CLI, время) — надо решить, что из них стало реальным трением, а что выдумано вперёд
@@ -1,22 +0,0 @@
-# План
-
-Оглавление целей. Цель — файл `[goal]` в `items/`; её задачи
-здесь **не перечисляются** — перечень даёт `tasks.py list --goal <слаг>`.
-В первой секции («порядок») очередь значима и обосновывается
-прозой; в остальных порядка нет — это тематические цели.
-
-## порядок
-
-Пусто. Фазы Ф0–Ф6 прежней дорожной карты (каркас, приём и трекинг,
-распознавание, раскладка и ревью, метаданные, Telegram и UX, деплой) закрыты —
-сквозной путь работает и развёрнут; закрытый шаг планом больше не является.
-Что было сделано и когда — по архиву `openspec/changes/archive/`.
-Следующая упорядоченная очередь появится, когда она понадобится.
-
-## темы
- [[goal] Точность распознавания](items/recognition-accuracy.md) — смена модели или правка промпта сегодня вслепую — нет ни метрики, ни способа переиспользовать уже сделанные человеком правки
- [[goal] Сложные раздачи](items/complex-releases.md) — типовая раздача раскладывается, а всё, что сложнее одного сезона одного тайтла, упирается в ручной разбор
- [[goal] Эксплуатационная прочность](items/operational-resilience.md) — сервис работает, но не переживает роста: база копится вечно, бэкапа нет, отказ зависимости виден только по застрявшим задачам
- [[goal] Интерфейсы приёма и ревью](items/ingest-and-review-interfaces.md) — путь «принести раздачу и подтвердить догадку» упирается в незакрытые куски интерфейсов, а не в логику
- [[goal] Целостность состояния и приёма](items/state-integrity.md) — известные окна рассинхрона и потери маркеров: каждое по отдельности самоисцеляется, вместе — источник необъяснимых состояний
- [[goal] Процесс и качество разработки](items/dev-process-quality.md) — наименования домена расходятся между спеками, UI и кодом, а конвейер ревью не откалиброван — растёт цена каждой следующей задачи
@@ -0,0 +1,34 @@
+# Роадмап
+
+Что приложение уже умеет и чего ещё не умеет. Цель — файл типа `goal` в
+`items/`; её задачи здесь **не перечисляются** — перечень даёт
+`tasks.py list --goal <слаг>`. В `Запланировано` очередь значима и
+обосновывается прозой; в `Направлениях` порядка нет; `Сопровождение` — то, чем
+держат проект, а не возможности приложения; в `Готово` строку с датой пишет
+`close --implemented`.
+
+## Запланировано
+
+Пусто. Фазы Ф0–Ф6 прежней дорожной карты (каркас, приём и трекинг,
+распознавание, раскладка и ревью, метаданные, Telegram и UX, деплой) закрыты —
+сквозной путь работает и развёрнут; закрытый шаг планом больше не является.
+Следующая упорядоченная очередь появится, когда она понадобится.
+
+## Направления
+
+- [🎯 Раздача узнаётся верно, и точность этого измерима](items/recognition-accuracy.md) — смена модели или правка промпта сегодня вслепую — нет ни метрики, ни способа переиспользовать уже сделанные человеком правки
+- [🎯 Раскладывается не только типовая раздача](items/complex-releases.md) — типовая раздача раскладывается, а всё, что сложнее одного сезона одного тайтла, упирается в ручной разбор
+- [🎯 Раздача приносится и подтверждается из любого транспорта](items/ingest-and-review-interfaces.md) — путь «принести раздачу и подтвердить догадку» упирается в незакрытые куски интерфейсов, а не в логику
+- [🎯 По записи загрузки видно, как она сюда попала](items/state-integrity.md) — известные окна рассинхрона и потери маркеров: каждое по отдельности самоисцеляется, вместе — источник необъяснимых состояний
+
+## Сопровождение
+
+- [🎯 Сервис переживает рост и потерю тома](items/operational-resilience.md) — сервис работает, но не переживает роста: база копится вечно, бэкапа нет, отказ зависимости виден только по застрявшим задачам
+- [🎯 Домен называется одинаково везде, ревью откалибровано](items/dev-process-quality.md) — наименования домена расходятся между спеками, UI и кодом, а конвейер ревью не откалиброван — растёт цена каждой следующей задачи
+
+## Готово
+
+Пусто. Фазы Ф0–Ф6 велись прозой и целями в роадмапе не числились, поэтому
+строк с датами за ними нет; что было сделано и когда — по архиву
+`openspec/changes/archive/`. Первую строку сюда впишет `close --implemented`
+на первой достигнутой цели.
@@ -1,6 +1,7 @@
-# Аниме с абсолютной нумерацией
+# ✨ Пересчитывать абсолютную нумерацию аниме в SxxEyy

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** аниме со сквозной нумерацией (#137) не раскладывается в SxxEyy, который ждёт Jellyfin — нужен пересчёт абсолютной нумерации
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Confidence-гейт авто-раскладки: узаконить в спеке + сделать выключаемым (дефолт 0.7)
+# ✨ Узаконить confidence-гейт авто-раскладки в спеке и сделать его выключаемым (дефолт 0.7)

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** Решено (B): гейт оставляем как доп. проверку на ревью — выключаемый порог, дефолт 0.85→0.7, записать в спеку
 - **Теги:** goal:recognition-accuracy

@@ -35,7 +36,12 @@
   вспомогательный сигнал». Добавить сценарий: матч + чистая валидация +
   согласованность, но `confidence` ниже порога → review.
 4. **Конфиг-конвенция/дока:** описать ключ в `docs/conventions/config.md` (диапазон
-   [0,1], 0 = выкл, дефолт 0.7).
+   [0,1], 0 = выкл, дефолт 0.7) и поправить значение в таблице «Настройки с
+   числовым значением» [docs/database.md](../../database.md) — дом числа там, и
+   при смене дефолта оно разъедется первым. Формулировки инварианта в
+   `CLAUDE.md` и ложноположительного в `docs/review.md` уже приведены к
+   «единственным гейтом не является» (канон 4, 2026-08-06) — переписывать их
+   задача не должна.
 5. **Тесты:** `decide` с `threshold=0` (гейт выключен, авто при чистых 1–3);
   confidence ниже/выше порога при выполненных 1–3.
 6. Точное число порога откалибровать позже — для этого есть задача
@@ -1,6 +1,7 @@
-# Шум ERROR фоновых циклов при недоступной зависимости
+# 🐞 Не штормить ERROR при недоступном qBittorrent и эскалировать устойчивый сбой тика

- **Секция:** инфраструктура
+- **Тип:** fix
+- **Категория:** Инфраструктура
 - **Зачем:** Остаток задачи логирования: ext.* ERROR-шторм при недоступном qBittorrent + эскалация устойчивого сбоя тика _(ревью Fable)_
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# [idea] Сила совпадения кандидата и пересмотр распознавания/матчинга
+# 🔬 Сила совпадения кандидата и пересмотр распознавания/матчинга

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** у кандидата метабазы нет метрики силы совпадения — список кандидатов на ревью нечем отсортировать по уверенности (сперва проработать процесс матчинга)
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# `addReq` не пересобирается из свежего `source_type` перед `Add` (окно namer'а)
+# 🐞 Пересобирать `addReq` из свежего `source_type` перед `Add` (окно namer'а)

- **Секция:** ядро продукта
+- **Тип:** fix
+- **Категория:** Ядро продукта
 - **Зачем:** При апгрейде magnet→.torrent в окне namer'а добавится magnet из устаревшего снимка; самоисцеляется через magnet_timeout→failed→Retry _(аудит 2026-07-17)_
 - **Теги:** goal:state-integrity

@@ -1,6 +1,7 @@
-# [idea] Завершение загрузки через webhook
+# 🔬 Завершение загрузки через webhook

- **Секция:** инфраструктура
+- **Тип:** research
+- **Категория:** Инфраструктура
 - **Зачем:** завершение сейчас ловим поллингом qBittorrent — webhook реагировал бы быстрее, но связывает нас с его конфигом (решим по опыту эксплуатации)
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# [goal] Сложные раздачи
+# 🎯 Раскладывается не только типовая раздача

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Направления
 - **Зачем:** типовая раздача раскладывается, а всё, что сложнее одного сезона одного тайтла, упирается в ручной разбор
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# [idea] Сложные сериальные раздачи: все сезоны разом, паки, спецраскладки
+# 🔬 Сложные сериальные раздачи: все сезоны разом, паки, спецраскладки

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** сложные раздачи (все сезоны разом, паки, смешанная нумерация) целостно не проработаны — распознавание/ревью/раскладка заточены под один сезон
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# [idea] Кандидаты в конвенции кода
+# 🔬 Кандидаты в конвенции кода

- **Секция:** Инфраструктура
+- **Тип:** research
+- **Категория:** Инфраструктура
 - **Зачем:** накоплен список кандидатов (внешние клиенты, конкурентность, тесты, CLI, время) — надо решить, что из них стало реальным трением, а что выдумано вперёд
 - **Теги:** goal:dev-process-quality

@@ -1,6 +1,7 @@
-# Ретеншн и очистка БД
+# ✨ Чистить БД от терминальных задач и сырых ответов LLM старше срока хранения

- **Секция:** инфраструктура
+- **Тип:** feature
+- **Категория:** Инфраструктура
 - **Зачем:** терминальные задачи и сырые ответы LLM копятся вечно — без авточистки список загрузок и БД деградируют по мере эксплуатации
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# Глубокий healthcheck и статус зависимостей
+# ✨ Проверять в healthcheck доступность qBittorrent, LLM и метабаз и показывать её в UI

- **Секция:** инфраструктура
+- **Тип:** feature
+- **Категория:** Инфраструктура
 - **Зачем:** /healthz проверяет только сам сервис — недоступность qBittorrent/LLM/метабазы видна лишь по застрявшим задачам, нет readiness и бейджа в UI
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# [goal] Процесс и качество разработки
+# 🎯 Домен называется одинаково везде, ревью откалибровано

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Сопровождение
 - **Зачем:** наименования домена расходятся между спеками, UI и кодом, а конвейер ревью не откалиброван — растёт цена каждой следующей задачи
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# Раздачи-копии диска (DVD/BluRay: VIDEO_TS/BDMV)
+# ✨ Раскладывать раздачу-копию диска (VIDEO_TS/BDMV) каталогом целиком

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** раздача-образ диска (VIDEO_TS/BDMV) сейчас разбирается пофайлово вместо раскладки каталога целиком — редкий, но реальный случай
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Веб-UI зовёт Cancel вместо Dismiss на не-терминальных → теряется `user_dismiss`
+# 🐞 Не терять маркер `user_dismiss` при закрытии не-терминальной загрузки из веб-UI

- **Секция:** ядро продукта
+- **Тип:** fix
+- **Категория:** Ядро продукта
 - **Зачем:** Функционально ок (Cancel даёт cancelled), но маркер user_dismiss в error_code теряется; расхождение с буквой спеки _(аудит 2026-07-17)_
 - **Теги:** goal:state-integrity

@@ -1,6 +1,7 @@
-# История переходов загрузки
+# ✨ Хранить историю переходов загрузки отдельной таблицей

- **Секция:** инфраструктура
+- **Тип:** feature
+- **Категория:** Инфраструктура
 - **Зачем:** хранится только текущий статус загрузки — разбор «как сюда попали» идёт по логам сервера, нет таблицы истории переходов
 - **Теги:** goal:state-integrity

@@ -1,6 +1,7 @@
-# Согласование канона нумерации серий с провайдером тега
+# 🔬 Канон нумерации серий и порядок у провайдера тега

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** Косметика/редкость: порядок просмотра ок, но у тайтлов со спорным порядком (Бибоп) Jellyfin подтягивает не те подписи серий, если канон файлов ≠ дефолтный порядок провайдера тега
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Внешние субтитры: пары VobSub и языковой суффикс
+# ✨ Спаривать VobSub .idx+.sub и проставлять языковой суффикс субтитра

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** Привязка субтитр→серия уже работает; остались пары VobSub .idx+.sub и потеря Lang/Flags
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Проверка свободного места перед copy-fallback
+# ✨ Проверять свободное место перед copy-fallback

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** copy-fallback при невозможности хардлинка может упереться в переполненный диск посреди раскладки — нет проверки места до копирования
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# [idea] guessit как сервис-спутник
+# 🔬 guessit как сервис-спутник

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** go-ptn слабее питоновского guessit — если точности пред-парса не хватит, завернуть guessit в сервис-спутник рядом с бинарём
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# Идентичность инфохэшей: split v1/v2 одного торрента + крафт-магнет отравляет владение (F4, F5)
+# 🐞 Связать v1/v2-хеши одного торрента и не доверять паре xt из магнета (F4, F5)

- **Секция:** ядро продукта
+- **Тип:** fix
+- **Категория:** Ядро продукта
 - **Зачем:** split v1/v2 идентичность и крафт-магнет отравляют владение инфохэшами _(ревью 2026-07-08)_
 - **Теги:** goal:state-integrity

@@ -1,6 +1,7 @@
-# [goal] Интерфейсы приёма и ревью
+# 🎯 Раздача приносится и подтверждается из любого транспорта

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Направления
 - **Зачем:** путь «принести раздачу и подтвердить догадку» упирается в незакрытые куски интерфейсов, а не в логику
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# Нити приёма: NoName в контексте, устаревшие комментарии, лог без причины, bencode-аллокации (N1, N3, N4, N5)
+# 🧹 Закрыть мелочи приёма: NoName в контексте, устаревшие комментарии, лог без причины, bencode-аллокации (N1, N3, N4, N5)

- **Секция:** ядро продукта
+- **Тип:** chore
+- **Категория:** Ядро продукта
 - **Зачем:** косметика приёма: NoName в контексте, устаревшие комментарии, лог, bencode-аллокации _(ревью 2026-07-08)_
 - **Теги:** goal:state-integrity

@@ -1,6 +1,7 @@
-# Обучение на правках человека (few-shot из прошлых ревью)
+# ✨ Подмешивать прошлые правки человека в промпт распознавания (few-shot)

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** правки человека (матч/тип/нумерация) не переиспользуются — few-shot из прошлых ревью поднял бы точность на «своих» трекерах без смены модели
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# Раздачи с докачиванием (merge при повторном добавлении)
+# ✨ Докладывать недостающие эпизоды merge-раскладкой при повторной заливке

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** повторная заливка сериала целиком должна доложить недостающие эпизоды merge-раскладкой, не трогая существующие ссылки — блокирует типовой сценарий свежих сериалов
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Кэш метабаз (и опционально LLM)
+# 🧹 Кэшировать ответы метабаз с TTL (и опционально LLM)

- **Секция:** инфраструктура
+- **Тип:** chore
+- **Категория:** Инфраструктура
 - **Зачем:** повторные и ретраящиеся прогоны бьют TMDB/TVDB/TVMaze одним запросом — кэш с TTL сэкономил бы лимиты и ускорил «Распознать заново»
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# [idea] Многоступенчатая верификация привязки
+# 🔬 Многоступенчатая верификация привязки

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** несколько проходов распознавания с консенсусом подняли бы точность ценой стоимости/латентности — проработать, когда включать и как мерджить расхождения
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# Крайние случаи именования: многофайловый фильм, редакции, двойная серия
+# ✨ Заказать спекой крайние случаи именования: многофайловый фильм, редакции, двойная серия

- **Секция:** Ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** стэкинг частей (part1/cd1), редакции [edition-…] и двойная серия SxxEyy-Eyy описаны нарративом, но в file-layout не заказаны — раскладка таких раздач не определена
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Привязка уведомлений к источнику в ботах (мульти-бот)
+# ✨ Слать уведомления автору загрузки в его транспорт (мульти-бот)

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** пинги и ревью должен получать автор загрузки в своём транспорте — нет привязки загрузки к источнику/отправителю (нужно для мульти-бота)
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# [goal] Эксплуатационная прочность
+# 🎯 Сервис переживает рост и потерю тома

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Сопровождение
 - **Зачем:** сервис работает, но не переживает роста: база копится вечно, бэкапа нет, отказ зависимости виден только по застрявшим задачам
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# Агенты-ревьюверы качества (наименования, архитектура, конвенции, стиль)
+# 🧹 Откалибровать проходы ревью и завести ревьювер наименований

- **Секция:** инфраструктура
+- **Тип:** chore
+- **Категория:** Инфраструктура
 - **Зачем:** конвейер ревью переехал в плагин `av-dev-pipeline`; осталась калибровка проходов на этом проекте и ревьювер наименований (ждёт словарь единого языка)
 - **Теги:** goal:dev-process-quality

@@ -1,6 +1,7 @@
-# [goal] Точность распознавания
+# 🎯 Раздача узнаётся верно, и точность этого измерима

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Направления
 - **Зачем:** смена модели или правка промпта сегодня вслепую — нет ни метрики, ни способа переиспользовать уже сделанные человеком правки
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# Eval-харнес распознавания (корпус кейсов + метрика точности)
+# 🧹 Завести eval-харнес распознавания: корпус кейсов и метрику точности

- **Секция:** инфраструктура
+- **Тип:** chore
+- **Категория:** Инфраструктура
 - **Зачем:** смена модели или правка промпта распознавания сейчас вслепую — нет корпуса кейсов и метрики точности, регрессии не видно
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# Полный редактор маппинга «файл → серия» и ручной режим ревью
+# ✨ Править на ревью маппинг «файл → серия» и раскладывать вручную при провале LLM

- **Секция:** Ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** правка S·E, «нумеровать подряд» и ручной режим при полном провале LLM были запланированы объёмом Ф5 и не заведены задачей — в ревью сегодня можно только подсказать текстом
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# НФТ: масштаб до 100 одновременных загрузок (потолок — 1000)
+# 🔬 Потолок нагрузки: 100 одновременных загрузок, план-максимум 1000

- **Секция:** инфраструктура
+- **Тип:** research
+- **Категория:** Инфраструктура
 - **Зачем:** Зафиксировать в НФТ ориентир 100/1000 загрузок + аудит узких мест (SQLite, воркер, поллинг)
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# Бэкап SQLite
+# 🧹 Бэкапить SQLite по расписанию с ротацией

- **Секция:** инфраструктура
+- **Тип:** chore
+- **Категория:** Инфраструктура
 - **Зачем:** architecture требует бекапить data-том, но стратегия не описана — сбой или редеплой стирают всё in-flight состояние (проще, пока БД маленькая)
 - **Теги:** goal:operational-resilience

@@ -1,6 +1,7 @@
-# Мгновенные обновления через SSE
+# ✨ Слать живые обновления через SSE вместо htmx-поллинга

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** живые обновления на htmx-поллинге дают задержку и холостые запросы — SSE убрал бы то и другое (поллинг работает, поэтому улучшение, не блокер)
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# [goal] Целостность состояния и приёма
+# 🎯 По записи загрузки видно, как она сюда попала

- **Секция:** темы
+- **Тип:** goal
+- **Секция:** Направления
 - **Зачем:** известные окна рассинхрона и потери маркеров: каждое по отдельности самоисцеляется, вместе — источник необъяснимых состояний
 - **Теги:** decomposed

@@ -1,6 +1,7 @@
-# Ревью уведомлений в Telegram (аудит текстов и формата)
+# 🔬 Тексты и формат уведомлений в Telegram

- **Секция:** ядро продукта
+- **Тип:** research
+- **Категория:** Ядро продукта
 - **Зачем:** зонтичный проход по всем текстам бота: полнота карточек, единый язык, оформление; порождает под-задачи
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# Версии/качество одного тайтла (репаки, апгрейд 1080p → 2160p)
+# ✨ Заменять разложенную версию тайтла новой (репаки, апгрейд 1080p → 2160p)

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** По калибровке болей (2026-07-02) — не боль, из приоритета выпало
 - **Теги:** goal:complex-releases

@@ -1,6 +1,7 @@
-# Фетч .torrent по URL — остаток «единого окна»
+# ✨ Принимать ссылку на .torrent и скачивать файл самим (нужен SSRF-гард)

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** magnet и .torrent-файл приняты; остался фетч .torrent по URL (нужен SSRF-гард)
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# Локаль TVDB: перевод названия и оригинальное название
+# ✨ Брать у TVDB название на языке настройки и оригинальное название

- **Секция:** Ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** [general].language правит только TMDB и промпт LLM — TVDB отдаёт primary name, и при language=ru в карточку ревью и имя папки попадает 哪吒之魔童降世 вместо «Нэчжа»
 - **Теги:** goal:recognition-accuracy

@@ -1,6 +1,7 @@
-# Словарь единого языка (ubiquitous language)
+# 🧹 Свести термины домена в словарь единого языка

- **Секция:** инфраструктура
+- **Тип:** chore
+- **Категория:** Инфраструктура
 - **Зачем:** наименования домена расходятся между спеками, UI и кодом — нет единого глоссария (на нём же стоит агент-ревьювер наименований)
 - **Теги:** goal:dev-process-quality

@@ -1,6 +1,7 @@
-# Авторизация веб-UI (на будущее)
+# ✨ Закрыть веб-UI авторизацией, когда доверенной LAN станет мало

- **Секция:** инфраструктура
+- **Тип:** feature
+- **Категория:** Инфраструктура
 - **Зачем:** для v1 решено без авторизации (доверенная LAN, опц. allowlist подсетей) — задел на случай, если понадобится защита
 - **Теги:** goal:ingest-and-review-interfaces

@@ -1,6 +1,7 @@
-# Современный Web-UI как PWA
+# ✨ Переделать веб-UI в устанавливаемое PWA

- **Секция:** ядро продукта
+- **Тип:** feature
+- **Категория:** Ядро продукта
 - **Зачем:** текущий server-rendered UI функционален — PWA (устанавливаемое, удобное с телефона) это улучшение большого объёма, не блокер
 - **Теги:** goal:ingest-and-review-interfaces