Публичные подкасты в TUI: «Поделиться», поиск с типом podcast и «Подписаться» из карточки (MR-T3) #4

Merged
ab merged 22 commits from sanapach/furumi-tui:podcasts/discovery into federation 2026-11-20 14:11:11 +00:00
Member

Серия «Подкасты»: MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · MR-0 Furumi/furumi-tui#1 · MR-T1 Furumi/furumi-tui#2 · MR-T2 Furumi/furumi-tui#3 · MR-T3 Furumi/furumi-tui#4 (этот) · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже.

Статус: шаги 1 и 2 из 2 сделаны; исправлены замечания ревью и повторного ревью, а также одна проблема приватности, найденная межклиентской проверкой (сценарий 7c, коммит 409188b).

  • Узел федерации запускает оверлей обнаружения podcast_dht.
  • Во вкладке Podcasts есть переключатель «Поделиться», reconciler публикует и отзывает карточки. Отзыв уходит сразу, и выход из приложения его дожидается, даже если запись решения ещё идёт.
  • Федеративный поиск показывает публичные карточки с явным типом podcast. Он идёт отдельно от музыкального и ограничен по времени.
  • Карточка открывается: сезоны и выпуски можно прочитать из RSS без подписки.
  • «Подписаться» создаёт личную подписку по исходному адресу ленты. «Уже подписан» распознаётся через алиасы ленты, а после чтения ленты — и по её новому адресу.

Требования §3 и §9 для TUI закрыты. Критерии §11 про публичность проверены автоматическими loopback-тестами (см. «Как проверено») и межклиентским прогоном реальных процессов TUI ↔ TUI и TUI ↔ веб с посторонним участником вне группы (см. «Межклиентская проверка»). Человек приложение вручную не запускал (см. «Ограничения»).

Что сделано

Шаг 1. Оверлей, «Поделиться», публикация

Оверлей в узле федерации (src/federation/)

  • Узел регистрирует ALPN furumi-fd/podcast-dht/1 (schema-independent).
  • Оверлей music_dht::podcast_dht::PodcastDht открывается рядом с оверлеем похожести. Кэш: federation/podcast-dht.sqlite3 (PODCAST_DHT_CACHE_FILE).
  • Задачи serve и maintenance (bootstrap, republish каждые 10 мин, очистка) живут вместе с остальными задачами узла и останавливаются вместе с ним.
  • Если кэш не открывается (повреждён, более новая схема, каталог вместо файла):
    • в журнал пишется предупреждение;
    • acceptor закрывается;
    • обнаружение выключается;
    • приложение продолжает работать.
  • Capability manifest. podcast_dht = 1 объявляется (with_podcast_dht()) только пока оверлей действительно работает. Каждый проверенный манифест пира передаётся в PodcastDht::note_peer_capabilities; пиров без оверлея оверлей не опрашивает.
  • Работающий оверлей доступен reconciler'у и поиску через watch-канал Federation::podcast_dht(). После остановки или перезапуска федерации там None или новый экземпляр.

Переключатель «Поделиться» (вкладка Podcasts, контекст podcasts)

  • Shift+F (TogglePodcastShare) работает на выбранном или открытом подкасте. Клавиша есть в стандартном keymap, в справке, README и CHANGELOG.
  • По умолчанию подкаст приватный.
  • Включение и выключение идут через PodcastStore::set_shared, то есть через синхронизируемую операцию podcast_share_set в общем журнале устройств.
  • Перед включением собирается карточка, которая будет опубликована, и проверяется PodcastCardSpec::privacy_warnings().
  • Если предупреждения есть, открывается диалог на русском. В нём:
    • причины («в адресе ленты есть параметр «token», похожий на ключ доступа» и т. п.);
    • адрес ленты и исходный адрес;
    • предупреждение, что любой, кто найдёт карточку, сможет читать ленту;
    • enter/y публикует, esc/n отменяет, и тогда ничего не записывается.
  • Подтверждение privacy_confirmed:
    • хранится только на этом устройстве, в podcast-share-confirmations.json рядом с podcasts.sqlite3 (права 0600, атомарная запись, формат версии 2);
    • привязано ровно к показанным URL и к решению о публикации, для которого дано (операция регистра share);
    • удаляется при выключении «Поделиться» и при отписке на этом устройстве. Оно снимается и тогда, когда «Поделиться» выключили (или выключили и снова включили) на любом другом доверенном устройстве, и устройство спрашивает ещё раз;
    • пока подтверждения для текущего решения нет, TUI сам придерживает подкаст и отзывает карточку, опубликованную этим устройством для прежнего решения. FRID при совпадающем feed URL пропустил бы её без подтверждения, см. contract gap;
    • если решение записать не удалось (подписку тем временем сняла синхронизация, ошибка SQLite или журнала), подтверждение откатывается к прежнему значению. Незавершённое (pending) подтверждение, оставшееся в файле после аварийного выхода, при чтении файла отбрасывается.
  • Если подкаст уже «shared», но публикация на этом устройстве придержана (URL сменился, «Поделиться» включили на другом устройстве или появилось новое решение), Shift+F снова открывает диалог. В нём есть x — перестать делиться. Подтверждение в этом случае не создаёт новой синхронизируемой операции.
  • Что попадает в карточку. Обложка и ссылка на сайт не публикуются, если сами выглядят как URL с ключом доступа: секретный параметр или случайное значение в query, хост «личных» лент, userinfo, не-http(s). Случайно выглядящий сегмент пути для них не считается: публичные CDN называют обложки по UUID и хешам. Для ленты с «личным» адресом обложка и ссылка не публикуются в любом случае: диалог показывает только адреса ленты.
  • Отображение. В списке у общего подкаста стоит shared · …. Боковая панель показывает одно из состояний:
    • «private (not shared…)»;
    • «private · revoking the public card from this device…» — «Поделиться» выключено, но отзыв ещё не отправлен или не удался (повторяется);
    • «private · public card may not be revoked yet: federation is off» — для подкаста, которым делились, пока не прошёл проход работающего оверлея (федерация выключена или ещё не запущена: карточку прошлой сессии исключить нельзя);
    • «shared · publishing…»;
    • «published from this device» (и «no discovery peers yet», если пиров оверлея ещё нет; число пиров обновляется каждые 10 с);
    • «held back on this device… press Shift+F to confirm»;
    • «not published: <причина>».
  • Ошибки публикации и неудавшиеся отзывы («N public card(s) could not be revoked yet; retrying») попадают в строку статуса без id и URL, а также в журнал.

Reconciler публикаций (src/podcasts/publication.rs)

  • share_plan реализует документированный шаблон F2/F3: одно PodcastShareState на каждую подписку.

    • Слитые регистры подписки и публикации берутся из PodcastStore.
    • Карточка строится только для подкастов с effective_share: feed_url берётся из каталога, id_feed_url — исходный адрес, метаданные и счётчики — из локального каталога, затем применяется .bounded().
    • privacy_confirmed берётся из локального подтверждения, если оно покрывает текущее решение. Устаревшие подтверждения здесь же удаляются.
    • Общий подкаст с предупреждениями и без подтверждения не попадает в states (SharePlan::held). sync_shares отзывает его прежнюю карточку, а отчёт показывает HeldBack.
    • Для приватных подписок карточка не строится вообще.
  • publication::set_shared — единый путь записи решения:

    • подтверждение записывается заранее (pending: покрывает следующее решение);
    • затем пишется операция (при ошибке подтверждение откатывается);
    • затем подтверждение привязывается к действующему решению.
  • reconcile вызывает декларативный PodcastDht::sync_shares, затем published(), чтобы получить статус по каждому подкасту.

    • Публикуется только то, чем поделились и что подтверждено, если подтверждение нужно.
    • Всё остальное, что публиковало это устройство, заменяется подписанным tombstone.
    • Выключение «Поделиться» или отписка на любом доверенном устройстве отзывает карточки всех устройств группы, когда регистры сойдутся.
    • Запоздавшее устройство со старым «share» ничего не восстанавливает: его регистр проигрывает более новому решению.
    • Каждое устройство публикует под своим iroh-ключом.
    • Отчёт содержит unrevoked: приватные подкасты, чья карточка с этого устройства ещё жива. Сюда входят и подкасты, отзыв которых не удался.
  • Когда запускается (вне UI-потока):

    • сразу, без debounce, после своих действий «выключить Поделиться» и «отписаться». Reconciler::begin_revocation берётся в UI-потоке до записи, а RevocationTicket::done → revoke_now вызывается из blocking-задачи сразу после успешной записи;
    • после включения «Поделиться», после чужих подкастовых операций и snapshot, после успешного обновления ленты — с debounce 1 с;
    • при каждом (пере)запуске оверлея;
    • раз в 5 минут.

    Несколько отложенных триггеров в пределах 1 с схлопываются в один проход.

  • Федерация выключена. Отчёты Off сохраняют в unrevoked то, что было неотозвано до остановки, и подкасты, которыми делились и которые отозвали за это время (кроме снова расшаренных). Так продолжается до прохода работающего оверлея.

  • Выход из приложения. До остановки узла федерации podcast_runtime::shutdown ждёт до 4 с (Reconciler::flush):

    • пока допишутся начатые выключения и отписки;
    • пока проход, начатый после последнего revoke_now, подпишет и разошлёт tombstone.

    Если после этого карточка приватного подкаста может быть жива (отзыв не удался или федерация выключена), в журнал пишется предупреждение. Сохранение прогресса идёт параллельно.

  • Fail-safe. Если хранилище подкастов не открылось или регистры не читаются, устройство отзывает все свои карточки (sync_shares(vec![])).

  • Журнал. Только счётчики: ни URL лент, ни названий, ни id неопубликованных подкастов.

Шаг 2. Поиск, карточка, «Подписаться»

Поиск (src/federation/mod.rs, src/podcasts/discovery.rs, src/app/cmdline.rs, src/ui/global.rs)

  • Обычный поиск (/ вне вкладки Podcasts) при работающей федерации запускает две независимые задачи:
    • музыкальный Federation::search (тело совпадает с базовой веткой) → FedSearchLoaded;
    • Federation::search_podcasts → discovery::search → PodcastDht::search → отдельное событие FedPodcastsLoaded { seq }.
  • Подкастовый поиск ограничен 15 с (PODCAST_SEARCH_TIMEOUT), включая bootstrap оверлея, который не покрыт дедлайном поиска FRID. При ошибке или таймауте список подкастов пуст, в журнал пишется предупреждение без запроса и без URL. Музыкальная выдача оверлей не ждёт.
  • Подкастовые позиции идут в порядке merge_search_results: сначала точные совпадения названия.
  • Секция «Podcasts · public cards». Подкасты выводятся после музыкальных результатов федерации в отдельной секции. Каждая строка помечена явным типом [podcast] (SearchHitKind::Podcast) и показывает автора и «open the card». Пока ищет хотя бы одна из двух задач, заголовок секции — «Federation · searching…».
  • Правая колонка показывает одно из двух:
    • число выпусков и число публикующих устройств (это не подписчики и не знак доверия);
    • ✓ subscribed.
  • Отметка «подписан»:
    • задача поиска сопоставляет исходный URL каждой карточки с локальным хранилищем через PodcastStore::resolve_podcast_id, то есть с учётом алиасов ленты;
    • отметка ставится, если среди подписок есть этот id или id самой карточки;
    • подписка и отписка обновляют отметку сразу.
  • Курсор проходит строки в порядке: локальные результаты → федеративные артисты → треки → подкасты. Enter на подкасте открывает карточку и ничего не ставит в очередь.

Карточка подкаста (src/app/update/podcast_discovery.rs, src/ui/podcast_card.rs, на русском)

  • Что показывается:

    • название и тип [podcast];
    • пометка «Сведения ниже указали издатели карточки; они не проверены»;
    • автор, категории, язык;
    • число выпусков и дата последнего;
    • «Опубликовали: N устройств (не число подписчиков и не знак доверия)»;
    • адрес ленты (исходный — единственный, привязанный к id);
    • заявленные новые адреса с пометкой «не проверен, не используется»;
    • сайт и описание.
  • e — сезоны и выпуски из RSS без подписки (discovery::preview_for):

    • запрос идёт только к серверу самой ленты и никогда — к издателю карточки;
    • в хранилище ничего не пишется (только чтение, чтобы найти новый адрес ленты среди подписок);
    • показываются число выпусков, сезоны с количеством выпусков и до 200 выпусков (новые сверху, сезон/номер, дата, длительность). Если название в ленте отличается от заявленного, показывается «Название в ленте». Постоянный редирект или itunes:new-feed-url показывается как «Лента переехала».
  • «Подписаться» (Enter/s) → discovery::subscribe_from_hit:

    • подписка идёт по hit.feed_url — исходному URL, из которого получен podcast_id, — через refresh::subscribe_url;
    • claimed URL никогда не запрашивается и не становится алиасом, если к нему не ведёт сама лента;
    • карточка с id, не совпадающим с хешем её URL, отклоняется до любого запроса;
    • лента читается с её сервера, редиректы и itunes:new-feed-url обрабатываются как обычно;
    • если лента по старому адресу объявляет новый, на который устройство уже подписано, возвращается существующая подписка: ничего не записывается, второй подписки нет. То же правило действует для ручной подписки по URL;
    • сохраняется только то, что есть в ленте, — из карточки ничего;
    • подписка приватная, без решения «Поделиться»; прогресс независим;
    • пока идёт подписка, второй запуск не принимается.
  • «✓ Уже подписан» показывается, если устройство подписано по id карточки, по алиасу или (после e) по новому адресу, куда переехала лента. Enter тогда открывает подкаст во вкладке Podcasts.

  • Клавиши:

    • ↑↓/j k/PgUp PgDn/g — прокрутка;
    • esc/q — закрыть.

    Высота текста с переносом по словам считается так же, как при отрисовке (Paragraph::line_count). Прокрутка останавливается на последней строке и не уходит за неё. Диалог «Поделиться» считает высоту так же.

