Files
jellybit/docs/research/README.md
T
av 66d39297c5 docs: проект переведён на канон документов версии 4
- каталог задач: PLAN.md → ROADMAP.md с каноническими секциями, все 44
  записи получили тип, заголовки приведены к форме своего типа
- расхождения, найденные судьями канона: исключения инварианта «источник
  неприкосновенен», инвариант про один активный infohash, UTC в logging.md,
  поведение из architecture.md заменено ссылками на спеки
- триггеры профиля ревью переписаны под умолчание standard
2026-08-06 13:32:06 +03:00

2.1 KiB

Разведка

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

Каждый вывод — с числами и командой или условиями, которыми получен, чтобы его можно было перепроверить. Число без провенанса проход обязан читать как условие, а не как замер. Число, чей источник по ссылке не подтвердился, не выбрасывается и не переписывается по догадке — остаётся с пометкой «расходится с источником: там <что нашли>».

Как снималось

Наблюдения снимались вручную, по ходу разработки, на домашнем контуре: реальные сообщения торрент-бота в Telegram, реальные ответы qBittorrent WebUI API и LLM-эндпоинта на живых раздачах. Автоматического сбора и корпуса кейсов нет — это отдельная задача (eval-харнес распознавания), до неё числа здесь единичные и приведены как условия, а не как статистика.

Зафиксированные образцы чужих форматов лежат прямо в тестах пакета-разборщика — там они заодно и проверяются; где именно и почему без каталога testdata/, см. CLAUDE.md → «Запреты».

Записи

  • torrent-bot-message.md — формат сообщения торрент-бота, из которого приходит magnet и контекст.