Исправления после межклиентской проверки

  1. Перезапуск со старым решением «Поделиться» снова публиковал карточку (приватность, сценарий 7c, коммит 409188b). Устройство B было выключено, пока на A выключили «Поделиться». После перезапуска B его первый проход сверки вызывал sync_shares по регистрам, сохранённым до остановки, раньше первой синхронизации устройств. С frid 9c82f6d первый вызов заново рассылает неизменённые карточки, поэтому отозванная карточка снова объявлялась, пока не придёт выключение.
    • Исправление. Пока DeviceSync::podcast_registers_current не станет true, проход сверки только отзывает карточки (publication::revoke_unshared → PodcastDht::unpublish по одному) и sync_shares не вызывает. FRID продолжает придерживать карточки прошлой сессии. Watch становится true в двух случаях:
      • применён обмен синхронизации с устройством группы v4 после подключения хранилища подкастов: исходящий sync_device, входящий handle_hello, оба пути сопряжения;
      • ждать некого: устройств нет, есть только v3 или у устройств нет адреса. Устройство, удалённое из группы, тоже перестаёт ждаться; проверка идёт при подключении хранилища и на каждом такте sync_loop.
    • Что видит пользователь. Общие подкасты в отчёте — Publication::WaitingForDevices, в боковой панели — «shared · not published yet: waiting for a sync with your other devices». Локальное выключение «Поделиться» и отписка по-прежнему отзываются сразу, выход ждёт отзыва как раньше. Как только watch становится true, запускается полный проход. reconcile разделён на read_plan, shared_ids и finish_pass без изменения поведения.
    • Тесты:
      • publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group — два loopback-узла. До открытия шлюза посторонний ничего не находит, а republish отправляет 0 записей. Локальное выключение в это время сразу даёт tombstone. После открытия публикуется только подкаст, которым всё ещё делятся. На старом поведении (шлюз принудительно открыт) тест падает ровно как 7c: «a card was sent before device sync»;
      • devices::podcast_sync_tests::podcast_registers_are_current_after_a_sync_with_the_group — без сети: устройство одно, только v3, ожидание доступного v4, синхронизация до подключения хранилища не считается, hello после подключения считается, удалённое устройство больше не ждётся;
      • проверка строки ожидания в ui::tests.
    • Документация: README (раздел о публикации), ARCHITECTURE (Public discovery), AGENTS.md (граница подкастов), CHANGELOG 0.5.0.
    • Повторный межклиентский прогон (фазы 6–7, затем полный): 7c проходит. Отчёты B после перезапуска — Running {pod1:…: WaitingForDevices}, затем {} после синхронизации, ни одного Published. В логе B сначала «podcast share decisions are current: synced with a trusted device», затем «reconciled … unpublished=1».

Решения и отступления

  • Подтверждение приватности локально и не синхронизируется (шаг 1).
    • Так требует контракт: privacy_confirmed — состояние клиента, а каждое устройство публикует под своим ключом.
    • Подтверждение лежит в отдельном JSON, потому что хранилище FRID не открывает файл с неожиданными таблицами.
    • Оно привязано к решению о публикации (op_id регистра share). Pending-подтверждение живёт только внутри одного вызова set_shared — между записью подтверждения и привязкой к решению. При ошибке записи оно откатывается, а при чтении файла отбрасывается.
    • Файл формата 1 (не выпускался) читается как пустой, и пользователя спрашивают снова.
    • Подкаст с «личным» URL, которым поделились на A, придержан на B, пока пользователь B не подтвердит.
  • TUI придерживает строже, чем FRID. В FRID придержанная карточка «остаётся как была», а при совпадающем feed URL пропускается без подтверждения (already_published). TUI не передаёт sync_shares неподтверждённый подкаст с предупреждениями, поэтому прежняя карточка с этого устройства отзывается и при смене URL. Если файл подтверждений потерян или повреждён, карточка отзывается и пользователя спрашивают снова — это безопасная сторона.
  • Отзыв без debounce и ожидание при выходе. Выход ждёт только отзывы, запрошенные на этом устройстве (выключение «Поделиться» и отписка), в том числе ещё записывающиеся. Если федерация выключена, ждать нечего: tombstone уйдёт при следующем запуске оверлея. Панель консервативно показывает «may not be revoked yet» для подкастов, которыми делились, а при выходе пишется предупреждение.
  • Подкастовый поиск отдельно от музыкального. merge_search_results — устойчивое разбиение по точному названию, и порядок подкастовых позиций от музыки не зависит. Поэтому подкасты ищутся отдельно, а podcast_hits применяет то же правило только к подкастам. Музыкальный поиск не изменился.
  • Предпросмотр по явному e. Открытие чужой карточки не делает запросов к сторонним хостам. Поэтому подписку под новым адресом ленты карточка узнаёт только после e.
  • «Уже подписан» — не мёртвая кнопка: Enter открывает подписку.
  • Язык. Диалог «Поделиться» и карточка подкаста на русском («Подписаться», «Уже подписан»). Список поиска и статусы на английском, как и весь остальной TUI.
  • Shift+F на придержанном подкасте открывает подтверждение, а не выключает «Поделиться».
  • Устройство, вышедшее из группы (или удалённое из неё), больше не получает решений группы и публикует общие подкасты, пока «Поделиться» не выключат на нём самом. Это записано в README. Автоматически выключать публикации при выходе из группы не стали: это изменило бы смысл leave-group в devices.rs для всех личных данных.
  • ratatui: включена фича unstable-rendered-line-info (Paragraph::line_count). Новых зависимостей нет; API нестабильный, поэтому версия зафиксирована на 0.30.x.
  • CHANGELOG. Запись о «Поделиться» из шага 1 перенесена из [0.4.0] (T2) в новый раздел [0.5.0]. Исправления по ревью вошли в записи [0.5.0].
  • Contract gap, F3 (already_published обходит подтверждение).
    • sync_shares публикует карточку с предупреждениями без privacy_confirmed, если это устройство уже публикует те же feed URL. Устройство, пропустившее промежуточное выключение «Поделиться» (было закрыто, офлайн или попало в debounce), продолжило бы публиковать URL, который для нового решения никто не подтверждал. TUI обходит это сам (см. выше).
    • Предложение: не делать обход, если клиент явно передал privacy_confirmed = false, или привязать его к op_id решения share, под которым карточка была опубликована. Описать в held_back, что прежняя публикация отзывается.
  • Contract gap, F3 (порядок maintenance) — исправлено.
    • Было: maintenance после первого bootstrap переиздавал локально активные карточки ещё до первого sync_shares.
    • В frid 9c82f6d (MR-F3) свои карточки прошлой сессии придерживаются до первого sync_shares в процессе. TUI откладывает первый sync_shares до синхронизации с группой (409188b, см. «Исправления после межклиентской проверки»).
    • Остаётся: sync_shares доверяет переданным регистрам, поэтому шлюз в клиенте обязателен. Предложение записать это нормой контракта — в MR-F3.
  • Contract gap, F3 (bootstrap при поиске).
    • PodcastDht::search делает bootstrap() при known_peers() == 0 вне дедлайна поиска 15 с. Пока оверлей есть только у части сети, это случается при каждом поиске. Замер на loopback с одним недоступным контактом — 5,0 с.
    • Клиент ограничивает поиск сам.
    • Предложение: включить bootstrap в дедлайн поиска или не делать его, если maintenance недавно делал bootstrap.
  • Contract gap, F3 (обложка и ссылка в карточке).
    • PodcastCardSpec::privacy_warnings() проверяет только адреса ленты. Набор правил для ленты не подходит для обложек: HighEntropyPathSegment срабатывает на UUID и хеши публичных CDN.
    • Предложение: проверять image_url и link по правилам query и хоста без правила пути (или очищать их в bounded()), чтобы TUI и веб вели себя одинаково. Сейчас TUI фильтрует их сам и полагается на то, что правило пути проверяется последним.
  • Contract gap, federation-net/F3 (герметичные тесты).
    • Узлы всегда строятся с presets::N0 (публичные relay и DNS-lookup).
    • В MR-F3 эту опцию не добавили: новое поле в NetworkConfig ломает API federation-net 0.3.1, а ticket() без relay не дожидается online(). Предложение перенесено в follow-up federation-net 0.4 (режим LocalOnly, проброс через MusicDhtConfigBuilder), см. «Предложения на потом» в MR-F3.
  • Contract gap, F2/F3 (сборка карточки дублируется в клиентах).
    • Каталог не хранит language и categories, поэтому в карточках, которые публикует TUI, этих полей нет. Поле «Категории» в карточке TUI показывает, если их прислал другой издатель.
    • Предложение:
      • PodcastStore::share_state(id);
      • общий catalog_card;
      • язык и категории в каталоге.
  • Contract gap, F3 (статус).
    • Предложение: PodcastDhtSyncStats::active: Vec<PodcastId> и отдельный счётчик неудавшихся отзывов.
  • Contract gap, F3 (API слияния).
    • merge_search_results принимает только Vec<LibraryItem>.
    • Предложение: обобщённое merge_ranked или публичный предикат точного совпадения, чтобы клиенты с агрегированной музыкой применяли тот же порядок.
  • Contract gap, F2 («уже подписан» и новый адрес ленты).
    • Клиент сам сочетает resolve_podcast_id(hit.feed_url), id карточки и список подписок. Подписавшись по новому адресу, устройство не знает старый.
    • Предложение:
      • PodcastStore::subscribed_podcast_for(&PodcastSearchHit) -> Option<PodcastId>;
      • запись itunes:new-feed-url как алиаса того же id при обновлении (или отдельный grow-only набор «известных прежних адресов»), чтобы отметка в списке поиска работала в обе стороны без чтения ленты.

Совместимость и версии

  • furumi-tui 0.5.0 — минорное повышение относительно T2 (0.4.0).
  • Зависимости не менялись: music-dht 0.6.0 и furumi-library 0.3.0.
    • Cargo.lock и [patch]: последний коммит этого MR, «Point frid deps at the fork branch», подключает неопубликованный frid из форка: в [patch.crates-io] в Cargo.toml music-dht и furumi-library указывают на git = "https://gt.hexor.cy/Sanapach/frid.git", branch = "podcasts/discovery", а в Cargo.lock у frid-крейтов (включая federation-net) стоит source = "git+https://gt.hexor.cy/Sanapach/frid.git?branch=…#<sha>". Ветка стоит на podcasts/tui вместе с таким же коммитом MR-T2 и только меняет branch = "podcasts/store" на branch = "podcasts/discovery". Сам MR в Cargo.lock меняет ещё версию furumi_tui. После публикации крейтов на crates.io эти строки удаляются, и lock перегенерируется ещё раз.
  • Новое на проводе — только оверлей FRID furumi-fd/podcast-dht/1 (версия 1, схема кэша 2) и запись podcast_dht в capability manifest.
    • Музыкальный DHT (music-dht-v5), federation-net и device-sync v4 не менялись.
    • Поиск подкастов использует операции оверлея FindValue. Подписка из карточки — обычная v4-операция podcast_subscription_set.
  • Старые узлы не объявляют podcast_dht, поэтому оверлей их не опрашивает. Решение «Поделиться» — существующая операция v4 podcast_share_set из MR-T2.
  • Локальный файл подтверждений имеет формат 2. Формат 1 существовал только в неслитой версии этой ветки и читается как пустой. Pending-записи при чтении отбрасываются, формат от этого не меняется.

Как проверено (macOS, Darwin 25.5, aarch64)

Окружение:

  • PATH=/opt/homebrew/opt/rustup/bin:$PATH;
  • CARGO_TARGET_DIR=/Users/krypton/furumi/gitea/.targets/tui-t3;
  • crates frid подключены к ветке F3 через [patch].

Результаты на итоговом HEAD 409188b (frid podcasts/discovery @ 9c82f6d):

  • cargo fmt --all -- --check — OK.
  • cargo check --all-targets — OK, 0 предупреждений.
  • cargo clippy --all-targets — 22 предупреждения. Отсортированный список (файл + текст) совпадает с базовой веткой podcasts/tui; на 409188b набор тот же, что на прежней вершине 6cbe3ce; новых нет.
  • cargo test --all-targets — 335 passed, 0 failed, 4 ignored (ignored были и раньше; до 409188b было 332).
  • Новый регрессионный тест a_restarted_device_publishes_only_after_syncing_with_its_group падает на старом поведении (шлюз временно принудительно открыт) и проходит с исправлением.
  • Четыре loopback-теста (shared_podcast_is_found…, the_reconciler_follows…, a_stranger_finds…, podcast_search_is_bounded…) дополнительно прогнаны ещё 3 раза: 3/3 OK, примерно по 14 с.
  • Каждый промежуточный коммит собирается (cargo check --all-targets, 0 предупреждений), проходит cargo fmt --check и свои тесты. Коммиты повторного ревью проверены сборкой экспортированного индекса.
  • Регрессионные тесты для подтверждения, moved feed, прокрутки, придержки при already_published, отката pending-подтверждения и правила для обложек проверены на падение со старым поведением: временный откат, затем возврат.
  • cargo test выводит сообщение линкера macOS «__eh_frame section too large». Это не предупреждение rustc/clippy, и к изменениям оно не относится.
  • Postgres- и node-тестов в TUI нет.

Тесты шага 1:

  • podcasts::publication_tests::shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off — два loopback-узла: A (TUI со своим хранилищем) и посторонний C без device sync. Проверено:
    • пока ничем не поделились, ничего не публикуется;
    • C находит общий подкаст поиском и по id, но не находит ни приватную подписку, ни придержанный ?token=;
    • после подтверждения URL придержанный подкаст публикуется;
    • устройство B выключает и снова включает «Поделиться» (операции применены к хранилищу A, A между ними не синхронизируется) → проход A даёт HeldBack, своя публикация неактивна (tombstone), C карточку не находит. Повторный проход ничего не меняет, после нового подтверждения карточка снова опубликована;
    • выключение «Поделиться» → tombstone, C больше не находит подкаст;
    • повторная доставка старого «share» не публикует заново;
    • отписка отзывает;
    • без хранилища отзывается всё.
  • share_states_carry_cards_only_for_shared_podcasts, a_stale_share_decision_from_another_device_does_not_republish, privacy_confirmations_are_local_and_bound_to_the_urls.
  • Пять тестов переходов в update для «Поделиться» и диалога.
  • Два теста отрисовки (состояния публикации, диалог на русском).
  • federation::tests::podcast_discovery_opens_or_turns_itself_off, capabilities::podcast_discovery_is_advertised_only_when_it_runs.

Тесты шага 2:

  • podcasts::discovery_tests::a_stranger_finds_a_shared_card_subscribes_and_refreshes_from_the_feed — сквозной тест на двух loopback-узлах с локальным HTTP-сервером ленты. Поиск идёт через discovery::search, как в приложении.
    • A подписан на две ленты и делится одной. Локальный адрес считается «личным» и подтверждается через publication::set_shared.
    • B — пользователь вне группы A. Он находит карточку поиском оверлея; порядок и сопоставление такие же, как в UI.
    • Проверено: тип podcast, исходный feed_url, издатель A; приватная подписка A не находится.
    • «Подписаться» даёт тот же podcast_id. Лента запрашивается у сервера ленты. У B нет решения «Поделиться» (только podcast_subscription_set), и B ничего не публикует.
    • B сам обновляет ленту, и новый выпуск приходит.
    • A выключает «Поделиться» → B больше не находит карточку, но подписка B остаётся и обновляется.
  • subscribing_from_a_card_matches_subscribing_by_url, subscribing_from_a_card_never_fetches_a_claimed_url, hits_resolve_to_the_podcast_a_feed_alias_belongs_to, preview_reads_seasons_and_episodes_without_storing_anything, podcast_hits_put_exact_titles_first_and_keep_only_podcasts.
  • app::update::tests::podcast_discovery::* (4), ui::tests::search_marks_podcast_hits_apart_from_music, ui::tests::podcast_card_offers_subscribe_or_shows_already_subscribed, ui::podcast_card::tests::russian_plurals.

Тесты по первому ревью:

  • publication_tests::the_reconciler_follows_the_overlay_and_revokes_without_the_debounce — publication::spawn на loopback-оверлее:
    • пока watch = None, отчёт Off, а flush сразу возвращается;
    • после Some проход публикует;
    • число пиров обновляется без прохода;
    • три wake дают один проход;
    • revoke_now + flush укладываются в 0,9 × debounce, tombstone отправлен, посторонний узел карточку не находит;
    • Some → None даёт Off;
    • задача завершается, когда закрывается watch.
  • publication_tests::revocations_that_fail_are_reported_without_ids, publication_tests::a_confirmation_does_not_outlive_a_revocation_on_another_device, publication_tests::cards_leave_out_artwork_and_links_that_look_private.
  • discovery_tests::podcast_search_is_bounded_and_empty_without_the_overlay, discovery_tests::a_card_for_an_older_address_finds_the_subscription_under_the_newer_one.
  • ui::tests::the_podcast_card_scrolls_exactly_to_its_last_line.
  • Расширены ui::tests::podcast_share_state_is_shown_in_the_list_and_details, update_tests::…::already_subscribed_cards_open_the_podcast_instead, privacy_confirmations_are_local_and_bound_to_the_urls.

Тесты по повторному ревью (1 новый, 5 расширено):

  • publication_tests::a_confirmation_for_a_decision_that_was_not_written_is_dropped (новый):
    • подтверждение + неудачная запись решения → на A ничего не подтверждено;
    • через какое-то время B включает «Поделиться» → A придерживает подкаст, needs_confirmation, в файле ничего;
    • pending, оставленный в файле, при повторном открытии отбрасывается.
  • shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off — сценарий B off+on на уровне оверлея (см. выше).
  • cards_leave_out_artwork_and_links_that_look_private:
    • UUID и хеши в пути (imgix, simplecast, mzstatic, cloudfront) — правила для ленты их отмечают, но обложка и ссылка остаются;
    • sig= в query, хост patreon и ftp: выкидываются.
  • the_reconciler_follows_the_overlay_and_revokes_without_the_debounce:
    • при выключенной федерации открытый RevocationTicket держит flush;
    • done(Some(id)) завершает flush с false (карточка может быть жива);
    • отчёты Off сохраняют id в unrevoked;
    • снова расшаренный подкаст оттуда уходит;
    • сброшенный ticket не ждётся.
  • update_tests::…::stopping_sharing_needs_no_dialog_and_a_held_publication_asks_again — при Off и Starting выключение и отписка помечают подкаст, которым делились, как неотозванный; не расшаренный подкаст не помечается.
  • revocations_that_fail_are_reported_without_ids — note_revocation при Running, Off и Starting.
  • Обновлён ui::tests::podcast_share_state_is_shown_in_the_list_and_details («may not be revoked yet»).

Тесты после межклиентской проверки (2 новых, 1 расширен; см. «Исправления после межклиентской проверки»):

  • publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group (два loopback-узла);
  • devices::podcast_sync_tests::podcast_registers_are_current_after_a_sync_with_the_group (без сети);
  • строка «waiting for a sync with your other devices» в ui::tests.

Тесты не трогают реальные каталоги пользователя: используются временные каталоги, in-memory/temp-хранилища, локальный HTTP-сервер и loopback-узлы. Трафик оверлея между тестовыми узлами идёт по loopback, но узлы строятся с транспортом по умолчанию (presets::N0) и могут обращаться к публичным relay и DNS n0, как существующие тесты Jam, devices и frid. Это касается тестов:

  • publication_tests::shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off;
  • publication_tests::the_reconciler_follows_the_overlay_and_revokes_without_the_debounce;
  • discovery_tests::a_stranger_finds_a_shared_card_subscribes_and_refreshes_from_the_feed;
  • discovery_tests::podcast_search_is_bounded_and_empty_without_the_overlay;
  • publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group.

Без изменения federation-net это отключить нельзя (см. contract gap, follow-up federation-net 0.4).

Проверенные и непроверенные сценарии

Проверено автоматически:

  • приватная подписка не находится посторонним;
  • «Поделиться» → посторонний находит карточку, просматривает сезоны и выпуски (предпросмотр), подписывается тем же id и обновляет ленту сам;
  • отзыв убирает карточку, но не подписку постороннего;
  • отзыв уходит без debounce, ожидание перед выходом работает, в том числе пока решение ещё записывается;
  • позднее «share» не восстанавливает публикацию;
  • подтверждение не переживает решения, принятые на другом устройстве, в том числе когда это устройство пропустило промежуточное выключение (карточка отзывается);
  • неудачная запись решения не оставляет подтверждения;
  • отписка отзывает;
  • при выключенной федерации отозванный подкаст, которым делились, остаётся «may not be revoked yet»;
  • «уже подписан» распознаётся по id, через алиас и через новый адрес ленты; повторной подписки нет;
  • claimed URL не используется;
  • поиск подкастов ограничен по времени и не задерживает музыку.

Проверено межклиентским прогоном (реальные процессы, см. «Межклиентская проверка»): две установки TUI одного пользователя плюс посторонний TUI; TUI ↔ веб в обе стороны; Federation::start и Federation::search_podcasts целиком; перезапуск со старым решением «Поделиться» (7c).

Не проверено:

  • ручной прогон человеком с реальными каталогами пользователя, в том числе выход сразу после Shift+F (порядок «ticket до записи» проверен только на уровне Reconciler, без perform);
  • полностью изолированная сеть: узлы iroh в тестах и межклиентском прогоне используют relay и DNS n0 и Mainline-DHT (локального режима транспорта нет);
  • Linux и Windows.

Межклиентская проверка

Окружение — то же, что в MR-T2. Вершина стека: TUI 0.5.0 (409188b), веб 0.15.0 (0e985b4), frid 9c82f6d через локальный [patch]. Отдельные HOME и каталоги данных, ленты только с 127.0.0.1, узлы iroh с preset n0 и Mainline-DHT (случайный id сети на прогон). TUI ↔ TUI: 23 проверки из 23 прошли (включая 7c, которая до 409188b падала). TUI ↔ веб: 37 pass, 3 info, 2 not run, 0 fail. Сценарии синхронизации, переноса, старых пиров и Jam — в таблице MR-T2. Здесь — публикация и поиск.

Сценарий Клиенты Результат
6a. Посторонний E находит карточку поиском, [podcast], 2 издателя (A и B); для обычного URL диалог подтверждения не нужен TUI A, B (группа) + TUI E вне группы, связан только тикетами pass
6b. E подписывается из карточки: тот же podcast_id (хеш URL ленты), 3 выпуска, shared=false, в списке «✓ subscribed», в карточке «Уже подписан» TUI E pass
6c. Приватный подкаст не находится ни по одному слову названия TUI E pass
6d. A выключает «Поделиться» (синхронизировано на B): карточка пропадает из поиска E через 0,5 с, подписка E остаётся TUI A, B, E pass
7a. Перезапуск: id устройств, группа, подписки, «Поделиться», выпуски и позиции совпадают TUI A, B pass
7b. Публикация, отозванная на A, не возвращается после перезапуска A (8 поисков E за ~60 с ничего не нашли) TUI A, B, E pass
7c. B был выключен, пока A выключил «Поделиться»: после перезапуска B карточку не публикует (отчёты WaitingForDevices → {}, итоговый список издателей пуст) TUI A, B, E до 409188b — FAIL, на 409188b — pass
S6. Веб-аккаунт делится → TUI находит карточку и подписывается тем же id, подписка синхронизируется в веб-аккаунт группы; одиночный TUI делится → веб находит; выключение с любой стороны убирает карточку, подписки остаются; Shift+F в TUI синхронизируется в веб, и веб публикует тоже (2 издателя); приватные подкасты не находятся нигде TUI 0.5.0 (в группе и вне её) + веб 0.15.0 (два аккаунта) pass
Шлюз первого прохода в реальных логах: TUI без группы пишет «podcast share decisions are current: no trusted device syncs podcasts» и публикует сразу TUI 0.5.0 pass

Наблюдения:

  • задержка удалённой публикации до ~10 мин, если поделиться, пока оверлей не знает пиров («remote_nodes=0», первая находка веба — через 311 с, харнесс опрашивал поиск только в начале сценария). Это поведение frid (bootstrap раз в 10 мин), предложение — в MR-F3;
  • карточка подкаста в TUI на русском, а остальной интерфейс на английском — так задумано (см. «Решения и отступления»).

Вживую не прогонялось: Jam с хостом-TUI и гостем-вебом (веб не поддерживает федеративный Jam).

Ограничения

  • Платформы. Проверен только macOS.
  • Поиск подкастов занимает до 15 с (вместе с bootstrap оверлея), после этого выдача пуста. Музыкальная выдача его не ждёт. Если подкасты пришли раньше музыки, позиция курсора в списке может сдвинуться, как и при поздних федеративных результатах.
  • Объёмы:
    • до 20 подкастов на запрос, без пагинации;
    • предпросмотр — до 200 выпусков, без постраничного просмотра по сезонам;
    • обложка карточки не показывается.
  • Отметка в списке поиска. Она учитывает id карточки и алиасы, которые знает это устройство (подписка по старому адресу, переехавшему на адрес карточки). Если устройство подписано по более новому адресу, чем адрес карточки, список отметку не показывает. Её показывает карточка после e, а «Подписаться» второй подписки не создаёт. Алиас, пришедший позже через синхронизацию, учтётся при следующем поиске.
  • Отзыв при выходе. Выход ждёт до 4 с только отзывы, запрошенные на этом устройстве. Решения других устройств, полученные перед самым выходом, применяются с debounce 1 с и не ожидаются; при следующем запуске их применит первый проход.
  • Федерация выключена. Панель не знает, была ли карточка опубликована в прошлой сессии, поэтому «may not be revoked yet» показывается для каждого подкаста, которым делились (это может быть и придержанный, никогда не опубликованный подкаст). Подкасты, отозванные на других устройствах, пока федерация выключена, так не помечаются.
  • Придержанный подкаст. Если карточка была опубликована с этого устройства, а подтверждение снято решением на другом устройстве, карточка отзывается до нового подтверждения. Временная недоступность карточки — плата за то, чтобы не публиковать неподтверждённый URL.
  • Устройство вне группы продолжает публиковать, пока «Поделиться» не выключат на нём самом (см. README).
  • Произвольный хост. Предпросмотр и подписка запрашивают исходный URL карточки, на каком бы хосте он ни был, включая адреса локальной сети. Это то же самое, что ввод URL вручную. Фильтра хостов в TUI нет.
  • Запросы к пирам. Слова поискового запроса уходят пирам оверлея, как и при музыкальном поиске. Это описано в README.
  • Eventual consistency отзыва (FRID). Реплики, пропустившие tombstone, отдают старую карточку до её истечения, не дольше 12 ч.
  • Связываемость. Ключ издателя — iroh-ключ устройства, по нему общие подкасты связываются с публичной музыкальной библиотекой и сетевым адресом устройства. Это описано в README.
  • Обложки. Ключ доступа только в пути URL обложки (без query) не распознаётся. Для лент с «личным» адресом обложка не публикуется в любом случае.
  • Окно переиздания при старте исправлено (frid 9c82f6d + 409188b).
  • Публикация после перезапуска ждёт группу. Устройство, у которого есть устройства группы v4 с адресом, но они недоступны, не публикует общие подкасты, пока не синхронизируется с одним из них или пока их не удалят из группы. Это осознанный выбор в пользу приватности. Отзыв (выключение «Поделиться», отписка) в это время работает сразу.
  • Файл подтверждений читается при открытии хранилища. Его внешние правки во время работы не отслеживаются.
  • Диалог «Поделиться» не прокручивается. В очень низком терминале последняя поясняющая строка может не поместиться; причины и адреса стоят выше.
  • Cargo.lock перед merge перегенерируется против запушенной ветки форка frid, а позже — против опубликованных music-dht 0.6 / furumi-library 0.3 (см. «Совместимость и версии»).

Зависимости и стек

  • FRID: F1 → F2 → F3 (podcast_dht), ветка podcasts/discovery.
  • TUI: T1 → T2 (podcasts/tui) → T3 (этот MR, ветка podcasts/discovery).
  • Веб: аналог — W2 → W3.
  • Сливать после F3 и T2.
  • Ветка Sanapach/furumi-tui:podcasts/discovery → Furumi/furumi-tui:podcasts/tui, если эта ветка-основание есть в Furumi/furumi-tui. Иначе MR открывается в federation: он зависит от MR-T1 и MR-T2, и его diff включает их коммиты.
  • 22 коммита поверх podcasts/tui @ ea7cdc4 (git log --oneline podcasts/tui..podcasts/discovery, вершина 59d6a1f). После межклиентской проверки ветка перебазирована на новую вершину MR-T2; по содержанию коммиты не изменились, сменились только хеши. Последний коммит — «Point frid deps at the fork branch» (59d6a1f).

Шаг 1:

  • c453b0a Run the podcast discovery overlay in the federation node
  • 8c90035 Reconcile own podcast publications with the share registers
  • 8f4e58d Add a share toggle to the Podcasts tab
  • 6d22553 Document sharing podcasts in the federation

Шаг 2:

  • 25a9f2b Subscribe to a parsed feed URL
  • e038f28 Find public podcasts in search and subscribe from their cards
  • 160237b Test subscribing from a public podcast card
  • d38144f Document finding public podcasts and bump to 0.5.0

Исправления по ревью:

  • a51f555 Search public podcasts apart from the music search
  • 1137670 Revoke podcast cards promptly and report unrevoked ones
  • 7add669 Bind share confirmations to the share decision
  • 744d56e Leave private-looking artwork and links out of cards
  • fd68271 Recognize subscriptions under a feed's newer address
  • 17ed8bf Scroll the podcast card exactly to its end
  • 3ddf799 Document prompt revocation and moved-feed subscriptions

Исправления по повторному ревью:

  • 405f8ae Hold back unconfirmed private-looking cards before syncing
  • 43e0696 Drop share confirmations whose decision was not written
  • d6962eb Keep public artwork whose path only looks random
  • adfe809 Wait for in-flight revocations and track them with federation off
  • ce5697c Document held-back revocation and quitting during a revocation

После межклиентской проверки:

  • 409188b Publish podcast cards only after the first device sync
  • 59d6a1f Point frid deps at the fork branch

🤖 Generated with Claude Code

> **Серия «Подкасты»:** MR-F1 Furumi/frid#1 · MR-F2 Furumi/frid#2 · MR-F3 Furumi/frid#3 · MR-0 Furumi/furumi-tui#1 · MR-T1 Furumi/furumi-tui#2 · MR-T2 Furumi/furumi-tui#3 · **MR-T3 Furumi/furumi-tui#4** (этот) · MR-W1 Furumi/furumi-web#10 · MR-W2 Furumi/furumi-web#11 · MR-W3 Furumi/furumi-web#12. Порядок merge и зависимости — в разделе зависимостей ниже. **Статус: шаги 1 и 2 из 2 сделаны; исправлены замечания ревью и повторного ревью, а также одна проблема приватности, найденная межклиентской проверкой (сценарий 7c, коммит `409188b`).** - Узел федерации запускает оверлей обнаружения `podcast_dht`. - Во вкладке Podcasts есть переключатель «Поделиться», reconciler публикует и отзывает карточки. Отзыв уходит сразу, и выход из приложения его дожидается, даже если запись решения ещё идёт. - Федеративный поиск показывает публичные карточки с явным типом `podcast`. Он идёт отдельно от музыкального и ограничен по времени. - Карточка открывается: сезоны и выпуски можно прочитать из RSS без подписки. - «Подписаться» создаёт личную подписку по исходному адресу ленты. «Уже подписан» распознаётся через алиасы ленты, а после чтения ленты — и по её новому адресу. Требования §3 и §9 для TUI закрыты. Критерии §11 про публичность проверены автоматическими loopback-тестами (см. «Как проверено») и межклиентским прогоном реальных процессов TUI ↔ TUI и TUI ↔ веб с посторонним участником вне группы (см. «Межклиентская проверка»). Человек приложение вручную не запускал (см. «Ограничения»). ## Что сделано ### Шаг 1. Оверлей, «Поделиться», публикация #### Оверлей в узле федерации (`src/federation/`) - Узел регистрирует ALPN `furumi-fd/podcast-dht/1` (schema-independent). - Оверлей `music_dht::podcast_dht::PodcastDht` открывается рядом с оверлеем похожести. Кэш: `federation/podcast-dht.sqlite3` (`PODCAST_DHT_CACHE_FILE`). - Задачи `serve` и `maintenance` (bootstrap, republish каждые 10 мин, очистка) живут вместе с остальными задачами узла и останавливаются вместе с ним. - Если кэш не открывается (повреждён, более новая схема, каталог вместо файла): - в журнал пишется предупреждение; - acceptor закрывается; - обнаружение выключается; - приложение продолжает работать. - **Capability manifest.** `podcast_dht = 1` объявляется (`with_podcast_dht()`) только пока оверлей действительно работает. Каждый проверенный манифест пира передаётся в `PodcastDht::note_peer_capabilities`; пиров без оверлея оверлей не опрашивает. - Работающий оверлей доступен reconciler'у и поиску через `watch`-канал `Federation::podcast_dht()`. После остановки или перезапуска федерации там `None` или новый экземпляр. #### Переключатель «Поделиться» (вкладка Podcasts, контекст `podcasts`) - `Shift+F` (`TogglePodcastShare`) работает на выбранном или открытом подкасте. Клавиша есть в стандартном keymap, в справке, README и CHANGELOG. - По умолчанию подкаст приватный. - Включение и выключение идут через `PodcastStore::set_shared`, то есть через синхронизируемую операцию `podcast_share_set` в общем журнале устройств. - **Перед включением** собирается карточка, которая будет опубликована, и проверяется `PodcastCardSpec::privacy_warnings()`. - **Если предупреждения есть**, открывается диалог на русском. В нём: - причины («в адресе ленты есть параметр «token», похожий на ключ доступа» и т. п.); - адрес ленты и исходный адрес; - предупреждение, что любой, кто найдёт карточку, сможет читать ленту; - `enter/y` публикует, `esc/n` отменяет, и тогда ничего не записывается. - **Подтверждение `privacy_confirmed`:** - хранится только на этом устройстве, в `podcast-share-confirmations.json` рядом с `podcasts.sqlite3` (права 0600, атомарная запись, формат версии 2); - привязано ровно к показанным URL **и к решению о публикации**, для которого дано (операция регистра share); - удаляется при выключении «Поделиться» и при отписке на этом устройстве. Оно снимается и тогда, когда «Поделиться» выключили (или выключили и снова включили) на любом другом доверенном устройстве, и устройство спрашивает ещё раз; - **пока подтверждения для текущего решения нет, TUI сам придерживает подкаст и отзывает карточку, опубликованную этим устройством для прежнего решения.** FRID при совпадающем feed URL пропустил бы её без подтверждения, см. contract gap; - если решение записать не удалось (подписку тем временем сняла синхронизация, ошибка SQLite или журнала), подтверждение откатывается к прежнему значению. Незавершённое (pending) подтверждение, оставшееся в файле после аварийного выхода, при чтении файла отбрасывается. - **Если подкаст уже «shared»**, но публикация на этом устройстве придержана (URL сменился, «Поделиться» включили на другом устройстве или появилось новое решение), `Shift+F` снова открывает диалог. В нём есть `x` — перестать делиться. Подтверждение в этом случае не создаёт новой синхронизируемой операции. - **Что попадает в карточку.** Обложка и ссылка на сайт не публикуются, если сами выглядят как URL с ключом доступа: секретный параметр или случайное значение в query, хост «личных» лент, userinfo, не-http(s). Случайно выглядящий сегмент пути для них не считается: публичные CDN называют обложки по UUID и хешам. Для ленты с «личным» адресом обложка и ссылка не публикуются в любом случае: диалог показывает только адреса ленты. - **Отображение.** В списке у общего подкаста стоит `shared · …`. Боковая панель показывает одно из состояний: - «private (not shared…)»; - «private · revoking the public card from this device…» — «Поделиться» выключено, но отзыв ещё не отправлен или не удался (повторяется); - «private · public card may not be revoked yet: federation is off» — для подкаста, которым делились, пока не прошёл проход работающего оверлея (федерация выключена или ещё не запущена: карточку прошлой сессии исключить нельзя); - «shared · publishing…»; - «published from this device» (и «no discovery peers yet», если пиров оверлея ещё нет; число пиров обновляется каждые 10 с); - «held back on this device… press Shift+F to confirm»; - «not published: <причина>». - Ошибки публикации и неудавшиеся отзывы («N public card(s) could not be revoked yet; retrying») попадают в строку статуса без id и URL, а также в журнал. #### Reconciler публикаций (`src/podcasts/publication.rs`) - **`share_plan`** реализует документированный шаблон F2/F3: одно `PodcastShareState` на каждую подписку. - Слитые регистры подписки и публикации берутся из `PodcastStore`. - Карточка строится **только** для подкастов с `effective_share`: `feed_url` берётся из каталога, `id_feed_url` — исходный адрес, метаданные и счётчики — из локального каталога, затем применяется `.bounded()`. - `privacy_confirmed` берётся из локального подтверждения, если оно покрывает текущее решение. Устаревшие подтверждения здесь же удаляются. - Общий подкаст с предупреждениями и без подтверждения не попадает в states (`SharePlan::held`). `sync_shares` отзывает его прежнюю карточку, а отчёт показывает `HeldBack`. - Для приватных подписок карточка не строится вообще. - **`publication::set_shared`** — единый путь записи решения: - подтверждение записывается заранее (pending: покрывает следующее решение); - затем пишется операция (при ошибке подтверждение откатывается); - затем подтверждение привязывается к действующему решению. - **`reconcile`** вызывает декларативный `PodcastDht::sync_shares`, затем `published()`, чтобы получить статус по каждому подкасту. - Публикуется только то, чем поделились и что подтверждено, если подтверждение нужно. - Всё остальное, что публиковало это устройство, заменяется подписанным tombstone. - Выключение «Поделиться» или отписка на **любом** доверенном устройстве отзывает карточки всех устройств группы, когда регистры сойдутся. - Запоздавшее устройство со старым «share» ничего не восстанавливает: его регистр проигрывает более новому решению. - Каждое устройство публикует под своим iroh-ключом. - Отчёт содержит `unrevoked`: приватные подкасты, чья карточка с этого устройства ещё жива. Сюда входят и подкасты, отзыв которых не удался. - **Когда запускается** (вне UI-потока): - **сразу**, без debounce, после своих действий «выключить Поделиться» и «отписаться». `Reconciler::begin_revocation` берётся в UI-потоке до записи, а `RevocationTicket::done` → `revoke_now` вызывается из blocking-задачи сразу после успешной записи; - после включения «Поделиться», после чужих подкастовых операций и snapshot, после успешного обновления ленты — с debounce 1 с; - при каждом (пере)запуске оверлея; - раз в 5 минут. Несколько отложенных триггеров в пределах 1 с схлопываются в один проход. - **Федерация выключена.** Отчёты `Off` сохраняют в `unrevoked` то, что было неотозвано до остановки, и подкасты, которыми делились и которые отозвали за это время (кроме снова расшаренных). Так продолжается до прохода работающего оверлея. - **Выход из приложения.** До остановки узла федерации `podcast_runtime::shutdown` ждёт до 4 с (`Reconciler::flush`): - пока допишутся начатые выключения и отписки; - пока проход, начатый после последнего `revoke_now`, подпишет и разошлёт tombstone. Если после этого карточка приватного подкаста может быть жива (отзыв не удался или федерация выключена), в журнал пишется предупреждение. Сохранение прогресса идёт параллельно. - **Fail-safe.** Если хранилище подкастов не открылось или регистры не читаются, устройство отзывает все свои карточки (`sync_shares(vec![])`). - **Журнал.** Только счётчики: ни URL лент, ни названий, ни id неопубликованных подкастов. ### Шаг 2. Поиск, карточка, «Подписаться» #### Поиск (`src/federation/mod.rs`, `src/podcasts/discovery.rs`, `src/app/cmdline.rs`, `src/ui/global.rs`) - Обычный поиск (`/` вне вкладки Podcasts) при работающей федерации запускает **две независимые задачи**: - музыкальный `Federation::search` (тело совпадает с базовой веткой) → `FedSearchLoaded`; - `Federation::search_podcasts` → `discovery::search` → `PodcastDht::search` → отдельное событие `FedPodcastsLoaded { seq }`. - Подкастовый поиск ограничен 15 с (`PODCAST_SEARCH_TIMEOUT`), включая bootstrap оверлея, который не покрыт дедлайном поиска FRID. При ошибке или таймауте список подкастов пуст, в журнал пишется предупреждение без запроса и без URL. Музыкальная выдача оверлей не ждёт. - Подкастовые позиции идут в порядке `merge_search_results`: сначала точные совпадения названия. - **Секция «Podcasts · public cards».** Подкасты выводятся после музыкальных результатов федерации в отдельной секции. Каждая строка помечена явным типом `[podcast]` (`SearchHitKind::Podcast`) и показывает автора и «open the card». Пока ищет хотя бы одна из двух задач, заголовок секции — «Federation · searching…». - **Правая колонка** показывает одно из двух: - число выпусков и число публикующих **устройств** (это не подписчики и не знак доверия); - `✓ subscribed`. - **Отметка «подписан»:** - задача поиска сопоставляет исходный URL каждой карточки с локальным хранилищем через `PodcastStore::resolve_podcast_id`, то есть с учётом алиасов ленты; - отметка ставится, если среди подписок есть этот id или id самой карточки; - подписка и отписка обновляют отметку сразу. - Курсор проходит строки в порядке: локальные результаты → федеративные артисты → треки → подкасты. Enter на подкасте открывает карточку и ничего не ставит в очередь. #### Карточка подкаста (`src/app/update/podcast_discovery.rs`, `src/ui/podcast_card.rs`, на русском) - **Что показывается:** - название и тип `[podcast]`; - пометка «Сведения ниже указали издатели карточки; они не проверены»; - автор, категории, язык; - число выпусков и дата последнего; - «Опубликовали: N устройств (не число подписчиков и не знак доверия)»; - адрес ленты (исходный — единственный, привязанный к id); - заявленные новые адреса с пометкой «не проверен, не используется»; - сайт и описание. - **`e` — сезоны и выпуски из RSS без подписки** (`discovery::preview_for`): - запрос идёт только к серверу самой ленты и никогда — к издателю карточки; - в хранилище ничего не пишется (только чтение, чтобы найти новый адрес ленты среди подписок); - показываются число выпусков, сезоны с количеством выпусков и до 200 выпусков (новые сверху, сезон/номер, дата, длительность). Если название в ленте отличается от заявленного, показывается «Название в ленте». Постоянный редирект или `itunes:new-feed-url` показывается как «Лента переехала». - **«Подписаться» (Enter/s)** → `discovery::subscribe_from_hit`: - подписка идёт по `hit.feed_url` — исходному URL, из которого получен `podcast_id`, — через `refresh::subscribe_url`; - claimed URL никогда не запрашивается и не становится алиасом, если к нему не ведёт сама лента; - карточка с id, не совпадающим с хешем её URL, отклоняется до любого запроса; - лента читается с её сервера, редиректы и `itunes:new-feed-url` обрабатываются как обычно; - **если лента по старому адресу объявляет новый, на который устройство уже подписано**, возвращается существующая подписка: ничего не записывается, второй подписки нет. То же правило действует для ручной подписки по URL; - сохраняется только то, что есть в ленте, — из карточки ничего; - подписка приватная, без решения «Поделиться»; прогресс независим; - пока идёт подписка, второй запуск не принимается. - **«✓ Уже подписан»** показывается, если устройство подписано по id карточки, по алиасу или (после `e`) по новому адресу, куда переехала лента. Enter тогда открывает подкаст во вкладке Podcasts. - **Клавиши:** - `↑↓`/`j k`/`PgUp PgDn`/`g` — прокрутка; - `esc/q` — закрыть. Высота текста с переносом по словам считается так же, как при отрисовке (`Paragraph::line_count`). Прокрутка останавливается на последней строке и не уходит за неё. Диалог «Поделиться» считает высоту так же. ## Исправления после межклиентской проверки 1. **Перезапуск со старым решением «Поделиться» снова публиковал карточку** (приватность, сценарий 7c, коммит `409188b`). Устройство B было выключено, пока на A выключили «Поделиться». После перезапуска B его первый проход сверки вызывал `sync_shares` по регистрам, сохранённым до остановки, раньше первой синхронизации устройств. С frid `9c82f6d` первый вызов заново рассылает неизменённые карточки, поэтому отозванная карточка снова объявлялась, пока не придёт выключение. - **Исправление.** Пока `DeviceSync::podcast_registers_current` не станет true, проход сверки только отзывает карточки (`publication::revoke_unshared` → `PodcastDht::unpublish` по одному) и `sync_shares` не вызывает. FRID продолжает придерживать карточки прошлой сессии. Watch становится true в двух случаях: - применён обмен синхронизации с устройством группы v4 после подключения хранилища подкастов: исходящий `sync_device`, входящий `handle_hello`, оба пути сопряжения; - ждать некого: устройств нет, есть только v3 или у устройств нет адреса. Устройство, удалённое из группы, тоже перестаёт ждаться; проверка идёт при подключении хранилища и на каждом такте `sync_loop`. - **Что видит пользователь.** Общие подкасты в отчёте — `Publication::WaitingForDevices`, в боковой панели — «shared · not published yet: waiting for a sync with your other devices». Локальное выключение «Поделиться» и отписка по-прежнему отзываются сразу, выход ждёт отзыва как раньше. Как только watch становится true, запускается полный проход. `reconcile` разделён на `read_plan`, `shared_ids` и `finish_pass` без изменения поведения. - **Тесты:** - `publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group` — два loopback-узла. До открытия шлюза посторонний ничего не находит, а `republish` отправляет 0 записей. Локальное выключение в это время сразу даёт tombstone. После открытия публикуется только подкаст, которым всё ещё делятся. На старом поведении (шлюз принудительно открыт) тест падает ровно как 7c: «a card was sent before device sync»; - `devices::podcast_sync_tests::podcast_registers_are_current_after_a_sync_with_the_group` — без сети: устройство одно, только v3, ожидание доступного v4, синхронизация до подключения хранилища не считается, hello после подключения считается, удалённое устройство больше не ждётся; - проверка строки ожидания в `ui::tests`. - **Документация:** README (раздел о публикации), ARCHITECTURE (Public discovery), AGENTS.md (граница подкастов), CHANGELOG 0.5.0. - **Повторный межклиентский прогон** (фазы 6–7, затем полный): 7c проходит. Отчёты B после перезапуска — `Running {pod1:…: WaitingForDevices}`, затем `{}` после синхронизации, ни одного `Published`. В логе B сначала «podcast share decisions are current: synced with a trusted device», затем «reconciled … unpublished=1». ## Решения и отступления - **Подтверждение приватности локально и не синхронизируется** (шаг 1). - Так требует контракт: `privacy_confirmed` — состояние клиента, а каждое устройство публикует под своим ключом. - Подтверждение лежит в отдельном JSON, потому что хранилище FRID не открывает файл с неожиданными таблицами. - Оно привязано к решению о публикации (`op_id` регистра share). Pending-подтверждение живёт только внутри одного вызова `set_shared` — между записью подтверждения и привязкой к решению. При ошибке записи оно откатывается, а при чтении файла отбрасывается. - Файл формата 1 (не выпускался) читается как пустой, и пользователя спрашивают снова. - Подкаст с «личным» URL, которым поделились на A, придержан на B, пока пользователь B не подтвердит. - **TUI придерживает строже, чем FRID.** В FRID придержанная карточка «остаётся как была», а при совпадающем feed URL пропускается без подтверждения (`already_published`). TUI не передаёт `sync_shares` неподтверждённый подкаст с предупреждениями, поэтому прежняя карточка с этого устройства отзывается и при смене URL. Если файл подтверждений потерян или повреждён, карточка отзывается и пользователя спрашивают снова — это безопасная сторона. - **Отзыв без debounce и ожидание при выходе.** Выход ждёт только отзывы, запрошенные на этом устройстве (выключение «Поделиться» и отписка), в том числе ещё записывающиеся. Если федерация выключена, ждать нечего: tombstone уйдёт при следующем запуске оверлея. Панель консервативно показывает «may not be revoked yet» для подкастов, которыми делились, а при выходе пишется предупреждение. - **Подкастовый поиск отдельно от музыкального.** `merge_search_results` — устойчивое разбиение по точному названию, и порядок подкастовых позиций от музыки не зависит. Поэтому подкасты ищутся отдельно, а `podcast_hits` применяет то же правило только к подкастам. Музыкальный поиск не изменился. - **Предпросмотр по явному `e`.** Открытие чужой карточки не делает запросов к сторонним хостам. Поэтому подписку под новым адресом ленты карточка узнаёт только после `e`. - **«Уже подписан»** — не мёртвая кнопка: Enter открывает подписку. - **Язык.** Диалог «Поделиться» и карточка подкаста на русском («Подписаться», «Уже подписан»). Список поиска и статусы на английском, как и весь остальной TUI. - **`Shift+F` на придержанном подкасте** открывает подтверждение, а не выключает «Поделиться». - **Устройство, вышедшее из группы** (или удалённое из неё), больше не получает решений группы и публикует общие подкасты, пока «Поделиться» не выключат на нём самом. Это записано в README. Автоматически выключать публикации при выходе из группы не стали: это изменило бы смысл leave-group в `devices.rs` для всех личных данных. - **ratatui:** включена фича `unstable-rendered-line-info` (`Paragraph::line_count`). Новых зависимостей нет; API нестабильный, поэтому версия зафиксирована на 0.30.x. - **CHANGELOG.** Запись о «Поделиться» из шага 1 перенесена из `[0.4.0]` (T2) в новый раздел `[0.5.0]`. Исправления по ревью вошли в записи `[0.5.0]`. - **Contract gap, F3 (`already_published` обходит подтверждение).** - `sync_shares` публикует карточку с предупреждениями без `privacy_confirmed`, если это устройство уже публикует те же feed URL. Устройство, пропустившее промежуточное выключение «Поделиться» (было закрыто, офлайн или попало в debounce), продолжило бы публиковать URL, который для нового решения никто не подтверждал. TUI обходит это сам (см. выше). - **Предложение:** не делать обход, если клиент явно передал `privacy_confirmed = false`, или привязать его к `op_id` решения share, под которым карточка была опубликована. Описать в `held_back`, что прежняя публикация отзывается. - **Contract gap, F3 (порядок maintenance) — исправлено.** - Было: `maintenance` после первого bootstrap переиздавал локально активные карточки ещё до первого `sync_shares`. - В frid `9c82f6d` (MR-F3) свои карточки прошлой сессии придерживаются до первого `sync_shares` в процессе. TUI откладывает первый `sync_shares` до синхронизации с группой (`409188b`, см. «Исправления после межклиентской проверки»). - Остаётся: `sync_shares` доверяет переданным регистрам, поэтому шлюз в клиенте обязателен. Предложение записать это нормой контракта — в MR-F3. - **Contract gap, F3 (bootstrap при поиске).** - `PodcastDht::search` делает `bootstrap()` при `known_peers() == 0` вне дедлайна поиска 15 с. Пока оверлей есть только у части сети, это случается при каждом поиске. Замер на loopback с одним недоступным контактом — 5,0 с. - Клиент ограничивает поиск сам. - **Предложение:** включить bootstrap в дедлайн поиска или не делать его, если maintenance недавно делал bootstrap. - **Contract gap, F3 (обложка и ссылка в карточке).** - `PodcastCardSpec::privacy_warnings()` проверяет только адреса ленты. Набор правил для ленты не подходит для обложек: `HighEntropyPathSegment` срабатывает на UUID и хеши публичных CDN. - **Предложение:** проверять `image_url` и `link` по правилам query и хоста без правила пути (или очищать их в `bounded()`), чтобы TUI и веб вели себя одинаково. Сейчас TUI фильтрует их сам и полагается на то, что правило пути проверяется последним. - **Contract gap, federation-net/F3 (герметичные тесты).** - Узлы всегда строятся с `presets::N0` (публичные relay и DNS-lookup). - В MR-F3 эту опцию не добавили: новое поле в `NetworkConfig` ломает API `federation-net 0.3.1`, а `ticket()` без relay не дожидается `online()`. Предложение перенесено в follow-up `federation-net 0.4` (режим `LocalOnly`, проброс через `MusicDhtConfigBuilder`), см. «Предложения на потом» в MR-F3. - **Contract gap, F2/F3 (сборка карточки дублируется в клиентах).** - Каталог не хранит `language` и `categories`, поэтому в карточках, которые публикует TUI, этих полей нет. Поле «Категории» в карточке TUI показывает, если их прислал другой издатель. - **Предложение:** - `PodcastStore::share_state(id)`; - общий `catalog_card`; - язык и категории в каталоге. - **Contract gap, F3 (статус).** - **Предложение:** `PodcastDhtSyncStats::active: Vec<PodcastId>` и отдельный счётчик неудавшихся отзывов. - **Contract gap, F3 (API слияния).** - `merge_search_results` принимает только `Vec<LibraryItem>`. - **Предложение:** обобщённое `merge_ranked` или публичный предикат точного совпадения, чтобы клиенты с агрегированной музыкой применяли тот же порядок. - **Contract gap, F2 («уже подписан» и новый адрес ленты).** - Клиент сам сочетает `resolve_podcast_id(hit.feed_url)`, id карточки и список подписок. Подписавшись по новому адресу, устройство не знает старый. - **Предложение:** - `PodcastStore::subscribed_podcast_for(&PodcastSearchHit) -> Option<PodcastId>`; - запись `itunes:new-feed-url` как алиаса того же id при обновлении (или отдельный grow-only набор «известных прежних адресов»), чтобы отметка в списке поиска работала в обе стороны без чтения ленты. ## Совместимость и версии - **`furumi-tui` 0.5.0** — минорное повышение относительно T2 (0.4.0). - Зависимости не менялись: `music-dht` 0.6.0 и `furumi-library` 0.3.0. - **`Cargo.lock` и `[patch]`:** последний коммит этого MR, «Point frid deps at the fork branch», подключает неопубликованный frid из форка: в `[patch.crates-io]` в `Cargo.toml` `music-dht` и `furumi-library` указывают на `git = "https://gt.hexor.cy/Sanapach/frid.git", branch = "podcasts/discovery"`, а в `Cargo.lock` у frid-крейтов (включая `federation-net`) стоит `source = "git+https://gt.hexor.cy/Sanapach/frid.git?branch=…#<sha>"`. Ветка стоит на `podcasts/tui` вместе с таким же коммитом MR-T2 и только меняет `branch = "podcasts/store"` на `branch = "podcasts/discovery"`. Сам MR в `Cargo.lock` меняет ещё версию `furumi_tui`. После публикации крейтов на crates.io эти строки удаляются, и lock перегенерируется ещё раз. - **Новое на проводе** — только оверлей FRID `furumi-fd/podcast-dht/1` (версия 1, схема кэша 2) и запись `podcast_dht` в capability manifest. - Музыкальный DHT (`music-dht-v5`), `federation-net` и device-sync v4 не менялись. - Поиск подкастов использует операции оверлея `FindValue`. Подписка из карточки — обычная v4-операция `podcast_subscription_set`. - Старые узлы не объявляют `podcast_dht`, поэтому оверлей их не опрашивает. Решение «Поделиться» — существующая операция v4 `podcast_share_set` из MR-T2. - Локальный файл подтверждений имеет формат 2. Формат 1 существовал только в неслитой версии этой ветки и читается как пустой. Pending-записи при чтении отбрасываются, формат от этого не меняется. ## Как проверено (macOS, Darwin 25.5, aarch64) Окружение: - `PATH=/opt/homebrew/opt/rustup/bin:$PATH`; - `CARGO_TARGET_DIR=/Users/krypton/furumi/gitea/.targets/tui-t3`; - crates frid подключены к ветке F3 через `[patch]`. Результаты на итоговом HEAD `409188b` (frid `podcasts/discovery` @ `9c82f6d`): - `cargo fmt --all -- --check` — OK. - `cargo check --all-targets` — OK, 0 предупреждений. - `cargo clippy --all-targets` — 22 предупреждения. Отсортированный список (файл + текст) совпадает с базовой веткой `podcasts/tui`; на `409188b` набор тот же, что на прежней вершине `6cbe3ce`; новых нет. - `cargo test --all-targets` — **335 passed, 0 failed, 4 ignored** (ignored были и раньше; до `409188b` было 332). - Новый регрессионный тест `a_restarted_device_publishes_only_after_syncing_with_its_group` падает на старом поведении (шлюз временно принудительно открыт) и проходит с исправлением. - Четыре loopback-теста (`shared_podcast_is_found…`, `the_reconciler_follows…`, `a_stranger_finds…`, `podcast_search_is_bounded…`) дополнительно прогнаны ещё 3 раза: 3/3 OK, примерно по 14 с. - Каждый промежуточный коммит собирается (`cargo check --all-targets`, 0 предупреждений), проходит `cargo fmt --check` и свои тесты. Коммиты повторного ревью проверены сборкой экспортированного индекса. - Регрессионные тесты для подтверждения, moved feed, прокрутки, придержки при `already_published`, отката pending-подтверждения и правила для обложек проверены на падение со старым поведением: временный откат, затем возврат. - `cargo test` выводит сообщение линкера macOS «__eh_frame section too large». Это не предупреждение rustc/clippy, и к изменениям оно не относится. - Postgres- и node-тестов в TUI нет. **Тесты шага 1:** - `podcasts::publication_tests::shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off` — два loopback-узла: A (TUI со своим хранилищем) и посторонний C без device sync. Проверено: - пока ничем не поделились, ничего не публикуется; - C находит общий подкаст поиском и по id, но не находит ни приватную подписку, ни придержанный `?token=`; - после подтверждения URL придержанный подкаст публикуется; - **устройство B выключает и снова включает «Поделиться» (операции применены к хранилищу A, A между ними не синхронизируется) → проход A даёт `HeldBack`, своя публикация неактивна (tombstone), C карточку не находит. Повторный проход ничего не меняет, после нового подтверждения карточка снова опубликована;** - выключение «Поделиться» → tombstone, C больше не находит подкаст; - повторная доставка старого «share» не публикует заново; - отписка отзывает; - без хранилища отзывается всё. - `share_states_carry_cards_only_for_shared_podcasts`, `a_stale_share_decision_from_another_device_does_not_republish`, `privacy_confirmations_are_local_and_bound_to_the_urls`. - Пять тестов переходов в `update` для «Поделиться» и диалога. - Два теста отрисовки (состояния публикации, диалог на русском). - `federation::tests::podcast_discovery_opens_or_turns_itself_off`, `capabilities::podcast_discovery_is_advertised_only_when_it_runs`. **Тесты шага 2:** - `podcasts::discovery_tests::a_stranger_finds_a_shared_card_subscribes_and_refreshes_from_the_feed` — сквозной тест на двух loopback-узлах с локальным HTTP-сервером ленты. Поиск идёт через `discovery::search`, как в приложении. - A подписан на две ленты и делится одной. Локальный адрес считается «личным» и подтверждается через `publication::set_shared`. - B — пользователь вне группы A. Он находит карточку поиском оверлея; порядок и сопоставление такие же, как в UI. - Проверено: тип `podcast`, исходный `feed_url`, издатель A; приватная подписка A не находится. - «Подписаться» даёт **тот же `podcast_id`**. Лента запрашивается у сервера ленты. У B нет решения «Поделиться» (только `podcast_subscription_set`), и B ничего не публикует. - B сам обновляет ленту, и новый выпуск приходит. - A выключает «Поделиться» → B больше не находит карточку, но **подписка B остаётся** и обновляется. - `subscribing_from_a_card_matches_subscribing_by_url`, `subscribing_from_a_card_never_fetches_a_claimed_url`, `hits_resolve_to_the_podcast_a_feed_alias_belongs_to`, `preview_reads_seasons_and_episodes_without_storing_anything`, `podcast_hits_put_exact_titles_first_and_keep_only_podcasts`. - `app::update::tests::podcast_discovery::*` (4), `ui::tests::search_marks_podcast_hits_apart_from_music`, `ui::tests::podcast_card_offers_subscribe_or_shows_already_subscribed`, `ui::podcast_card::tests::russian_plurals`. **Тесты по первому ревью:** - `publication_tests::the_reconciler_follows_the_overlay_and_revokes_without_the_debounce` — `publication::spawn` на loopback-оверлее: - пока `watch` = `None`, отчёт `Off`, а `flush` сразу возвращается; - после `Some` проход публикует; - число пиров обновляется без прохода; - три `wake` дают один проход; - `revoke_now` + `flush` укладываются в 0,9 × debounce, tombstone отправлен, посторонний узел карточку не находит; - `Some → None` даёт `Off`; - задача завершается, когда закрывается `watch`. - `publication_tests::revocations_that_fail_are_reported_without_ids`, `publication_tests::a_confirmation_does_not_outlive_a_revocation_on_another_device`, `publication_tests::cards_leave_out_artwork_and_links_that_look_private`. - `discovery_tests::podcast_search_is_bounded_and_empty_without_the_overlay`, `discovery_tests::a_card_for_an_older_address_finds_the_subscription_under_the_newer_one`. - `ui::tests::the_podcast_card_scrolls_exactly_to_its_last_line`. - Расширены `ui::tests::podcast_share_state_is_shown_in_the_list_and_details`, `update_tests::…::already_subscribed_cards_open_the_podcast_instead`, `privacy_confirmations_are_local_and_bound_to_the_urls`. **Тесты по повторному ревью (1 новый, 5 расширено):** - `publication_tests::a_confirmation_for_a_decision_that_was_not_written_is_dropped` (новый): - подтверждение + неудачная запись решения → на A ничего не подтверждено; - через какое-то время B включает «Поделиться» → A придерживает подкаст, `needs_confirmation`, в файле ничего; - pending, оставленный в файле, при повторном открытии отбрасывается. - `shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off` — сценарий B off+on на уровне оверлея (см. выше). - `cards_leave_out_artwork_and_links_that_look_private`: - UUID и хеши в пути (imgix, simplecast, mzstatic, cloudfront) — правила для ленты их отмечают, но обложка и ссылка остаются; - `sig=` в query, хост patreon и `ftp:` выкидываются. - `the_reconciler_follows_the_overlay_and_revokes_without_the_debounce`: - при выключенной федерации открытый `RevocationTicket` держит `flush`; - `done(Some(id))` завершает `flush` с `false` (карточка может быть жива); - отчёты `Off` сохраняют id в `unrevoked`; - снова расшаренный подкаст оттуда уходит; - сброшенный ticket не ждётся. - `update_tests::…::stopping_sharing_needs_no_dialog_and_a_held_publication_asks_again` — при `Off` и `Starting` выключение и отписка помечают подкаст, которым делились, как неотозванный; не расшаренный подкаст не помечается. - `revocations_that_fail_are_reported_without_ids` — `note_revocation` при `Running`, `Off` и `Starting`. - Обновлён `ui::tests::podcast_share_state_is_shown_in_the_list_and_details` («may not be revoked yet»). **Тесты после межклиентской проверки (2 новых, 1 расширен; см. «Исправления после межклиентской проверки»):** - `publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group` (два loopback-узла); - `devices::podcast_sync_tests::podcast_registers_are_current_after_a_sync_with_the_group` (без сети); - строка «waiting for a sync with your other devices» в `ui::tests`. Тесты не трогают реальные каталоги пользователя: используются временные каталоги, in-memory/temp-хранилища, локальный HTTP-сервер и loopback-узлы. Трафик оверлея между тестовыми узлами идёт по loopback, но узлы строятся с транспортом по умолчанию (`presets::N0`) и могут обращаться к публичным relay и DNS n0, как существующие тесты Jam, devices и frid. Это касается тестов: - `publication_tests::shared_podcast_is_found_by_a_stranger_and_revoked_by_share_off`; - `publication_tests::the_reconciler_follows_the_overlay_and_revokes_without_the_debounce`; - `discovery_tests::a_stranger_finds_a_shared_card_subscribes_and_refreshes_from_the_feed`; - `discovery_tests::podcast_search_is_bounded_and_empty_without_the_overlay`; - `publication_tests::a_restarted_device_publishes_only_after_syncing_with_its_group`. Без изменения `federation-net` это отключить нельзя (см. contract gap, follow-up `federation-net 0.4`). ## Проверенные и непроверенные сценарии **Проверено автоматически:** - приватная подписка не находится посторонним; - «Поделиться» → посторонний находит карточку, просматривает сезоны и выпуски (предпросмотр), подписывается тем же id и обновляет ленту сам; - отзыв убирает карточку, но не подписку постороннего; - отзыв уходит без debounce, ожидание перед выходом работает, в том числе пока решение ещё записывается; - позднее «share» не восстанавливает публикацию; - подтверждение не переживает решения, принятые на другом устройстве, в том числе когда это устройство пропустило промежуточное выключение (карточка отзывается); - неудачная запись решения не оставляет подтверждения; - отписка отзывает; - при выключенной федерации отозванный подкаст, которым делились, остаётся «may not be revoked yet»; - «уже подписан» распознаётся по id, через алиас и через новый адрес ленты; повторной подписки нет; - claimed URL не используется; - поиск подкастов ограничен по времени и не задерживает музыку. **Проверено межклиентским прогоном** (реальные процессы, см. «Межклиентская проверка»): две установки TUI одного пользователя плюс посторонний TUI; TUI ↔ веб в обе стороны; `Federation::start` и `Federation::search_podcasts` целиком; перезапуск со старым решением «Поделиться» (7c). **Не проверено:** - ручной прогон человеком с реальными каталогами пользователя, в том числе выход сразу после `Shift+F` (порядок «ticket до записи» проверен только на уровне `Reconciler`, без `perform`); - полностью изолированная сеть: узлы iroh в тестах и межклиентском прогоне используют relay и DNS n0 и Mainline-DHT (локального режима транспорта нет); - Linux и Windows. ## Межклиентская проверка **Окружение** — то же, что в MR-T2. Вершина стека: TUI 0.5.0 (`409188b`), веб 0.15.0 (`0e985b4`), frid `9c82f6d` через локальный `[patch]`. Отдельные HOME и каталоги данных, ленты только с 127.0.0.1, узлы iroh с preset n0 и Mainline-DHT (случайный id сети на прогон). TUI ↔ TUI: 23 проверки из 23 прошли (включая 7c, которая до `409188b` падала). TUI ↔ веб: 37 pass, 3 info, 2 not run, 0 fail. Сценарии синхронизации, переноса, старых пиров и Jam — в таблице MR-T2. Здесь — публикация и поиск. | Сценарий | Клиенты | Результат | | --- | --- | --- | | 6a. Посторонний E находит карточку поиском, `[podcast]`, 2 издателя (A и B); для обычного URL диалог подтверждения не нужен | TUI A, B (группа) + TUI E вне группы, связан только тикетами | pass | | 6b. E подписывается из карточки: тот же `podcast_id` (хеш URL ленты), 3 выпуска, `shared=false`, в списке «✓ subscribed», в карточке «Уже подписан» | TUI E | pass | | 6c. Приватный подкаст не находится ни по одному слову названия | TUI E | pass | | 6d. A выключает «Поделиться» (синхронизировано на B): карточка пропадает из поиска E через 0,5 с, подписка E остаётся | TUI A, B, E | pass | | 7a. Перезапуск: id устройств, группа, подписки, «Поделиться», выпуски и позиции совпадают | TUI A, B | pass | | 7b. Публикация, отозванная на A, не возвращается после перезапуска A (8 поисков E за ~60 с ничего не нашли) | TUI A, B, E | pass | | 7c. B был выключен, пока A выключил «Поделиться»: после перезапуска B карточку не публикует (отчёты `WaitingForDevices` → `{}`, итоговый список издателей пуст) | TUI A, B, E | до `409188b` — FAIL, на `409188b` — pass | | S6. Веб-аккаунт делится → TUI находит карточку и подписывается тем же id, подписка синхронизируется в веб-аккаунт группы; одиночный TUI делится → веб находит; выключение с любой стороны убирает карточку, подписки остаются; `Shift+F` в TUI синхронизируется в веб, и веб публикует тоже (2 издателя); приватные подкасты не находятся нигде | TUI 0.5.0 (в группе и вне её) + веб 0.15.0 (два аккаунта) | pass | | Шлюз первого прохода в реальных логах: TUI без группы пишет «podcast share decisions are current: no trusted device syncs podcasts» и публикует сразу | TUI 0.5.0 | pass | Наблюдения: - задержка удалённой публикации до ~10 мин, если поделиться, пока оверлей не знает пиров («remote_nodes=0», первая находка веба — через 311 с, харнесс опрашивал поиск только в начале сценария). Это поведение frid (bootstrap раз в 10 мин), предложение — в MR-F3; - карточка подкаста в TUI на русском, а остальной интерфейс на английском — так задумано (см. «Решения и отступления»). Вживую не прогонялось: Jam с хостом-TUI и гостем-вебом (веб не поддерживает федеративный Jam). ## Ограничения - **Платформы.** Проверен только macOS. - **Поиск подкастов** занимает до 15 с (вместе с bootstrap оверлея), после этого выдача пуста. Музыкальная выдача его не ждёт. Если подкасты пришли раньше музыки, позиция курсора в списке может сдвинуться, как и при поздних федеративных результатах. - **Объёмы:** - до 20 подкастов на запрос, без пагинации; - предпросмотр — до 200 выпусков, без постраничного просмотра по сезонам; - обложка карточки не показывается. - **Отметка в списке поиска.** Она учитывает id карточки и алиасы, которые знает это устройство (подписка по старому адресу, переехавшему на адрес карточки). Если устройство подписано по более новому адресу, чем адрес карточки, список отметку не показывает. Её показывает карточка после `e`, а «Подписаться» второй подписки не создаёт. Алиас, пришедший позже через синхронизацию, учтётся при следующем поиске. - **Отзыв при выходе.** Выход ждёт до 4 с только отзывы, запрошенные на этом устройстве. Решения других устройств, полученные перед самым выходом, применяются с debounce 1 с и не ожидаются; при следующем запуске их применит первый проход. - **Федерация выключена.** Панель не знает, была ли карточка опубликована в прошлой сессии, поэтому «may not be revoked yet» показывается для каждого подкаста, которым делились (это может быть и придержанный, никогда не опубликованный подкаст). Подкасты, отозванные на других устройствах, пока федерация выключена, так не помечаются. - **Придержанный подкаст.** Если карточка была опубликована с этого устройства, а подтверждение снято решением на другом устройстве, карточка отзывается до нового подтверждения. Временная недоступность карточки — плата за то, чтобы не публиковать неподтверждённый URL. - **Устройство вне группы** продолжает публиковать, пока «Поделиться» не выключат на нём самом (см. README). - **Произвольный хост.** Предпросмотр и подписка запрашивают исходный URL карточки, на каком бы хосте он ни был, включая адреса локальной сети. Это то же самое, что ввод URL вручную. Фильтра хостов в TUI нет. - **Запросы к пирам.** Слова поискового запроса уходят пирам оверлея, как и при музыкальном поиске. Это описано в README. - **Eventual consistency отзыва (FRID).** Реплики, пропустившие tombstone, отдают старую карточку до её истечения, не дольше 12 ч. - **Связываемость.** Ключ издателя — iroh-ключ устройства, по нему общие подкасты связываются с публичной музыкальной библиотекой и сетевым адресом устройства. Это описано в README. - **Обложки.** Ключ доступа только в пути URL обложки (без query) не распознаётся. Для лент с «личным» адресом обложка не публикуется в любом случае. - **Окно переиздания при старте** исправлено (frid `9c82f6d` + `409188b`). - **Публикация после перезапуска ждёт группу.** Устройство, у которого есть устройства группы v4 с адресом, но они недоступны, не публикует общие подкасты, пока не синхронизируется с одним из них или пока их не удалят из группы. Это осознанный выбор в пользу приватности. Отзыв (выключение «Поделиться», отписка) в это время работает сразу. - **Файл подтверждений** читается при открытии хранилища. Его внешние правки во время работы не отслеживаются. - **Диалог «Поделиться»** не прокручивается. В очень низком терминале последняя поясняющая строка может не поместиться; причины и адреса стоят выше. - **`Cargo.lock`** перед merge перегенерируется против запушенной ветки форка frid, а позже — против опубликованных `music-dht` 0.6 / `furumi-library` 0.3 (см. «Совместимость и версии»). ## Зависимости и стек - **FRID:** F1 → F2 → **F3** (`podcast_dht`), ветка `podcasts/discovery`. - **TUI:** T1 → T2 (`podcasts/tui`) → **T3** (этот MR, ветка `podcasts/discovery`). - **Веб:** аналог — W2 → W3. - Сливать после F3 и T2. - Ветка `Sanapach/furumi-tui:podcasts/discovery` → `Furumi/furumi-tui:podcasts/tui`, если эта ветка-основание есть в Furumi/furumi-tui. Иначе MR открывается в `federation`: он зависит от MR-T1 и MR-T2, и его diff включает их коммиты. - 22 коммита поверх `podcasts/tui` @ `ea7cdc4` (`git log --oneline podcasts/tui..podcasts/discovery`, вершина `59d6a1f`). После межклиентской проверки ветка перебазирована на новую вершину MR-T2; по содержанию коммиты не изменились, сменились только хеши. Последний коммит — «Point frid deps at the fork branch» (`59d6a1f`). Шаг 1: - `c453b0a` Run the podcast discovery overlay in the federation node - `8c90035` Reconcile own podcast publications with the share registers - `8f4e58d` Add a share toggle to the Podcasts tab - `6d22553` Document sharing podcasts in the federation Шаг 2: - `25a9f2b` Subscribe to a parsed feed URL - `e038f28` Find public podcasts in search and subscribe from their cards - `160237b` Test subscribing from a public podcast card - `d38144f` Document finding public podcasts and bump to 0.5.0 Исправления по ревью: - `a51f555` Search public podcasts apart from the music search - `1137670` Revoke podcast cards promptly and report unrevoked ones - `7add669` Bind share confirmations to the share decision - `744d56e` Leave private-looking artwork and links out of cards - `fd68271` Recognize subscriptions under a feed's newer address - `17ed8bf` Scroll the podcast card exactly to its end - `3ddf799` Document prompt revocation and moved-feed subscriptions Исправления по повторному ревью: - `405f8ae` Hold back unconfirmed private-looking cards before syncing - `43e0696` Drop share confirmations whose decision was not written - `d6962eb` Keep public artwork whose path only looks random - `adfe809` Wait for in-flight revocations and track them with federation off - `ce5697c` Document held-back revocation and quitting during a revocation После межклиентской проверки: - `409188b` Publish podcast cards only after the first device sync - `59d6a1f` Point frid deps at the fork branch 🤖 Generated with [Claude Code](https://claude.com/claude-code)
sanapach added 57 commits 2026-11-20 13:26:47 +00:00
Tabs are now 1 Library, 2 Playlists, 3 Queue, 4 Podcasts, 5 Settings,
6 Logs. The Podcasts tab is a placeholder that states podcasts are not
available in this build yet; it gets its own "podcasts" key context.

Keymap files gain an optional top-level `version`. The default keymap
declares `version = 2` and binds "6" to the Logs tab. Files without a
version (or with version 1) have their GoToTab indices remapped in
memory (3 -> 4, 4 -> 5, and 5 -> 3 for the prototype podcast build) with
a startup notice; the user's file is never rewritten. The help window
names the target tab instead of "Go to tab N".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
TrackItem gained a podcast field; music literals set it to None. The
music-dht podcast-feed feature provides the shared RSS/Atom parser.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add src/podcasts: an HTTP client with conditional requests, hand-followed
redirects (permanent ones become feed aliases via PodcastStore::apply_feed),
size and time limits and a furumi user agent; subscribe and refresh flows
that parse feeds with the shared music-dht parser and keep the store's
local fetch state with exponential back-off and Retry-After.

DeviceSync::run_podcast_action hands PodcastStore actions stamps reserved
in the device-sync log and appends the operations they return with exactly
those stamps. Podcast operations stay out of outgoing sync batches until
this client speaks sync protocol v4.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The tab opens the FRID podcast store (podcasts.sqlite3, migrating a
prototype database in place; newer or foreign files are reported and left
unchanged) off the UI thread and shows subscriptions with unplayed counts
and check status, podcast -> seasons -> episodes navigation, and episodes
with saved position, played state, duration and date. Episode search,
played filter and order run as paged store queries with request sequence
numbers. Adding a feed, checking one or all feeds, marking played and
unsubscribing (with a confirmation that progress is kept) go through
Effect/AppEvent; a scheduler refreshes due feeds in the background.

New actions are bound in the podcasts keymap context and listed in a
Podcasts help section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
furumi-library 0.3.0 adds TrackItem.podcast, which makes TrackItem a few
hundred bytes larger. Box the track-info result and the federation status
in AppEvent so the event enum stays small (and clippy's
large_enum_variant does not fire on it).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Podcast episodes share the sentinel id -1, so the queue key now checks
the episode id first (ep:...) and falls back to TrackItem::key instead of
local:{id}. Likes, playlists, metadata edits, music history, content-id
lookups, share links, similarity and artist/release jumps skip episodes;
Shift-J and the info popup open the podcast instead. Sync protocol 3
cannot carry episodes, so peers and Jam guests get the private-item
placeholder, handoff of a queue with episodes is refused and remote
SetState commands do not replace such a queue.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Episodes stream from the publisher through the prototype's bounded HTTP
Range reader (ported, URL queries redacted from errors). The audio URL and
resume position come from the store at play time; a 4xx on the audio URL
refreshes the feed once and retries with the address it now lists, and a
stream that cannot seek refuses to start at a saved position instead of
playing from the wrong place. Prepared sources reach the audio thread
with the player's source generation, so a slow stream never replaces a
newer start or stop, and with their start offset for position reporting.

Progress follows the FRID contract through one ordered writer thread:
start_session or restart on start, checkpoints every 20 s and on pause,
explicit seeks, complete_session near the end or at end of stream, and a
final save with the last seen position on stop, track change, handoff
and exit. A superseded session stops checkpointing until the next
explicit action; listening sessions are recorded at pause, completion
and end. Enter on an episode plays it after the current item, b starts
it over, a/A queue it, and mark played goes through the same writer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The progress tracker's observation step is now a pure method with tests
for listening time (jumps and pauses do not count), pause saves, the
checkpoint interval and one-time completion. A seek no longer marks the
playback completed by itself, so seeking into the last seconds still
sends complete_session on the next tick. The episode list render test
covers the live position of the playing episode.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The private copies of the device-sync wire types are replaced by
music_dht::device_sync. Golden tests keep the furumi-tui 0.3.x types
verbatim and check that v3 messages serialize byte for byte the same.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A device_profile_set and the pending pairing row used to store this
build's own protocol constant for another device, which would defeat
version gating. Self-reports (hello, pairing, the sender's own entry of a
devices list, its own profile announcement) now replace the stored
version and relayed profiles only raise it. Invites and profile
announcements carry the version, and the first start of a new version
announces it in the log.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This client now announces device-sync protocol 4. Podcast operations
are applied to the podcast store, kept in the log and relayed; those
that arrive before the store opens wait in sync_podcast_pending.
Snapshots carry the podcast sections, bounded by the shared limits and
by the line budget of each message, and are merged after the operations.
Operations, snapshot sections and playback state that need v4 are only
sent to peers that reported v4. Periodic progress checkpoints are
coalesced in the log, and the Podcasts tab reloads after changes from
other devices.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Queue items now cross the wire with their explicit source: episodes as
PlaybackSource::PodcastEpisode, received ones as TrackItem episodes, and
the source mode filter never drops them. A handoff carries the episode,
position and pause; an episode that becomes current at position 0
resumes from its saved position. A podcast queue is not handed to a
device below v4 (it needs an update), and playback commands from such a
device are ignored while the queue has episodes. Controlling a v4 device
may queue episodes.

Jam hosts publish redacted snapshots, so guests see numbered private
placeholders. Guest commands that add episodes are dropped; their
placeholders are mapped back to the host's episodes, and changes that
drop or duplicate them, or seek in them, are refused. A guest leaving a
Jam drops the placeholders.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
README explains that podcast state is private by default, syncs only
between trusted devices and streams audio from the publisher, plus
handoff, Jam and older devices. ARCHITECTURE, AGENTS and the changelog
describe protocol v4, version gating, the podcast store bridge and the
invariants (no numeric ids for episodes, versions only from the device
itself).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Podcast operations and playback commands with episodes carry feed and
audio URLs that may hold private tokens; the Logs tab shows this crate's
debug output. Log only their kind.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A device below sync v4 got no playback snapshot while the queue held an
episode, so its engine never heard the owner's heartbeat and took
playback over by automatic failover after two minutes; this device then
adopted its queue and the episodes were gone. Send such peers the
coordination envelope with the queue redacted like for Jam: every
episode becomes an opaque "Private item", nothing is stripped, and their
commands stay refused while the queue has episodes.

This departs from FRID PLAYBACK_PROTOCOL.md rule 1 ("send None") and is
reported as a contract gap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- The stream reader records whether the decoder stopped on a read error
  and whether the server announced the file size. An episode whose
  connection was lost (stall, expired URL) or whose sizeless stream
  closed early is no longer completed at its full duration: the last
  position is saved, playback stops on the episode and the queue does
  not move on (playback::played_to_the_end).
- Streams are cancelled by the player's source generation: a superseded
  start stops connecting or reading up to its resume offset, and a read
  blocked inside the audio callback returns within 100 ms instead of up
  to 30 s. The player no longer reports the end of a superseded source.
- A pause or resume pressed while an episode connects is applied when
  its source arrives (Controller::expect_source).
- Seeks report their result (PlayerEvent::Seeked); an episode's seek is
  saved only when the audio moved, and seeks while connecting or in a
  stream without Range support are refused with a message.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The prototype import keeps the prototype's ETag and Last-Modified, but
the prototype stored no seasons, episode numbers or types, and GUID-less
episodes stay provisional until the feed is parsed again. The first check
was answered 304 and a feed that no longer changes was never parsed.
Drop the imported validators right after the migration so the first
check downloads and applies the feed. Contract gap for the FRID import.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A 301 to a new host followed by a 302 (CDN, tracker) never moved the
feed, because only all-permanent chains counted; every check then went
through the old address without validators and re-applied the whole
feed. The target of the leading permanent hops is now recorded as the
new fetch URL (the old one becomes an alias); the document is still
parsed against the URL that served it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The device-sync stream handlers exported and merged podcast snapshot
sections and operations synchronously on a Tokio worker. While a large
feed refresh held the store (up to about half a second), the worker's
other tasks (feed checks, streams, art) waited. Run that work in
block_in_place on the multi-thread runtime, and say so in ARCHITECTURE.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A slow server could hold one of the four refresh slots for 60 s per
redirect hop. A feed or cover fetch now has an overall deadline (120 s).
Tests cover feeds over the size cap with and without Content-Length
(error recorded with back-off, catalog kept), the redirect cap, a
redirect loop, a non-http redirect, a hanging server, and covers (not an
image, over the cap, written atomically). The test server can stall.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A stream without a file size whose decoder cannot measure its duration
only has the feed's itunes:duration, which is often longer than the
audio. Treat that duration as a hint: a clean close past 80 % of it is
the end. A duration the decoder measured keeps the strict completion
window. The interrupted message for a stream that cannot seek now says
to start over or mark the episode played instead of "press play".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The prototype import commits inside PodcastStore::open and the imported
validators were dropped afterwards, once. A start that stopped in
between left them for good. A marker next to the store, written before
the import and removed once every podcast was handled, makes the step
run again at the next start. The imported failure count is recorded
again as it was, so the back-off is kept.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A device below sync v4 mirrors the redacted queue it gets with its own
types, which drop PlaybackTrack::source, so each "Private item" becomes
a bare music item. When it takes playback over (Play on it, a
paused-startup claim, automatic failover) or sends a command, it
announces those items, and this device adopted unplayable fake tracks
and passed them on to every v4 peer. States from such devices are now
cleaned on receipt, with a status message once per change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The node serves FRID's podcast_dht overlay next to the similarity overlay
(cache federation/podcast-dht.sqlite3), runs its maintenance, hands peer
capability manifests to note_peer_capabilities and advertises podcast_dht
only while the overlay runs. A cache that cannot be opened is logged and
only turns discovery off. The running overlay is exposed through a watch
channel for the publication reconciler.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
podcasts::publication builds one PodcastShareState per subscription (cards
from the catalog for shared podcasts only, the device-local privacy
confirmation) and hands them to PodcastDht::sync_shares, which publishes
what is shared and tombstones the rest. Without a readable store every own
card is revoked. Privacy confirmations live in a 0600 JSON file next to
podcasts.sqlite3 and cover exactly the confirmed URLs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Shift+F in the podcasts context shares the selected or opened podcast
through PodcastStore::set_shared (a synced decision) or makes it private
again. A feed URL that looks private is confirmed first in a dialog that
lists the warnings in Russian. The reconciler runs after share and
unsubscribe actions, received podcast operations, feed refreshes, overlay
restarts and periodically; the list and side panel show the shared and
published state and publication errors.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Split refresh::subscribe into input parsing and subscribe_url, so a
public card's origin URL can be subscribed to exactly as given, and let
the feed parser be reused for previews.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Federated search also queries the podcast discovery overlay and lists
the podcast entries of merge_search_results after the music results,
marked [podcast], with the publishing devices or "subscribed" (also
through a feed alias resolved off the UI thread). Enter opens the card:
the publishers' claims, the origin feed URL, unverified moved-feed
claims, an optional episode preview read from the feed itself, and
«Подписаться», which subscribes privately with the origin URL only.
«Уже подписан» opens the podcast in the Podcasts tab instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Cover the merge order of podcast hits, alias resolution, the feed
preview, subscribing from a card (same podcast id as by URL, never a
claimed URL, forged ids refused) and an end-to-end run: a stranger's
node finds a shared card over loopback overlay nodes, subscribes
privately, refreshes from a local feed server and keeps the
subscription after the publisher stops sharing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Federated music results no longer wait for the discovery overlay: the
podcast search runs as its own task, bounded at 15 s including the
overlay's bootstrap, and arrives as its own event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Turning sharing off or unsubscribing runs a reconciler pass right away,
and quitting waits up to 4 s for it. The Podcasts tab tells a private
podcast whose card from this device is still live, failed revocations
are reported without ids, the overlay peer count stays current, and the
reconciler loop is tested against a loopback overlay.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A privacy confirmation now covers the share decision it was given for,
not only the URLs: sharing turned off, or turned on again after a
revocation, on any trusted device drops it, so this device asks again
before it publishes a feed URL that looks private.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The share dialog shows the feed URLs only, so a card no longer carries
an artwork or web page URL that looks like it holds an access key, and
a member feed's card carries neither.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Subscribing to an older address whose feed announces a newer one this
device already follows (itunes:new-feed-url without a redirect) reports
the existing subscription instead of adding a second one, and a card
whose feed moved to a followed address reads «Уже подписан» once its
episodes were read.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The card and the share dialog measure their word-wrapped height the
way it is rendered (ratatui's rendered-line-info), and scroll keys stop
at the last line instead of running past it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
README, ARCHITECTURE, CHANGELOG and AGENTS describe the immediate
revocation and quit-time wait, decision-bound confirmations, the card
URL filter, devices that left the group, the separate bounded podcast
search, and which direction of a moved feed the search mark covers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
FRID's sync_shares keeps publishing a card whose feed URLs this device
already publishes, even without the privacy confirmation. A device that
missed an intermediate share-off would go on publishing a private-looking
URL nobody confirmed for the new decision. share_plan now leaves such a
podcast out of the states, so sync_shares revokes the old card, and
reports it as held back itself.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A confirmation is recorded as pending before the share decision is
written and covers the next newer decision. When the write failed (the
podcast was unsubscribed by a sync meanwhile, a database error), the
pending entry stayed and later covered a decision taken on another
device that this user never saw. Put the previous entry back on failure,
and drop pending entries left in the file by a call that never finished.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Public podcast hosts and CDNs name artwork and pages by UUIDs and
content hashes, so the random-looking path rule dropped the artwork of
most public podcasts. Artwork and links now follow the query and host
rules only; a member feed's artwork is still left out with its feed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Share-off and unsubscribe now take a revocation ticket on the UI thread
before the write starts and ask for the immediate pass from the blocking
task once the write succeeded, so quitting right after Shift+F (before the
write's event was handled) still waits for the tombstone. With the
federation off or not started yet, a podcast that was shared counts as
possibly not revoked: the reconciler keeps it in the Off reports until the
overlay runs, the side panel says the card may not be revoked yet, and the
quit-time flush logs a warning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A device restarted with a "share" decision that another device of its
group revoked meanwhile sent that card again: the first reconciler pass
called sync_shares from the stale registers before device sync ran.
Until DeviceSync says the registers are current (a sync exchange with a
v4 device of the group after the store was attached, or no such device
to wait for), passes now only unpublish cards the local registers no
longer share and never call sync_shares.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
sanapach changed title from Podcasts/discovery to Публичные подкасты в TUI: «Поделиться», поиск с типом podcast и «Подписаться» из карточки (MR-T3) 2026-11-20 13:40:44 +00:00
ab merged commit 81f422b244 into federation 2026-11-20 14:11:11 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Furumi/furumi-tui#4