Подкасты в TUI на контракте FRID: подписки, воспроизведение, прогресс, синхронизация устройств v4 (MR-T2) #3

Merged
ab merged 30 commits from sanapach/furumi-tui:podcasts/tui into federation 2026-11-20 14:11:09 +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 и зависимости — в разделе зависимостей ниже.

Статус: все три шага MR-T2 сделаны. Исправлены 11 замечаний первого ревью и 5 замечаний повторного (это 3 разные проблемы). Межклиентская проверка TUI ↔ TUI и TUI ↔ веб пройдена в составе всего стека (см. «Межклиентская проверка»). По её итогам добавлен один тест (c7e6a36), код не менялся. MR готов к ревью. Ниже указано, что проверено автоматически, что межклиентским прогоном и что не проверено. Публикация и поиск подкастов войдут в MR-T3. Поэтому сам по себе этот MR ещё не даёт законченной поддержки подкастов во всей экосистеме (§10 требований).

Что сделано

Шаг 1. Хранилище, RSS, вкладка Podcasts

Зависимости

  • Новые версии: music-dht = { version = "0.6.0", features = ["podcast-feed"] }, furumi-library = "0.3.0".
  • Новое поле TrackItem.podcast во всех музыкальных литералах равно None.
  • TrackItem стал больше, поэтому две полезные нагрузки AppEvent (FedTrackInfoLoaded.result, FederationStatus) теперь хранятся в Box.

Хранилище

  • Используется общий furumi_library::podcasts::PodcastStore из FRID. Своей модели, ID и правил слияния в TUI нет.
  • Данные лежат в podcasts.sqlite3 в каталоге данных платформы. База прототипа переносится на месте.
  • После переноса базы прототипа её HTTP-валидаторы (ETag, Last-Modified) сбрасываются, и первая проверка ленты загружает её целиком. Иначе сервер отвечал бы 304, и не появились бы сезоны, номера выпусков и новые ключи выпусков без GUID. Сброс можно повторить: до импорта рядом с базой записывается маркер podcasts.sqlite3.full-check-pending, и он удаляется только после обработки всех подкастов. Если запуск прервался между миграцией и сбросом, сброс выполнится при следующем запуске. Это обход contract gap в F2, см. «Решения и отступления».
  • Хранилище открывается в фоне. Если файл создан более новой версией Furumi или это чужой файл:
    • вкладка показывает причину;
    • файл не меняется;
    • остальное приложение работает.

Загрузка и обновление RSS (src/podcasts/)

  • HTTP-клиент взят из прототипа:
    • условные запросы;
    • редиректы обрабатываются вручную: не больше 10, только http(s);
    • лента переезжает на адрес, к которому ведут начальные постоянные редиректы (301/308), даже если за ними следует временный (CDN, трекер). Цепочка, которая начинается с временного редиректа, ленту не переносит;
    • лимиты: 32 МиБ на ленту, 10 МиБ на обложку, 15 с на соединение, 60 с на запрос, 120 с на всю загрузку вместе с редиректами;
    • User-Agent furumi/<версия> (podcast reader);
    • в ошибках скрывается query URL.
  • Ленты разбирает общий парсер music_dht::podcast::feed, а записывает PodcastStore::apply_feed. Постоянный редирект или itunes:new-feed-url становится алиасом.
  • Подписка:
    • повторная подписка через алиас переиспользует ID и прогресс;
    • если по URL не лента, ничего не сохраняется;
    • новая подписка приватная.
  • Планировщик:
    • раз в минуту запрашивает ленты, которые пора проверить;
    • проверяет не больше 4 одновременно;
    • после успеха делает паузу 1 ч, после ошибки — от 5 мин до 24 ч, но не меньше Retry-After;
    • ошибка не очищает каталог;
    • можно вручную проверить одну ленту или все.
  • Хранилище и сеть работают вне UI-потока.

Вкладка Podcasts

  • Список подписок со счётчиками, ошибками и боковой панелью.
  • Навигация: подкаст → сезоны → выпуски.
  • В строке выпуска:
    • ●, ◐, ✓;
    • дата, SxEy, длительность.
  • Поиск, фильтр, сортировка.
  • «Прослушано / не прослушано».
  • Отписка с подтверждением. Прогресс и история при этом сохраняются.

Шаг 2. Очередь, воспроизведение, долговечный прогресс

  • Явный источник в очереди. Выпуск — это TrackItem::podcast_episode(PodcastEpisodeRef).
    • Числовой id у всех выпусков одинаковый (−1) и никогда не служит идентичностью.
    • Ключ очереди: ep:<episode id>, затем content:, fed:, lib:<id>.
    • Музыкальные пути пропускают выпуски: лайки, плейлисты, история, content id, федерация, похожие треки, frid://, редактирование.
    • Shift+J открывает подкаст.
  • Воспроизведение (src/podcasts/stream.rs, playback.rs, плеер):
    • поток идёт с сервера издателя через HTTP Range reader из прототипа. Окно: 8 МиБ вперёд, 1 МиБ назад и 256 КиБ начала файла. При обрыве соединение повторяется; если 30 с нет данных, чтение прекращается;
    • ничего не скачивается заранее;
    • URL и позиция берутся из хранилища в момент запуска;
    • если сервер ответил 4xx, лента проверяется один раз и запуск повторяется;
    • если перемотать нельзя, выпуск не стартует с неверного места;
    • PlaySource несёт поколение источника, поэтому запоздавший поток отбрасывается;
    • отмена устаревших запусков. Новый запуск или остановка отменяет поток предыдущего: подключение, дочитывание до позиции продолжения на сервере без Range и чтение, которое ждёт данных в аудиоколбэке. Всё это завершается в пределах 100 мс. Конец вытесненного источника плеер не считает окончанием трека;
    • обрыв не завершает выпуск. Поток запоминает, закончился ли он ошибкой чтения и сообщил ли сервер размер файла (StreamProbe). Выпуск завершается и очередь идёт дальше, только если поток дошёл до описанного сервером конца или оборвался уже в окне завершения (playback::played_to_the_end). Иначе сохраняется последняя позиция, воспроизведение останавливается на этом выпуске и показывается сообщение;
    • поток без размера (сервер не прислал Content-Length). Здесь закрытое соединение выглядит как конец файла, поэтому позиция сравнивается с длительностью. Если длительность измерил декодер (заголовок файла), действует строгое окно завершения. Если её знает только лента (itunes:duration, часто неточная), концом считается чистое закрытие после 80 % этой длительности. Если длительности нет вообще, концом считается само закрытие. Признак duration_measured передаётся от open_at до решения о завершении. На таком сервере нельзя перематывать, поэтому для прерванного выпуска сообщение предлагает начать сначала (b) или отметить прослушанным (m), а не «нажмите Play»;
    • пауза во время подключения сохраняется. Пауза и продолжение, нажатые, пока выпуск подключается, применяются при старте источника (Controller::expect_source);
    • перемотка подтверждается плеером. Аудиопоток сообщает результат (PlayerEvent::Seeked), и в прогресс записывается только перемотка, которая сработала. Перемотка во время подключения или в потоке без известного размера отклоняется с сообщением, в том числе по команде управляющего устройства.
  • Прогресс (src/podcasts/progress.rs): один фоновый поток по порядку записывает все действия через журнал синхронизации.
    • Действия контракта: start_session / restart, checkpoint каждые 20 с, seek, complete_session.
    • Прогресс сохраняется на паузе, при остановке, смене трека, передаче и выходе.
    • Если хранилище знает более новое поколение, checkpoint больше не пишутся.
  • Интерфейс:
    • Enter — воспроизвести или продолжить;
    • b — начать сначала;
    • a / Shift+A — добавить в очередь;
    • у играющего выпуска ▶ и текущая позиция.

Шаг 3. Синхронизация устройств v4, перенос воспроизведения, Jam

Общие wire-типы

  • Приватных копий wire-типов в src/devices.rs больше нет. Используются типы из music_dht::device_sync:
    • InviteWire, DeviceProfileWire;
    • SyncOpWire / SyncOpPayload, SyncSnapshot;
    • Playback*, WireMessage;
    • общие функции ввода-вывода и приглашений.
  • Golden-тесты (src/devices/wire_compat_tests.rs):
    • хранят дословные типы furumi-tui 0.3.x, сверенные с базовой веткой поле за полем;
    • проверяют, что сообщения v3 сериализуются байт в байт так же. fixtures/v3_hello.golden.json совпадает с файлом веб-версии.

Версия протокола пира (исправление)

  • Раньше device_profile_set и принятое сопряжение записывали чужому устройству собственную константу этой сборки, и отсечка по версии не работала.
  • Теперь версия берётся из отчёта самого устройства (profile_protocol_version):
    • профиль в hello и при сопряжении;
    • собственная запись отправителя в списке devices;
    • его собственный device_profile_set.
  • Пересланные профили версию только повышают (relayed_protocol_version).
  • Версия из запроса на сопряжение хранится в новой колонке.
  • Приглашения несут p, device_profile_set несёт protocol_version.
  • При первом запуске новой версии устройство объявляет её в журнале.

Протокол v4 и данные подкастов

  • PROTOCOL_VERSION = 4.
  • Подкастовые операции:
    • хранятся в журнале и пересылаются дальше;
    • применяются через PodcastStore::apply_remote_op. Невалидные пропускаются, но подтверждаются.
  • Операции, пришедшие до открытия хранилища, ждут в sync_podcast_pending и применяются, когда хранилище подключается.
  • Snapshot:
    • секции подкастов выгружаются через fill_snapshot;
    • размер ограничен лимитами FRID и бюджетом строки сообщения (podcast_snapshot_budget);
    • принимается через apply_snapshot после операций того же сообщения.
  • Обработчики синхронизации вызывают хранилище подкастов внутри block_in_place. Пока хранилище занято обновлением большой ленты, другие задачи этого воркера Tokio продолжают работать.
  • Периодические checkpoint схлопываются: в журнале остаётся последняя операция прогресса для каждой пары «источник, выпуск».
  • В отладочный журнал (вкладка Logs) подкастовые операции и команды воспроизведения с выпусками попадают только как вид и op_id, без URL лент и аудио.
  • После изменений с других устройств:
    • вкладка обновляет прогресс на месте и перечитывает список;
    • лента подписки, пришедшей с другого устройства, проверяется сразу.

Отсечка по версии пира

Пирам ниже v4 никогда не отправляются:

  • подкастовые операции (op_allowed_for_peer, фильтр в SQL);
  • секции подкастов в snapshot (SyncSnapshot::for_peer);
  • выпуски в состоянии воспроизведения (playback_allowed_for_peer).

Старое устройство всё равно получает snapshot воспроизведения с координацией, но каждый выпуск в очереди заменён непрозрачным «Private item» (redact_for_jam). Иначе его движок владения через 2 минуты тишины сам забирал воспроизведение, и очередь с выпусками пропадала. Это отступление от правила 1 PLAYBACK_PROTOCOL.md, см. «Решения и отступления». Выпуски из очереди никогда не вырезаются ради того, чтобы очередь «подошла» старому пиру.

Заглушки, которые старое устройство присылает обратно. Старое устройство зеркалит отредактированную очередь своими типами. В них нет PlaybackTrack::source, поэтому каждая заглушка становится обычным музыкальным треком «Private item» без content id и метаданных. Когда старое устройство перехватывает воспроизведение (Play на нём, take_paused_on_startup или автоматический failover, после того как это устройство ~2 минуты закрыто или офлайн) или присылает команду, оно объявляет эти треки своей очередью. Раньше TUI принимал их как неиграбельные музыкальные треки и рассылал всем пирам v4. Теперь состояния от пиров ниже v4 очищаются при приёме (drop_echoed_private_items): в snapshot и в командах SetState / ActiveChanged. Удаляются только «голые» музыкальные треки с заголовком «Private item»: без content id, федеративного источника, артистов, релиза и длительности. Позиция в очереди сдвигается. Если текущим был удалённый трек, текущим становится следующий, с начала. Сообщение в статусе называет устройство; для snapshot оно показывается только при изменении числа удалённых заглушек.

Перенос воспроизведения

  • PlaybackTrack.source = PodcastEpisode передаётся в обе стороны. Принятые элементы снова становятся выпусками (TrackItem::from_playback_track), и фильтр источника библиотеки их не отбрасывает.
  • Передача несёт выпуск, позицию, паузу, playback_rate = None и последнее известное поколение прогресса. Принимающее устройство играет выпуск даже без подписки.
  • Устройству ниже v4 очередь с выпусками не передаётся. Статус: «<устройство> needs a Furumi update to play podcast episodes…»; интерфейс TUI на английском, по смыслу «нужно обновление».
  • Команды SetState / ActiveChanged от такого устройства отклоняются, пока в очереди есть выпуски. Проверка идёт до движка владения.
  • Управляя устройством v4, можно ставить и запускать на нём выпуски. Выпуск, ставший текущим по команде другого устройства с позицией 0, продолжается с сохранённого места.
  • Перемотка с управляющего устройства — явное действие прогресса. Оно записывается, только если перемотка сработала.

Jam

  • Хост публикует снимок через redact_for_jam. Гости видят «Private item» без названия, ленты и URL.
  • Команды гостя, которые добавляют выпуски, отбрасываются.
  • Заглушки гостя сопоставляются обратно с выпусками хоста (restore_jam_private_items).
  • Изменения, которые удаляют, дублируют или добавляют приватные элементы, отклоняются. Перематывать приватный текущий элемент гостю нельзя.
  • Гость, выходя из Jam, удаляет заглушки из своей очереди.

Документация и версия

  • README:
    • приватность по умолчанию;
    • синхронизация только между доверенными устройствами;
    • аудио идёт от издателя;
    • перенос; старые устройства, включая перехват после ~2 минут отсутствия этого устройства и удаление присланных обратно заглушек; Jam;
    • обрыв соединения, поток без размера, отмена, перемотка.
  • ARCHITECTURE, AGENTS (инварианты: подкасты никогда не идентифицируются по числовому id; отсечка по версии; версия берётся только от самого устройства; старым пирам отправляется отредактированная координация; присланные ими обратно заглушки не принимаются), CHANGELOG.
  • furumi-tui 0.3.5 → 0.4.0.

Исправления по первому ревью (коммиты после a79f0a0)

  1. (high) Старый клиент забирал воспроизведение примерно через 2 минуты и терял выпуски. Пир v3 теперь получает координацию с отредактированной очередью. Тест: движок 0.3.x с конфигурацией по умолчанию в течение 3 × owner_timeout не перехватывает владение. Без исправления тест падает.
  2. (high) Обрыв потока полностью завершал выпуск. Теперь сохраняется последняя позиция, выпуск не отмечается прослушанным, очередь не двигается.
  3. (medium) Пауза во время подключения терялась. Теперь намерение читается в момент старта источника.
  4. (medium) После переноса базы прототипа сезоны не появлялись. Валидаторы прототипа сбрасываются.
  5. (low) Перемотка записывалась, даже если не сработала. Теперь она записывается только по подтверждению плеера; во время подключения и без Range отклоняется.
  6. (low) Вытесненная подготовка продолжала скачивание. Добавлена отмена по поколению плеера.
  7. (low) Застрявшее чтение блокировало аудиопоток до 30 с. Stop, Play и новый запуск освобождают его за ~100 мс.
  8. (low) Цепочка 301 → 302 не переносила ленту.
  9. (low) Хранилище вызывалось на воркерах Tokio. Теперь через block_in_place; ARCHITECTURE исправлен.
  10. (low) URL с токенами попадали в журнал.
  11. (low) Лимиты не были покрыты тестами. Добавлены тесты и общий дедлайн загрузки.

Исправления по повторному ревью (коммиты после 96e615b)

  1. (medium, замечания 1 и 4) Старое устройство присылало заглушки обратно как музыку. После его перехвата или команды очередь v4 заполнялась неиграбельными треками «Private item», которые расходились по всем пирам v4. Теперь такие треки удаляются при приёме, а в статусе показывается сообщение. Документация больше не утверждает того, что не выполнялось, и описывает перехват через failover. Тест повторяет полный путь: отредактированная очередь разбирается точными типами 0.3.x, старое устройство публикует её заново как в 0.3.x и перехватывает владение с более высоким claim; ещё один сценарий — команда, собранная по устаревшему зеркалу очереди. Без исправления тест падает.
  2. (low, замечание 2) Сброс валидаторов прототипа выполнялся один раз и не был атомарным с импортом. Теперь есть маркер рядом с базой, и при сбое сброс повторяется. Импортированный счётчик ошибок (consecutive_failures) восстанавливается в прежнем значении.
  3. (low, замечания 3 и 5) Поток без размера, короче длительности из ленты, не завершался и останавливал очередь. Длительность из ленты теперь считается подсказкой (порог 80 %), строгое окно применяется только к длительности, измеренной декодером. Сообщение для потока без перемотки предлагает b или m. Тест: настоящий MP3 без заголовка Xing, отданный без Content-Length, длиной 100 с при длительности в ленте 120 с, завершается.

Клавиши в контексте podcasts

Клавиша Действие
Enter открыть / воспроизвести (продолжить)
b начать выпуск сначала
o добавить подкаст
/ поиск
Shift+R / Ctrl+R проверить подкаст / все
Shift+S сортировка
f фильтр
m прослушано / не прослушано
Shift+U (Shift+D) отписаться

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

  • Contract gap, MR-F1 (PLAYBACK_PROTOCOL.md, правило 1).
    • Правило требует, чтобы пиру ниже v4 при выпусках в очереди отправлялось None. Но движок music_dht::playback продлевает жизнь владельца только по его собственным объявлениям, поэтому старый клиент с automatic_failover перехватывает владение через owner_timeout_ms.
    • TUI отправляет такому пиру Snapshot { state: redact_for_jam(state), coordination: Some(..) }.
    • Клиент v3 отправляет заглушки обратно как музыку (у него нет source), и они попадают в очереди v4 после его перехвата или в его командах. TUI удаляет их при приёме от пиров ниже v4 (drop_echoed_private_items).
    • Предложение для FRID:
      • записать в правило 1 отправку отредактированной координации;
      • описать, как получатель v4 обрабатывает заглушки, которые прислал обратно пир ниже v4. Например, дать в music_dht::device_sync общую функцию с тем же критерием: source == None, title = PRIVATE_ITEM_TITLE, нет content id, fed, артистов, релиза и длительности;
      • применить то же в вебе. Пока веб следует правилу буквально, проблема перехвата остаётся для очередей, которыми владеет веб.
  • Contract gap, MR-F2 (импорт прототипа).
    • Импорт переносит etag / last_modified прототипа.
    • Предложение: записывать при импорте NULL в той же транзакции или отмечать fetch state как «нужна полная загрузка».
    • Обход в TUI не расходится с контрактом:
      • до открытия TUI читает user_version (только чтение, LEGACY_PROTOTYPE_SCHEMA_VERSION) и записывает маркер рядом с базой;
      • после миграции валидаторы очищаются публичным API: record_fetch_success с None при сохранении времени и следующей проверки, затем record_fetch_failure столько раз, сколько ошибок было у прототипа;
      • маркер удаляется только после обработки всех подкастов.
    • Fetch state локальный и не синхронизируется. Побочный эффект: у подкаста, импортированного с ошибкой, появляется время последнего успеха, равное последней проверке. Пока показывается ошибка, интерфейс это время не выводит.
  • Уточнение контракта F2 (FeedRefresh.fetched_from).
    • TUI передаёт цель начальных постоянных редиректов, а относительные адреса в документе разрешаются от URL, который его отдал. Документация поля говорит «URL, с которого документ отдан в итоге».
    • Предложение: описать поле как «постоянный адрес ленты» или добавить отдельное поле базового URL. apply_feed использует поле только для алиаса и fetch URL, поэтому поведение уже согласовано.
  • Поток без размера: длительность из ленты считается подсказкой, порог 80 % — эвристика TUI. Контракт FRID (reaches_completion) не меняется: он по-прежнему применяется к позиции во время воспроизведения и к длительности, измеренной декодером.
  • Поиск, фильтр и сортировка выпусков выполняются в хранилище FRID, а не в памяти.
  • Сеанс прослушивания записывается при паузе, завершении и окончании, а не каждые 20 с.
  • Snapshot подкастов применяется после операций того же сообщения; у музыки порядок прежний. Слиянию порядок не важен, а изменённый регистр прогресса доходит до интерфейса как запись и обновляется на месте.
  • Checkpoint схлопываются и при приёме, в том числе на пересылающих устройствах. Это безопасно: операции одного источника упорядочены по hlc, а их поколение не убывает.
  • Для listen_recorded нижняя граница — v2, как в вебе: каждый пир furumi/sync/2 хранит историю.
  • Jam: сверх контракта гость не может перематывать приватный текущий элемент. Заглушки в очереди гостя — локальные элементы с отдельными ключами; по сети они идут только как PlaybackSource::Private.
  • Сообщения на английском, как весь интерфейс TUI.
  • Предложения для FRID, не блокирующие:
    • хранить TrackItem.podcast в Box;
    • возвращать из PodcastStore::apply_snapshot изменённые записи, а не только счётчики;
    • разрешить отправлять секции snapshot подкастов реже, чем при каждом handshake.

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

  • Требуются music-dht 0.6.0 и furumi-library 0.3.0 (MR-F1, MR-F2). 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/store", а в Cargo.lock у frid-крейтов (включая federation-net) стоит source = "git+https://gt.hexor.cy/Sanapach/frid.git?branch=…#<sha>". Тесты на этом коммите: cargo test --all-targets --locked — 299 passed, 0 failed, 4 ignored. После публикации крейтов на crates.io эти строки удаляются, и lock перегенерируется ещё раз.
  • Протокол синхронизации — v4 при том же ALPN furumi/sync/2.
    • Клиенты v3 (furumi-tui 0.3.x, furumi-web 0.12.x) получают сообщения той же формы v3, без подкастовых операций и секций. Очередь с выпусками приходит к ним только отредактированной: «Private item» вместо выпусков, без названий и URL, с координацией. Заглушки, которые они присылают обратно, TUI v4 не принимает.
    • Поля p и protocol_version старые клиенты игнорируют.
    • То, что устройство пропустило, пока работало на v3, оно получит после обновления через snapshot.
  • Keymap — версия 2 (MR-T1). База прототипа переносится на месте; первая проверка импортированных лент безусловная, даже если первый запуск прервался.

Как проверено (macOS 26.5.2, Darwin 25.5.0, arm64, rustc 1.100.0)

cargo fmt --all -- --check        # OK
cargo check --all-targets         # OK, без предупреждений компилятора
cargo clippy --all-targets        # 22 диагностики; отсортированный список без повторов совпадает с базой podcasts/tab-order
                                  # (595c886), кроме размера в существующем large_enum_variant в state.rs: 528 → 784 байт (TrackItem, шаг 1)
cargo test --all-targets          # 299 passed, 0 failed, 4 ignored (на вершине c7e6a36)
  • На вершине c7e6a36 (CARGO_TARGET_DIR=…/.targets/tui-t2, frid podcasts/store @ d2530dc через [patch]): fmt — OK, check — OK, набор предупреждений clippy совпадает с прежней вершиной e0624ab (новых нет), тесты — 299 passed, 0 failed, 4 ignored. На e0624ab было 298 passed, полный прогон повторён ещё 3 раза — зелёный.
  • Новый тест c7e6a36 app::playback_bridge_tests::an_older_jam_guest_cannot_drop_the_hosts_episodes: гость Jam на Furumi 0.3 не видит данных выпусков, а его команды (эхо SetState с перемоткой и без неё), пока в очереди есть выпуски, отклоняются, и хост сохраняет выпуски. Тест закрывает пункт интероп-проверки «старый клиент v3 как гость Jam», который не прогонялся вживую. Очередь, которую видит старый гость, моделируется так, как её разбирают типы 0.3 (без source; доказано wire_compat_tests::v3_peers_would_drop_the_source_of_podcast_items). Тест прошёл без изменения кода.
  • Пропущены (ignored): localhost_web_peer (нужен scripts/test_device_interop.py и репозиторий веба), onnx_model_smoke и два ручных бенчмарка.
  • При сборке тестов линкер macOS выводит замечание __eh_frame section too large. Оно появилось на шаге 1 и не относится к предупреждениям кода.
  • Тесты используют локальный HTTP-сервер на 127.0.0.1, временные каталоги, in-memory SQLite и iroh-узлы внутри процесса. Каталоги пользователя и аудиоустройство не используются. Трафик между тестовыми узлами идёт по loopback, но узлы строятся с preset n0 и могут обращаться к relay и DNS n0. Локального режима транспорта нет, это follow-up federation-net 0.4.

Проверено автоматически (TUI ↔ TUI, внутри процесса):

  • Подписка на A появляется на B без ввода URL, и B ставит ленту на проверку. Повторная доставка не создаёт дублей и событий. Тесты: podcast_sync_tests; localhost_devices_sync_podcasts — по настоящим iroh-потокам через sync_device → handle_hello.
  • Прогресс с A продолжается на B после перезапуска B (файловое хранилище): позицию отдаёт playback::resolve(StartAt::Resume). Checkpoint схлопываются в журнале.
  • «Начать сначала» на B побеждает поздний checkpoint A при доставке в любом порядке; после этого A перестаёт писать checkpoint (Superseded). Через сеть тоже.
  • Отписка сохраняет прогресс на обоих устройствах. Повторная подписка на B переиспользует ID и продолжает с того же места.
  • Операции, пришедшие до открытия хранилища, применяются, когда оно подключается. Пересылка через третье устройство работает.
  • Пир v3, смоделированный точными JSON-типами 0.3.x:
    • его hello разбирается, версия 3 сохраняется;
    • всё отправленное ему разбирается типами v3; подкастовых данных, названий и URL выпусков нет;
    • snapshot воспроизведения приходит с координацией и «Private item»;
    • движок 0.3.x с Config::default() за 3 × owner_timeout владение не перехватывает, а без объявлений перехватывает (an_old_device_keeps_hearing_from_a_podcast_queue_owner_and_never_fails_over);
    • очередь, которую он отзеркалил и объявил при перехвате, принимается без заглушек. Текущим становится следующий трек, в статусе есть сообщение, повторное объявление нового сообщения не вызывает. Команда, собранная по его устаревшему зеркалу, тоже очищается (placeholders_an_old_device_echoes_back_are_left_out, only_bare_music_items_from_old_devices_count_as_echoed_placeholders);
    • после обновления пир получает подписку и прогресс через snapshot.
  • Секции snapshot ужимаются под лимит строки; музыкальная часть не трогается.
  • Версии пиров: самоотчёт, пересылка, сопряжение, однократное объявление новой версии.
  • Перенос между устройствами v4: выпуск, URL, позиция, пауза, поколение. Передача устройству v3 отклоняется с понятной причиной. Его ActiveChanged игнорируется, пока в очереди есть выпуски, и проходит, когда их нет.
  • Смешанная очередь через wire сохраняет выпуски, позицию и паузу, в том числе в режиме «только локальная библиотека».
  • Jam:
    • в опубликованном снимке нет названий и URL;
    • у гостя нумерованные «Private item»;
    • выпуски восстанавливаются после перестановки;
    • удаление, добавление и дублирование отклоняются;
    • перемотка запрещена;
    • очередь гостя очищается при выходе;
    • сетевой Jam-тест: гость получает заглушку, команда с выпуском отбрасывается.
  • Шаги ревью:
    • обрыв (сервер перестаёт отдавать данные после 30 с из 120 с) не завершает выпуск: в хранилище InProgress на ~30 с, 0 завершённых прослушиваний;
    • поток без длины, закрытый раньше времени, не считается концом, если длительность измерил декодер или если пройдено меньше 80 % длительности из ленты;
    • MP3 без заголовка Xing, отданный без длины, на 100 с при длительности в ленте 120 с: декодер длительность не знает, выпуск завершается в своём конце (a_stream_shorter_than_the_feed_says_completes_at_its_end, a_stream_shorter_than_its_feed_duration_completes_at_its_end);
    • сообщение об обрыве для потока без перемотки предлагает b / m;
    • вытесненное продолжение на сервере без Range прекращает чтение быстрее, чем через STARVE_TIMEOUT/2;
    • заблокированное чтение возвращается после отмены, поток загрузки завершается;
    • решение finish и отказ в перемотке;
    • намерение паузы на уровне Controller;
    • валидаторы прототипа: сервер отвечает 304 на ETag прототипа, а после исправления появляется Season 1;
    • запуск, прерванный между миграцией и сбросом, доделывает сброс при следующем запуске; счётчик ошибок сохраняется; более поздние валидаторы не трогаются (dropping_prototype_validators_resumes_after_an_interrupted_start);
    • цепочка 301 → 302;
    • лента больше лимита с длиной и без неё, 11 редиректов, цикл, ftp://, зависший сервер, обложки;
    • в отладочном журнале нет URL с токеном;
    • block_in_place не держит единственный воркер.
  • Тесты шагов 1–2: хранилище и миграция, RSS (304, 301/302, ошибки и паузы), Range, отсутствие Range, обрыв, устаревший URL, упорядочение прогресса, интерфейс.

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

  • Как furumi-web 0.12.x отзеркаливает заглушки, на практике не проверялось. В межклиентском прогоне веб 0.12.4 был в группе с новым TUI: подкастовых данных не получил, перенос на него отклонён, но перехват им очереди с выпусками не моделировался. Критерий удаления рассчитан на то, что веб 0.12.x, как TUI 0.3.x, сохраняет только заголовок. scripts/test_device_interop.py не запускался (его заменил харнесс, см. ниже).
  • Человек TUI вручную не запускал, на слух звук не проверялся. В межклиентском прогоне TUI ↔ TUI аудио декодировалось rodio в тихий выход харнесса в реальном времени. В прогоне TUI ↔ веб реальный бинарник играл на системное устройство с громкостью 0. Перемотка, перенос и завершение проверены по позиции движка. Склейка в app/mod.rs (обработчики TrackFinished и Seeked, переход к следующему треку после Finished::Completed) автотестом в репозитории не покрыта, её косвенно проверили сценарии 2–3 межклиентского прогона.
  • Межклиентский прогон шёл на вершине стека (TUI 0.5.0, MR-T3), а не на вершине этой ветки отдельно.
  • Linux и Windows.

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

Окружение. macOS (Darwin 25.5, arm64), 20.11.2026, вершина всего стека:

  • TUI 0.5.0 — furumi-tui podcasts/discovery @ 409188b, включает этот MR;
  • веб 0.15.0 — furumi-web podcasts/discovery @ 0e985b4;
  • frid podcasts/discovery @ 9c82f6d через локальный [patch];
  • старые клиенты — выпущенные TUI 0.3.5 (federation @ 292f17f) и веб 0.12.4 (master @ 9b92385), собранные из git archive.

Каждый экземпляр — отдельный процесс со своим HOME и каталогами данных. Ленты и аудио отдают только локальные HTTP-серверы на 127.0.0.1 (с Range, без Range с длиной и без Range и длины). PostgreSQL — одноразовый postgres:16-alpine, браузер — headless Chrome через CDP. Узлы iroh используют стандартный preset n0 (relay и DNS n0) и Mainline-DHT для встречи, со случайным id сети на прогон: локального режима транспорта нет (follow-up federation-net 0.4).

Харнессы остаются вне репозиториев: они не герметичны, а TUI ↔ TUI работает с копией исходников (headless-запуск app::run, тихий аудиовыход). Логи, снимки экранов и results.json прогонов хранятся у автора и могут быть приложены по запросу.

Итог: TUI ↔ TUI — 23 проверки из 23 прошли; TUI ↔ веб — 37 pass, 3 info, 2 not run, 0 fail.

Сценарий Клиенты Результат
0. Сопряжение A+B, оба на sync v4 TUI A, B pass
1a–d. Подписка на A появляется на B без ввода URL (через 2 с); «прослушано» и прогресс A видны на B; отписка на A сохраняет прогресс и историю на B; повторная подписка сохраняет прогресс TUI A, B pass
2a. A поставил выпуск на паузу на 34,1 с и вышел; B после перезапуска продолжает с 34 130 мс TUI A, B pass
2b. «Начать сначала» на B побеждает поздний офлайн-checkpoint A: после переподключения оба на 4115 мс, поколение 3 TUI A, B pass
3a. Перенос очереди с выпуском, сервер с Range: тот же выпуск с 16,4 с, перемотка работает, A становится пультом TUI A, B pass
3b. Без Range, с Content-Length: перемотка вперёд дочитыванием, перенос B → A на 43,3 с TUI A, B pass
3c. Без Range и без длины: перемотка отклоняется с сообщением; перенос на 0:13 не стартует и сохраняет позицию («start over») TUI A, B pass
4a–d. Старый TUI 0.3.5 в группе A: сопряжение (sync v3), в данных C нет ни строки подкастов; плейлисты синхронизируются; перенос на C отклонён «needs a Furumi update»; очистка очереди с C не трогает выпуски A TUI A, B + TUI 0.3.5 C pass
5. Jam: хост A с выпуском в очереди, гость D вне группы видит только «Private item»; в 13 снимках D нет названий, URL и id TUI A (хост), TUI D pass
8. Реальные бинарники: вкладка Podcasts в 0.5.0 показывает подписки; 0.3.5 запускается без неё TUI 0.5.0, TUI 0.3.5 pass
S1. Подписки в одной группе TUI + веб-аккаунт: подписка, checkpoint, отписка и повторная подписка в обе стороны с тем же podcast_id; второй веб-аккаунт ничего не видит TUI 0.5.0 + веб 0.15.0 pass
S2. Прогресс: «прослушано» и checkpoint из веба доходят до TUI; «Начать сначала» в TUI побеждает поздний checkpoint веба; TUI продолжает с позиции веба (309 с) TUI 0.5.0 + веб 0.15.0 pass
S3. Перенос веб ↔ TUI с выпуском: позиция, очередь и пауза сохраняются; источник без Range; восстановление после перезапуска веба TUI 0.5.0 + headless Chrome на веб 0.15.0 pass
S3. Воспроизведение через прокси веба с локального издателя — not run: SSRF-защита веба по замыслу отвергает 127.0.0.1 (502); путь данных прокси покрыт src/podcasts/proxy_tests.rs
S4. Старые пиры: веб 0.12.4 в группе нового TUI и TUI 0.3.5 в группе нового веба — никаких подкастовых данных, плейлисты синхронизируются, перенос с выпуском отклонён «нужно обновление», отправитель продолжает играть TUI 0.5.0 + веб 0.12.4; веб 0.15.0 + TUI 0.3.5 pass
S5. Jam в вебе: гость видит четыре «Private item», в его ответах API нет данных выпусков веб 0.15.0, два аккаунта в браузере pass
S5. Jam с хостом-TUI и гостем-вебом — not run: веб не поддерживает федеративный Jam (capabilities.rs, without_protocol(JAM_ID)); это отсутствующая функция, не дефект
Старый клиент v3 как гость Jam — вживую не прогонялся; герметичный тест an_older_jam_guest_cannot_drop_the_hosts_episodes (c7e6a36)
Гость Jam не может перематывать приватный выпуск хоста — вживую не прогонялся; покрыт jam_guests_see_placeholders_and_their_commands_keep_the_hosts_episodes
Старое устройство само забирает воспроизведение (failover) — вживую не прогонялся; покрыт an_old_device_keeps_hearing_from_a_podcast_queue_owner_and_never_fails_over и a_podcast_queue_is_not_handed_to_or_replaced_by_a_v3_device

Обход харнесса TUI ↔ веб: веб не загружает ленты с 127.0.0.1 (SSRF-защита), поэтому каталог выпусков, который разобрал TUI, копируется в furumusic__podcast_episode SQL-запросом. Подписки, регистры и операции идут только через настоящие API и настоящий device sync.

Замечания, не связанные с этим MR: на вебе исчезнувшее браузерное устройство остаётся «активным» (старое поведение хаба устройств, не из этой серии).

Ограничения

  • Не сделано: «Поделиться» и публичный поиск подкастов (MR-T3), поэтому критерии §11 про стороннего участника C и публикацию в этом MR не закрыты.

  • Старое устройство (протокол ниже v4) всё ещё становится владельцем в трёх случаях:

    • его явно выбирают выходом (Play на нём);
    • оно запускается, пока это устройство на паузе (take_paused_on_startup);
    • это устройство ~2 минуты закрыто, спит или офлайн (автоматический failover).

    Тогда старое устройство играет свою копию очереди, где вместо каждого выпуска стоит неиграбельный «Private item». Само оно эти треки пропустить не умеет, а это устройство показывает его очередь без них и с сообщением в статусе. Выпуски из очереди пропадают, сохранённые позиции остаются. Автоматический перехват при работающем владельце v4 устранён, но только на стороне TUI (см. contract gap).

  • Удаление заглушек при приёме опирается на эвристику. Музыкальный трек ровно с заголовком «Private item», без артиста, релиза, длительности и content id, полученный от устройства ниже v4, будет удалён. Реальный трек с такими пустыми метаданными маловероятен.

  • Jam-хост на 0.3.x, который получил такие заглушки, раздаст их гостям v4 как музыку: состояние Jam не несёт версии хоста.

  • Поток без размера, у которого длительность известна только из ленты и которая завышена больше чем на 20 %, всё ещё считается оборванным в своём настоящем конце. Перемотки на таком сервере нет, поэтому сообщение предлагает начать сначала (b) или отметить прослушанным (m). Поток без размера с недостоверной длительностью из заголовка (например, потоковый WAV с длиной 0xFFFFFFFF) завершается только в строгом окне этой длительности.

  • Если поток стоит без данных, будет тишина до 30 с, затем воспроизведение останавливается на сохранённой позиции. Перемотка во время такого простоя держит поток команд плеера до этих 30 с: пауза ждёт, а Stop, Next или другой запуск освобождают его сразу. При 4xx посреди выпуска автоматического обновления ленты и перезапуска нет; Play запускает выпуск снова, и устаревший URL при этом проверяется по ленте.

  • «Начать сначала» с управляющего устройства для выпуска, который ещё не текущий, продолжает с сохранённого места. Для текущего выпуска работает (перемотка на 0).

  • Секции snapshot подкастов строятся и отправляются при каждой синхронизации (каждые 2 с на пира), до 4 МиБ. Записи, срезанные лимитом, доходят только через неподтверждённые операции.

  • Гости Jam на 0.3.x / web 0.12.x не могут управлять хостом, пока в его очереди есть выпуски: их команды теряют source и отклоняются.

  • Скорость воспроизведения не поддерживается. Retry-After поддерживается только в секундах.

  • Проверено только на macOS.

Зависимости

Stacked MR поверх MR-T1 (podcasts/tab-order). Ветка Sanapach/furumi-tui:podcasts/tui → Furumi/furumi-tui:podcasts/tab-order, если эта ветка-основание есть в Furumi/furumi-tui. Иначе MR открывается в federation: он зависит от MR-T1, и его diff включает пять коммитов MR-T1.

Требует MR-F1 и MR-F2 (frid podcasts/contract, podcasts/store; через [patch], см. «Совместимость и версии»). Решения FRID по трём пунктам выше не блокируют merge, это предложения: правило 1 PLAYBACK_PROTOCOL.md вместе с обработкой заглушек, которые присылают обратно пиры ниже v4; валидаторы при импорте прототипа; описание FeedRefresh.fetched_from. Веб (MR-W1/W2) с этим MR совместим: межклиентская проверка прошла. Отправку отредактированной координации старым пирам и удаление присланных ими заглушек веб пока не делает, это предложение для FRID и веба.

30 коммитов (git log --oneline podcasts/tab-order..podcasts/tui, вершина ea7cdc4). Последний — «Point frid deps at the fork branch» (ea7cdc4).

Коммиты шага 1:

  • bc04587 Bump music-dht to 0.6.0 and furumi-library to 0.3.0
  • 07dcd05 Fetch podcast feeds and stamp store actions from the sync log
  • 99c4d05 Replace the Podcasts placeholder with subscriptions, seasons and episodes
  • 043caf1 Document podcast subscriptions and their runtime boundaries
  • 7583afa Box large AppEvent payloads after TrackItem grew

Коммиты шага 2:

  • 3567f5f Key queue items by source and keep episodes out of music-only paths
  • 9321e82 Play podcast episodes from the queue and save their progress
  • 54db297 Document episode playback, queue identity and progress saving
  • 253583b Complete episodes after a seek into their last seconds

Коммиты шага 3:

  • e771326 Use the shared device-sync wire types
  • 4c3edbc Store peer protocol versions as the peers report them
  • 79372e0 Sync podcast state with devices on protocol v4
  • a92e12f Hand off podcast queues to v4 devices and keep episodes private in Jam
  • c6d7848 Document podcast sync between devices and release 0.4.0
  • a79f0a0 Save a seek from a controlling device as an explicit episode action

Коммиты исправлений по первому ревью:

  • 70df945 Keep podcast URLs out of the personal-sync debug log
  • 8d87fe3 Keep older devices hearing from a podcast queue owner
  • 2989747 Stop broken episode streams instead of completing them
  • 42f22f0 Document lost connections, cancellation and seeks of episodes
  • fe373e4 Parse imported prototype feeds on their first check
  • e0da2dd Move a feed to its permanent address behind a temporary redirect
  • 268ea91 Keep podcast store work in sync handlers off Tokio workers
  • 34c096a Bound a whole feed fetch and test the fetch limits
  • 96e615b Refuse an episode seek without leaving the effect early

Коммиты исправлений по повторному ревью:

  • 42ecc31 End a sizeless episode stream where it ends when only the feed knew its length
  • d03a330 Resume dropping prototype feed validators after an interrupted start
  • 2806e67 Leave out placeholders an older device echoes back as music
  • e0624ab Document what an older device's takeover does to a podcast queue

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

  • c7e6a36 Test that an older Jam guest cannot drop the host's episodes
  • ea7cdc4 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 и зависимости — в разделе зависимостей ниже. **Статус: все три шага MR-T2 сделаны. Исправлены 11 замечаний первого ревью и 5 замечаний повторного (это 3 разные проблемы). Межклиентская проверка TUI ↔ TUI и TUI ↔ веб пройдена в составе всего стека (см. «Межклиентская проверка»). По её итогам добавлен один тест (`c7e6a36`), код не менялся. MR готов к ревью.** Ниже указано, что проверено автоматически, что межклиентским прогоном и что не проверено. Публикация и поиск подкастов войдут в MR-T3. Поэтому сам по себе этот MR ещё не даёт законченной поддержки подкастов во всей экосистеме (§10 требований). ## Что сделано ### Шаг 1. Хранилище, RSS, вкладка Podcasts #### Зависимости - Новые версии: `music-dht = { version = "0.6.0", features = ["podcast-feed"] }`, `furumi-library = "0.3.0"`. - Новое поле `TrackItem.podcast` во всех музыкальных литералах равно `None`. - `TrackItem` стал больше, поэтому две полезные нагрузки `AppEvent` (`FedTrackInfoLoaded.result`, `FederationStatus`) теперь хранятся в `Box`. #### Хранилище - Используется общий `furumi_library::podcasts::PodcastStore` из FRID. Своей модели, ID и правил слияния в TUI нет. - Данные лежат в `podcasts.sqlite3` в каталоге данных платформы. База прототипа переносится на месте. - После переноса базы прототипа её HTTP-валидаторы (`ETag`, `Last-Modified`) сбрасываются, и первая проверка ленты загружает её целиком. Иначе сервер отвечал бы 304, и не появились бы сезоны, номера выпусков и новые ключи выпусков без GUID. Сброс можно повторить: до импорта рядом с базой записывается маркер `podcasts.sqlite3.full-check-pending`, и он удаляется только после обработки всех подкастов. Если запуск прервался между миграцией и сбросом, сброс выполнится при следующем запуске. Это обход contract gap в F2, см. «Решения и отступления». - Хранилище открывается в фоне. Если файл создан более новой версией Furumi или это чужой файл: - вкладка показывает причину; - файл не меняется; - остальное приложение работает. #### Загрузка и обновление RSS (`src/podcasts/`) - HTTP-клиент взят из прототипа: - условные запросы; - редиректы обрабатываются вручную: не больше 10, только http(s); - лента переезжает на адрес, к которому ведут начальные постоянные редиректы (301/308), даже если за ними следует временный (CDN, трекер). Цепочка, которая начинается с временного редиректа, ленту не переносит; - лимиты: 32 МиБ на ленту, 10 МиБ на обложку, 15 с на соединение, 60 с на запрос, **120 с на всю загрузку** вместе с редиректами; - User-Agent `furumi/<версия> (podcast reader)`; - в ошибках скрывается query URL. - Ленты разбирает общий парсер `music_dht::podcast::feed`, а записывает `PodcastStore::apply_feed`. Постоянный редирект или `itunes:new-feed-url` становится алиасом. - Подписка: - повторная подписка через алиас переиспользует ID и прогресс; - если по URL не лента, ничего не сохраняется; - новая подписка приватная. - Планировщик: - раз в минуту запрашивает ленты, которые пора проверить; - проверяет не больше 4 одновременно; - после успеха делает паузу 1 ч, после ошибки — от 5 мин до 24 ч, но не меньше `Retry-After`; - ошибка не очищает каталог; - можно вручную проверить одну ленту или все. - Хранилище и сеть работают вне UI-потока. #### Вкладка Podcasts - Список подписок со счётчиками, ошибками и боковой панелью. - Навигация: подкаст → сезоны → выпуски. - В строке выпуска: - `●`, `◐`, `✓`; - дата, `SxEy`, длительность. - Поиск, фильтр, сортировка. - «Прослушано / не прослушано». - Отписка с подтверждением. Прогресс и история при этом сохраняются. ### Шаг 2. Очередь, воспроизведение, долговечный прогресс - **Явный источник в очереди.** Выпуск — это `TrackItem::podcast_episode(PodcastEpisodeRef)`. - Числовой `id` у всех выпусков одинаковый (−1) и никогда не служит идентичностью. - Ключ очереди: `ep:<episode id>`, затем `content:`, `fed:`, `lib:<id>`. - Музыкальные пути пропускают выпуски: лайки, плейлисты, история, content id, федерация, похожие треки, `frid://`, редактирование. - `Shift+J` открывает подкаст. - **Воспроизведение** (`src/podcasts/stream.rs`, `playback.rs`, плеер): - поток идёт с сервера издателя через HTTP Range reader из прототипа. Окно: 8 МиБ вперёд, 1 МиБ назад и 256 КиБ начала файла. При обрыве соединение повторяется; если 30 с нет данных, чтение прекращается; - ничего не скачивается заранее; - URL и позиция берутся из хранилища в момент запуска; - если сервер ответил 4xx, лента проверяется один раз и запуск повторяется; - если перемотать нельзя, выпуск не стартует с неверного места; - `PlaySource` несёт поколение источника, поэтому запоздавший поток отбрасывается; - **отмена устаревших запусков.** Новый запуск или остановка отменяет поток предыдущего: подключение, дочитывание до позиции продолжения на сервере без Range и чтение, которое ждёт данных в аудиоколбэке. Всё это завершается в пределах 100 мс. Конец вытесненного источника плеер не считает окончанием трека; - **обрыв не завершает выпуск.** Поток запоминает, закончился ли он ошибкой чтения и сообщил ли сервер размер файла (`StreamProbe`). Выпуск завершается и очередь идёт дальше, только если поток дошёл до описанного сервером конца или оборвался уже в окне завершения (`playback::played_to_the_end`). Иначе сохраняется последняя позиция, воспроизведение останавливается на этом выпуске и показывается сообщение; - **поток без размера** (сервер не прислал Content-Length). Здесь закрытое соединение выглядит как конец файла, поэтому позиция сравнивается с длительностью. Если длительность измерил декодер (заголовок файла), действует строгое окно завершения. Если её знает только лента (`itunes:duration`, часто неточная), концом считается чистое закрытие после 80 % этой длительности. Если длительности нет вообще, концом считается само закрытие. Признак `duration_measured` передаётся от `open_at` до решения о завершении. На таком сервере нельзя перематывать, поэтому для прерванного выпуска сообщение предлагает начать сначала (`b`) или отметить прослушанным (`m`), а не «нажмите Play»; - **пауза во время подключения сохраняется.** Пауза и продолжение, нажатые, пока выпуск подключается, применяются при старте источника (`Controller::expect_source`); - **перемотка подтверждается плеером.** Аудиопоток сообщает результат (`PlayerEvent::Seeked`), и в прогресс записывается только перемотка, которая сработала. Перемотка во время подключения или в потоке без известного размера отклоняется с сообщением, в том числе по команде управляющего устройства. - **Прогресс** (`src/podcasts/progress.rs`): один фоновый поток по порядку записывает все действия через журнал синхронизации. - Действия контракта: `start_session` / `restart`, checkpoint каждые 20 с, `seek`, `complete_session`. - Прогресс сохраняется на паузе, при остановке, смене трека, передаче и выходе. - Если хранилище знает более новое поколение, checkpoint больше не пишутся. - **Интерфейс:** - `Enter` — воспроизвести или продолжить; - `b` — начать сначала; - `a` / `Shift+A` — добавить в очередь; - у играющего выпуска `▶` и текущая позиция. ### Шаг 3. Синхронизация устройств v4, перенос воспроизведения, Jam #### Общие wire-типы - Приватных копий wire-типов в `src/devices.rs` больше нет. Используются типы из `music_dht::device_sync`: - `InviteWire`, `DeviceProfileWire`; - `SyncOpWire` / `SyncOpPayload`, `SyncSnapshot`; - `Playback*`, `WireMessage`; - общие функции ввода-вывода и приглашений. - Golden-тесты (`src/devices/wire_compat_tests.rs`): - хранят дословные типы furumi-tui 0.3.x, сверенные с базовой веткой поле за полем; - проверяют, что сообщения v3 сериализуются байт в байт так же. `fixtures/v3_hello.golden.json` совпадает с файлом веб-версии. #### Версия протокола пира (исправление) - Раньше `device_profile_set` и принятое сопряжение записывали чужому устройству **собственную** константу этой сборки, и отсечка по версии не работала. - Теперь версия берётся из отчёта самого устройства (`profile_protocol_version`): - профиль в hello и при сопряжении; - собственная запись отправителя в списке `devices`; - его собственный `device_profile_set`. - Пересланные профили версию только повышают (`relayed_protocol_version`). - Версия из запроса на сопряжение хранится в новой колонке. - Приглашения несут `p`, `device_profile_set` несёт `protocol_version`. - При первом запуске новой версии устройство объявляет её в журнале. #### Протокол v4 и данные подкастов - `PROTOCOL_VERSION = 4`. - Подкастовые операции: - хранятся в журнале и пересылаются дальше; - применяются через `PodcastStore::apply_remote_op`. Невалидные пропускаются, но подтверждаются. - Операции, пришедшие до открытия хранилища, ждут в `sync_podcast_pending` и применяются, когда хранилище подключается. - Snapshot: - секции подкастов выгружаются через `fill_snapshot`; - размер ограничен лимитами FRID и бюджетом строки сообщения (`podcast_snapshot_budget`); - принимается через `apply_snapshot` после операций того же сообщения. - Обработчики синхронизации вызывают хранилище подкастов внутри `block_in_place`. Пока хранилище занято обновлением большой ленты, другие задачи этого воркера Tokio продолжают работать. - Периодические checkpoint схлопываются: в журнале остаётся последняя операция прогресса для каждой пары «источник, выпуск». - В отладочный журнал (вкладка Logs) подкастовые операции и команды воспроизведения с выпусками попадают только как вид и `op_id`, без URL лент и аудио. - После изменений с других устройств: - вкладка обновляет прогресс на месте и перечитывает список; - лента подписки, пришедшей с другого устройства, проверяется сразу. #### Отсечка по версии пира Пирам ниже v4 никогда не отправляются: - подкастовые операции (`op_allowed_for_peer`, фильтр в SQL); - секции подкастов в snapshot (`SyncSnapshot::for_peer`); - выпуски в состоянии воспроизведения (`playback_allowed_for_peer`). Старое устройство всё равно получает snapshot воспроизведения с координацией, но каждый выпуск в очереди заменён непрозрачным «Private item» (`redact_for_jam`). Иначе его движок владения через 2 минуты тишины сам забирал воспроизведение, и очередь с выпусками пропадала. Это отступление от правила 1 `PLAYBACK_PROTOCOL.md`, см. «Решения и отступления». Выпуски из очереди никогда не вырезаются ради того, чтобы очередь «подошла» старому пиру. **Заглушки, которые старое устройство присылает обратно.** Старое устройство зеркалит отредактированную очередь своими типами. В них нет `PlaybackTrack::source`, поэтому каждая заглушка становится обычным музыкальным треком «Private item» без content id и метаданных. Когда старое устройство перехватывает воспроизведение (Play на нём, `take_paused_on_startup` или автоматический failover, после того как это устройство ~2 минуты закрыто или офлайн) или присылает команду, оно объявляет эти треки своей очередью. Раньше TUI принимал их как неиграбельные музыкальные треки и рассылал всем пирам v4. Теперь состояния от пиров ниже v4 очищаются при приёме (`drop_echoed_private_items`): в snapshot и в командах `SetState` / `ActiveChanged`. Удаляются только «голые» музыкальные треки с заголовком «Private item»: без content id, федеративного источника, артистов, релиза и длительности. Позиция в очереди сдвигается. Если текущим был удалённый трек, текущим становится следующий, с начала. Сообщение в статусе называет устройство; для snapshot оно показывается только при изменении числа удалённых заглушек. #### Перенос воспроизведения - `PlaybackTrack.source = PodcastEpisode` передаётся в обе стороны. Принятые элементы снова становятся выпусками (`TrackItem::from_playback_track`), и фильтр источника библиотеки их не отбрасывает. - Передача несёт выпуск, позицию, паузу, `playback_rate = None` и последнее известное поколение прогресса. Принимающее устройство играет выпуск даже без подписки. - Устройству ниже v4 очередь с выпусками не передаётся. Статус: «<устройство> needs a Furumi update to play podcast episodes…»; интерфейс TUI на английском, по смыслу «нужно обновление». - Команды `SetState` / `ActiveChanged` от такого устройства отклоняются, пока в очереди есть выпуски. Проверка идёт до движка владения. - Управляя устройством v4, можно ставить и запускать на нём выпуски. Выпуск, ставший текущим по команде другого устройства с позицией 0, продолжается с сохранённого места. - Перемотка с управляющего устройства — явное действие прогресса. Оно записывается, только если перемотка сработала. #### Jam - Хост публикует снимок через `redact_for_jam`. Гости видят «Private item» без названия, ленты и URL. - Команды гостя, которые добавляют выпуски, отбрасываются. - Заглушки гостя сопоставляются обратно с выпусками хоста (`restore_jam_private_items`). - Изменения, которые удаляют, дублируют или добавляют приватные элементы, отклоняются. Перематывать приватный текущий элемент гостю нельзя. - Гость, выходя из Jam, удаляет заглушки из своей очереди. #### Документация и версия - README: - приватность по умолчанию; - синхронизация только между доверенными устройствами; - аудио идёт от издателя; - перенос; старые устройства, включая перехват после ~2 минут отсутствия этого устройства и удаление присланных обратно заглушек; Jam; - обрыв соединения, поток без размера, отмена, перемотка. - ARCHITECTURE, AGENTS (инварианты: подкасты никогда не идентифицируются по числовому id; отсечка по версии; версия берётся только от самого устройства; старым пирам отправляется отредактированная координация; присланные ими обратно заглушки не принимаются), CHANGELOG. - `furumi-tui` 0.3.5 → **0.4.0**. ### Исправления по первому ревью (коммиты после `a79f0a0`) 1. **(high) Старый клиент забирал воспроизведение примерно через 2 минуты и терял выпуски.** Пир v3 теперь получает координацию с отредактированной очередью. Тест: движок 0.3.x с конфигурацией по умолчанию в течение 3 × `owner_timeout` не перехватывает владение. Без исправления тест падает. 2. **(high) Обрыв потока полностью завершал выпуск.** Теперь сохраняется последняя позиция, выпуск не отмечается прослушанным, очередь не двигается. 3. **(medium) Пауза во время подключения терялась.** Теперь намерение читается в момент старта источника. 4. **(medium) После переноса базы прототипа сезоны не появлялись.** Валидаторы прототипа сбрасываются. 5. **(low) Перемотка записывалась, даже если не сработала.** Теперь она записывается только по подтверждению плеера; во время подключения и без Range отклоняется. 6. **(low) Вытесненная подготовка продолжала скачивание.** Добавлена отмена по поколению плеера. 7. **(low) Застрявшее чтение блокировало аудиопоток до 30 с.** Stop, Play и новый запуск освобождают его за ~100 мс. 8. **(low) Цепочка 301 → 302 не переносила ленту.** 9. **(low) Хранилище вызывалось на воркерах Tokio.** Теперь через `block_in_place`; ARCHITECTURE исправлен. 10. **(low) URL с токенами попадали в журнал.** 11. **(low) Лимиты не были покрыты тестами.** Добавлены тесты и общий дедлайн загрузки. ### Исправления по повторному ревью (коммиты после `96e615b`) 1. **(medium, замечания 1 и 4) Старое устройство присылало заглушки обратно как музыку.** После его перехвата или команды очередь v4 заполнялась неиграбельными треками «Private item», которые расходились по всем пирам v4. Теперь такие треки удаляются при приёме, а в статусе показывается сообщение. Документация больше не утверждает того, что не выполнялось, и описывает перехват через failover. Тест повторяет полный путь: отредактированная очередь разбирается точными типами 0.3.x, старое устройство публикует её заново как в 0.3.x и перехватывает владение с более высоким claim; ещё один сценарий — команда, собранная по устаревшему зеркалу очереди. Без исправления тест падает. 2. **(low, замечание 2) Сброс валидаторов прототипа выполнялся один раз и не был атомарным с импортом.** Теперь есть маркер рядом с базой, и при сбое сброс повторяется. Импортированный счётчик ошибок (`consecutive_failures`) восстанавливается в прежнем значении. 3. **(low, замечания 3 и 5) Поток без размера, короче длительности из ленты, не завершался и останавливал очередь.** Длительность из ленты теперь считается подсказкой (порог 80 %), строгое окно применяется только к длительности, измеренной декодером. Сообщение для потока без перемотки предлагает `b` или `m`. Тест: настоящий MP3 без заголовка Xing, отданный без Content-Length, длиной 100 с при длительности в ленте 120 с, завершается. ### Клавиши в контексте `podcasts` | Клавиша | Действие | | --- | --- | | `Enter` | открыть / воспроизвести (продолжить) | | `b` | начать выпуск сначала | | `o` | добавить подкаст | | `/` | поиск | | `Shift+R` / `Ctrl+R` | проверить подкаст / все | | `Shift+S` | сортировка | | `f` | фильтр | | `m` | прослушано / не прослушано | | `Shift+U` (`Shift+D`) | отписаться | ## Решения и отступления - **Contract gap, MR-F1 (`PLAYBACK_PROTOCOL.md`, правило 1).** - Правило требует, чтобы пиру ниже v4 при выпусках в очереди отправлялось `None`. Но движок `music_dht::playback` продлевает жизнь владельца только по его собственным объявлениям, поэтому старый клиент с `automatic_failover` перехватывает владение через `owner_timeout_ms`. - TUI отправляет такому пиру `Snapshot { state: redact_for_jam(state), coordination: Some(..) }`. - Клиент v3 отправляет заглушки обратно как музыку (у него нет `source`), и они попадают в очереди v4 после его перехвата или в его командах. TUI удаляет их при приёме от пиров ниже v4 (`drop_echoed_private_items`). - **Предложение для FRID:** - записать в правило 1 отправку отредактированной координации; - описать, как получатель v4 обрабатывает заглушки, которые прислал обратно пир ниже v4. Например, дать в `music_dht::device_sync` общую функцию с тем же критерием: `source == None`, title = `PRIVATE_ITEM_TITLE`, нет content id, fed, артистов, релиза и длительности; - применить то же в вебе. Пока веб следует правилу буквально, проблема перехвата остаётся для очередей, которыми владеет веб. - **Contract gap, MR-F2 (импорт прототипа).** - Импорт переносит `etag` / `last_modified` прототипа. - **Предложение:** записывать при импорте `NULL` в той же транзакции или отмечать fetch state как «нужна полная загрузка». - Обход в TUI не расходится с контрактом: - до открытия TUI читает `user_version` (только чтение, `LEGACY_PROTOTYPE_SCHEMA_VERSION`) и записывает маркер рядом с базой; - после миграции валидаторы очищаются публичным API: `record_fetch_success` с `None` при сохранении времени и следующей проверки, затем `record_fetch_failure` столько раз, сколько ошибок было у прототипа; - маркер удаляется только после обработки всех подкастов. - Fetch state локальный и не синхронизируется. Побочный эффект: у подкаста, импортированного с ошибкой, появляется время последнего успеха, равное последней проверке. Пока показывается ошибка, интерфейс это время не выводит. - **Уточнение контракта F2 (`FeedRefresh.fetched_from`).** - TUI передаёт цель начальных постоянных редиректов, а относительные адреса в документе разрешаются от URL, который его отдал. Документация поля говорит «URL, с которого документ отдан в итоге». - **Предложение:** описать поле как «постоянный адрес ленты» или добавить отдельное поле базового URL. `apply_feed` использует поле только для алиаса и fetch URL, поэтому поведение уже согласовано. - Поток без размера: длительность из ленты считается подсказкой, порог 80 % — эвристика TUI. Контракт FRID (`reaches_completion`) не меняется: он по-прежнему применяется к позиции во время воспроизведения и к длительности, измеренной декодером. - Поиск, фильтр и сортировка выпусков выполняются в хранилище FRID, а не в памяти. - Сеанс прослушивания записывается при паузе, завершении и окончании, а не каждые 20 с. - Snapshot подкастов применяется **после** операций того же сообщения; у музыки порядок прежний. Слиянию порядок не важен, а изменённый регистр прогресса доходит до интерфейса как запись и обновляется на месте. - Checkpoint схлопываются и при приёме, в том числе на пересылающих устройствах. Это безопасно: операции одного источника упорядочены по hlc, а их поколение не убывает. - Для `listen_recorded` нижняя граница — v2, как в вебе: каждый пир `furumi/sync/2` хранит историю. - Jam: сверх контракта гость не может перематывать приватный текущий элемент. Заглушки в очереди гостя — локальные элементы с отдельными ключами; по сети они идут только как `PlaybackSource::Private`. - Сообщения на английском, как весь интерфейс TUI. - Предложения для FRID, не блокирующие: - хранить `TrackItem.podcast` в `Box`; - возвращать из `PodcastStore::apply_snapshot` изменённые записи, а не только счётчики; - разрешить отправлять секции snapshot подкастов реже, чем при каждом handshake. ## Совместимость и версии - Требуются `music-dht 0.6.0` и `furumi-library 0.3.0` (MR-F1, MR-F2). **`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/store"`, а в `Cargo.lock` у frid-крейтов (включая `federation-net`) стоит `source = "git+https://gt.hexor.cy/Sanapach/frid.git?branch=…#<sha>"`. Тесты на этом коммите: `cargo test --all-targets --locked` — 299 passed, 0 failed, 4 ignored. После публикации крейтов на crates.io эти строки удаляются, и lock перегенерируется ещё раз. - Протокол синхронизации — v4 при том же ALPN `furumi/sync/2`. - Клиенты v3 (furumi-tui 0.3.x, furumi-web 0.12.x) получают сообщения той же формы v3, без подкастовых операций и секций. Очередь с выпусками приходит к ним только отредактированной: «Private item» вместо выпусков, без названий и URL, с координацией. Заглушки, которые они присылают обратно, TUI v4 не принимает. - Поля `p` и `protocol_version` старые клиенты игнорируют. - То, что устройство пропустило, пока работало на v3, оно получит после обновления через snapshot. - Keymap — версия 2 (MR-T1). База прототипа переносится на месте; первая проверка импортированных лент безусловная, даже если первый запуск прервался. ## Как проверено (macOS 26.5.2, Darwin 25.5.0, arm64, rustc 1.100.0) ``` cargo fmt --all -- --check # OK cargo check --all-targets # OK, без предупреждений компилятора cargo clippy --all-targets # 22 диагностики; отсортированный список без повторов совпадает с базой podcasts/tab-order # (595c886), кроме размера в существующем large_enum_variant в state.rs: 528 → 784 байт (TrackItem, шаг 1) cargo test --all-targets # 299 passed, 0 failed, 4 ignored (на вершине c7e6a36) ``` - На вершине `c7e6a36` (`CARGO_TARGET_DIR=…/.targets/tui-t2`, frid `podcasts/store` @ `d2530dc` через `[patch]`): fmt — OK, check — OK, набор предупреждений clippy совпадает с прежней вершиной `e0624ab` (новых нет), тесты — 299 passed, 0 failed, 4 ignored. На `e0624ab` было 298 passed, полный прогон повторён ещё 3 раза — зелёный. - Новый тест `c7e6a36` `app::playback_bridge_tests::an_older_jam_guest_cannot_drop_the_hosts_episodes`: гость Jam на Furumi 0.3 не видит данных выпусков, а его команды (эхо `SetState` с перемоткой и без неё), пока в очереди есть выпуски, отклоняются, и хост сохраняет выпуски. Тест закрывает пункт интероп-проверки «старый клиент v3 как гость Jam», который не прогонялся вживую. Очередь, которую видит старый гость, моделируется так, как её разбирают типы 0.3 (без `source`; доказано `wire_compat_tests::v3_peers_would_drop_the_source_of_podcast_items`). Тест прошёл без изменения кода. - Пропущены (ignored): `localhost_web_peer` (нужен `scripts/test_device_interop.py` и репозиторий веба), `onnx_model_smoke` и два ручных бенчмарка. - При сборке тестов линкер macOS выводит замечание `__eh_frame section too large`. Оно появилось на шаге 1 и не относится к предупреждениям кода. - Тесты используют локальный HTTP-сервер на 127.0.0.1, временные каталоги, in-memory SQLite и iroh-узлы внутри процесса. Каталоги пользователя и аудиоустройство не используются. Трафик между тестовыми узлами идёт по loopback, но узлы строятся с preset n0 и могут обращаться к relay и DNS n0. Локального режима транспорта нет, это follow-up `federation-net 0.4`. **Проверено автоматически (TUI ↔ TUI, внутри процесса):** - Подписка на A появляется на B без ввода URL, и B ставит ленту на проверку. Повторная доставка не создаёт дублей и событий. Тесты: `podcast_sync_tests`; `localhost_devices_sync_podcasts` — по настоящим iroh-потокам через `sync_device` → `handle_hello`. - Прогресс с A продолжается на B после перезапуска B (файловое хранилище): позицию отдаёт `playback::resolve(StartAt::Resume)`. Checkpoint схлопываются в журнале. - «Начать сначала» на B побеждает поздний checkpoint A при доставке в любом порядке; после этого A перестаёт писать checkpoint (`Superseded`). Через сеть тоже. - Отписка сохраняет прогресс на обоих устройствах. Повторная подписка на B переиспользует ID и продолжает с того же места. - Операции, пришедшие до открытия хранилища, применяются, когда оно подключается. Пересылка через третье устройство работает. - Пир v3, смоделированный точными JSON-типами 0.3.x: - его hello разбирается, версия 3 сохраняется; - всё отправленное ему разбирается типами v3; подкастовых данных, названий и URL выпусков нет; - snapshot воспроизведения приходит с координацией и «Private item»; - **движок 0.3.x с `Config::default()` за 3 × `owner_timeout` владение не перехватывает**, а без объявлений перехватывает (`an_old_device_keeps_hearing_from_a_podcast_queue_owner_and_never_fails_over`); - **очередь, которую он отзеркалил и объявил при перехвате, принимается без заглушек.** Текущим становится следующий трек, в статусе есть сообщение, повторное объявление нового сообщения не вызывает. Команда, собранная по его устаревшему зеркалу, тоже очищается (`placeholders_an_old_device_echoes_back_are_left_out`, `only_bare_music_items_from_old_devices_count_as_echoed_placeholders`); - после обновления пир получает подписку и прогресс через snapshot. - Секции snapshot ужимаются под лимит строки; музыкальная часть не трогается. - Версии пиров: самоотчёт, пересылка, сопряжение, однократное объявление новой версии. - Перенос между устройствами v4: выпуск, URL, позиция, пауза, поколение. Передача устройству v3 отклоняется с понятной причиной. Его `ActiveChanged` игнорируется, пока в очереди есть выпуски, и проходит, когда их нет. - Смешанная очередь через wire сохраняет выпуски, позицию и паузу, в том числе в режиме «только локальная библиотека». - Jam: - в опубликованном снимке нет названий и URL; - у гостя нумерованные «Private item»; - выпуски восстанавливаются после перестановки; - удаление, добавление и дублирование отклоняются; - перемотка запрещена; - очередь гостя очищается при выходе; - сетевой Jam-тест: гость получает заглушку, команда с выпуском отбрасывается. - Шаги ревью: - обрыв (сервер перестаёт отдавать данные после 30 с из 120 с) не завершает выпуск: в хранилище `InProgress` на ~30 с, 0 завершённых прослушиваний; - поток без длины, закрытый раньше времени, не считается концом, если длительность измерил декодер или если пройдено меньше 80 % длительности из ленты; - MP3 без заголовка Xing, отданный без длины, на 100 с при длительности в ленте 120 с: декодер длительность не знает, выпуск завершается в своём конце (`a_stream_shorter_than_the_feed_says_completes_at_its_end`, `a_stream_shorter_than_its_feed_duration_completes_at_its_end`); - сообщение об обрыве для потока без перемотки предлагает `b` / `m`; - вытесненное продолжение на сервере без Range прекращает чтение быстрее, чем через `STARVE_TIMEOUT`/2; - заблокированное чтение возвращается после отмены, поток загрузки завершается; - решение `finish` и отказ в перемотке; - намерение паузы на уровне `Controller`; - валидаторы прототипа: сервер отвечает 304 на ETag прототипа, а после исправления появляется Season 1; - запуск, прерванный между миграцией и сбросом, доделывает сброс при следующем запуске; счётчик ошибок сохраняется; более поздние валидаторы не трогаются (`dropping_prototype_validators_resumes_after_an_interrupted_start`); - цепочка 301 → 302; - лента больше лимита с длиной и без неё, 11 редиректов, цикл, `ftp://`, зависший сервер, обложки; - в отладочном журнале нет URL с токеном; - `block_in_place` не держит единственный воркер. - Тесты шагов 1–2: хранилище и миграция, RSS (304, 301/302, ошибки и паузы), Range, отсутствие Range, обрыв, устаревший URL, упорядочение прогресса, интерфейс. **Не проверено:** - Как furumi-web 0.12.x отзеркаливает заглушки, на практике не проверялось. В межклиентском прогоне веб 0.12.4 был в группе с новым TUI: подкастовых данных не получил, перенос на него отклонён, но перехват им очереди с выпусками не моделировался. Критерий удаления рассчитан на то, что веб 0.12.x, как TUI 0.3.x, сохраняет только заголовок. `scripts/test_device_interop.py` не запускался (его заменил харнесс, см. ниже). - Человек TUI вручную не запускал, на слух звук не проверялся. В межклиентском прогоне TUI ↔ TUI аудио декодировалось rodio в тихий выход харнесса в реальном времени. В прогоне TUI ↔ веб реальный бинарник играл на системное устройство с громкостью 0. Перемотка, перенос и завершение проверены по позиции движка. Склейка в `app/mod.rs` (обработчики `TrackFinished` и `Seeked`, переход к следующему треку после `Finished::Completed`) автотестом в репозитории не покрыта, её косвенно проверили сценарии 2–3 межклиентского прогона. - Межклиентский прогон шёл на вершине стека (TUI 0.5.0, MR-T3), а не на вершине этой ветки отдельно. - Linux и Windows. ## Межклиентская проверка **Окружение.** macOS (Darwin 25.5, arm64), 20.11.2026, вершина всего стека: - TUI 0.5.0 — `furumi-tui` `podcasts/discovery` @ `409188b`, включает этот MR; - веб 0.15.0 — `furumi-web` `podcasts/discovery` @ `0e985b4`; - frid `podcasts/discovery` @ `9c82f6d` через локальный `[patch]`; - старые клиенты — выпущенные TUI 0.3.5 (`federation` @ `292f17f`) и веб 0.12.4 (`master` @ `9b92385`), собранные из `git archive`. Каждый экземпляр — отдельный процесс со своим HOME и каталогами данных. Ленты и аудио отдают только локальные HTTP-серверы на 127.0.0.1 (с Range, без Range с длиной и без Range и длины). PostgreSQL — одноразовый `postgres:16-alpine`, браузер — headless Chrome через CDP. Узлы iroh используют стандартный preset n0 (relay и DNS n0) и Mainline-DHT для встречи, со случайным id сети на прогон: локального режима транспорта нет (follow-up federation-net 0.4). Харнессы остаются вне репозиториев: они не герметичны, а TUI ↔ TUI работает с копией исходников (headless-запуск `app::run`, тихий аудиовыход). Логи, снимки экранов и `results.json` прогонов хранятся у автора и могут быть приложены по запросу. **Итог:** TUI ↔ TUI — 23 проверки из 23 прошли; TUI ↔ веб — 37 pass, 3 info, 2 not run, 0 fail. | Сценарий | Клиенты | Результат | | --- | --- | --- | | 0. Сопряжение A+B, оба на sync v4 | TUI A, B | pass | | 1a–d. Подписка на A появляется на B без ввода URL (через 2 с); «прослушано» и прогресс A видны на B; отписка на A сохраняет прогресс и историю на B; повторная подписка сохраняет прогресс | TUI A, B | pass | | 2a. A поставил выпуск на паузу на 34,1 с и вышел; B после перезапуска продолжает с 34 130 мс | TUI A, B | pass | | 2b. «Начать сначала» на B побеждает поздний офлайн-checkpoint A: после переподключения оба на 4115 мс, поколение 3 | TUI A, B | pass | | 3a. Перенос очереди с выпуском, сервер с Range: тот же выпуск с 16,4 с, перемотка работает, A становится пультом | TUI A, B | pass | | 3b. Без Range, с Content-Length: перемотка вперёд дочитыванием, перенос B → A на 43,3 с | TUI A, B | pass | | 3c. Без Range и без длины: перемотка отклоняется с сообщением; перенос на 0:13 не стартует и сохраняет позицию («start over») | TUI A, B | pass | | 4a–d. Старый TUI 0.3.5 в группе A: сопряжение (sync v3), в данных C нет ни строки подкастов; плейлисты синхронизируются; перенос на C отклонён «needs a Furumi update»; очистка очереди с C не трогает выпуски A | TUI A, B + TUI 0.3.5 C | pass | | 5. Jam: хост A с выпуском в очереди, гость D вне группы видит только «Private item»; в 13 снимках D нет названий, URL и id | TUI A (хост), TUI D | pass | | 8. Реальные бинарники: вкладка Podcasts в 0.5.0 показывает подписки; 0.3.5 запускается без неё | TUI 0.5.0, TUI 0.3.5 | pass | | S1. Подписки в одной группе TUI + веб-аккаунт: подписка, checkpoint, отписка и повторная подписка в обе стороны с тем же `podcast_id`; второй веб-аккаунт ничего не видит | TUI 0.5.0 + веб 0.15.0 | pass | | S2. Прогресс: «прослушано» и checkpoint из веба доходят до TUI; «Начать сначала» в TUI побеждает поздний checkpoint веба; TUI продолжает с позиции веба (309 с) | TUI 0.5.0 + веб 0.15.0 | pass | | S3. Перенос веб ↔ TUI с выпуском: позиция, очередь и пауза сохраняются; источник без Range; восстановление после перезапуска веба | TUI 0.5.0 + headless Chrome на веб 0.15.0 | pass | | S3. Воспроизведение через прокси веба с локального издателя | — | not run: SSRF-защита веба по замыслу отвергает 127.0.0.1 (502); путь данных прокси покрыт `src/podcasts/proxy_tests.rs` | | S4. Старые пиры: веб 0.12.4 в группе нового TUI и TUI 0.3.5 в группе нового веба — никаких подкастовых данных, плейлисты синхронизируются, перенос с выпуском отклонён «нужно обновление», отправитель продолжает играть | TUI 0.5.0 + веб 0.12.4; веб 0.15.0 + TUI 0.3.5 | pass | | S5. Jam в вебе: гость видит четыре «Private item», в его ответах API нет данных выпусков | веб 0.15.0, два аккаунта в браузере | pass | | S5. Jam с хостом-TUI и гостем-вебом | — | not run: веб не поддерживает федеративный Jam (`capabilities.rs`, `without_protocol(JAM_ID)`); это отсутствующая функция, не дефект | | Старый клиент v3 как гость Jam | — | вживую не прогонялся; герметичный тест `an_older_jam_guest_cannot_drop_the_hosts_episodes` (`c7e6a36`) | | Гость Jam не может перематывать приватный выпуск хоста | — | вживую не прогонялся; покрыт `jam_guests_see_placeholders_and_their_commands_keep_the_hosts_episodes` | | Старое устройство само забирает воспроизведение (failover) | — | вживую не прогонялся; покрыт `an_old_device_keeps_hearing_from_a_podcast_queue_owner_and_never_fails_over` и `a_podcast_queue_is_not_handed_to_or_replaced_by_a_v3_device` | Обход харнесса TUI ↔ веб: веб не загружает ленты с 127.0.0.1 (SSRF-защита), поэтому каталог выпусков, который разобрал TUI, копируется в `furumusic__podcast_episode` SQL-запросом. Подписки, регистры и операции идут только через настоящие API и настоящий device sync. Замечания, не связанные с этим MR: на вебе исчезнувшее браузерное устройство остаётся «активным» (старое поведение хаба устройств, не из этой серии). ## Ограничения - **Не сделано:** «Поделиться» и публичный поиск подкастов (MR-T3), поэтому критерии §11 про стороннего участника C и публикацию в этом MR не закрыты. - Старое устройство (протокол ниже v4) всё ещё становится владельцем в трёх случаях: - его явно выбирают выходом (Play на нём); - оно запускается, пока это устройство на паузе (`take_paused_on_startup`); - это устройство ~2 минуты закрыто, спит или офлайн (автоматический failover). Тогда старое устройство играет свою копию очереди, где вместо каждого выпуска стоит неиграбельный «Private item». Само оно эти треки пропустить не умеет, а это устройство показывает его очередь без них и с сообщением в статусе. Выпуски из очереди пропадают, сохранённые позиции остаются. Автоматический перехват при работающем владельце v4 устранён, но только на стороне TUI (см. contract gap). - Удаление заглушек при приёме опирается на эвристику. Музыкальный трек ровно с заголовком «Private item», без артиста, релиза, длительности и content id, полученный от устройства ниже v4, будет удалён. Реальный трек с такими пустыми метаданными маловероятен. - Jam-хост на 0.3.x, который получил такие заглушки, раздаст их гостям v4 как музыку: состояние Jam не несёт версии хоста. - Поток без размера, у которого длительность известна только из ленты и которая завышена больше чем на 20 %, всё ещё считается оборванным в своём настоящем конце. Перемотки на таком сервере нет, поэтому сообщение предлагает начать сначала (`b`) или отметить прослушанным (`m`). Поток без размера с недостоверной длительностью из заголовка (например, потоковый WAV с длиной 0xFFFFFFFF) завершается только в строгом окне этой длительности. - Если поток стоит без данных, будет тишина до 30 с, затем воспроизведение останавливается на сохранённой позиции. Перемотка во время такого простоя держит поток команд плеера до этих 30 с: пауза ждёт, а Stop, Next или другой запуск освобождают его сразу. При 4xx посреди выпуска автоматического обновления ленты и перезапуска нет; Play запускает выпуск снова, и устаревший URL при этом проверяется по ленте. - «Начать сначала» с управляющего устройства для выпуска, который ещё не текущий, продолжает с сохранённого места. Для текущего выпуска работает (перемотка на 0). - Секции snapshot подкастов строятся и отправляются при каждой синхронизации (каждые 2 с на пира), до 4 МиБ. Записи, срезанные лимитом, доходят только через неподтверждённые операции. - Гости Jam на 0.3.x / web 0.12.x не могут управлять хостом, пока в его очереди есть выпуски: их команды теряют `source` и отклоняются. - Скорость воспроизведения не поддерживается. `Retry-After` поддерживается только в секундах. - Проверено только на macOS. ## Зависимости Stacked MR поверх **MR-T1** (`podcasts/tab-order`). Ветка `Sanapach/furumi-tui:podcasts/tui` → `Furumi/furumi-tui:podcasts/tab-order`, если эта ветка-основание есть в Furumi/furumi-tui. Иначе MR открывается в `federation`: он зависит от MR-T1, и его diff включает пять коммитов MR-T1. Требует **MR-F1** и **MR-F2** (frid `podcasts/contract`, `podcasts/store`; через `[patch]`, см. «Совместимость и версии»). Решения FRID по трём пунктам выше не блокируют merge, это предложения: правило 1 `PLAYBACK_PROTOCOL.md` вместе с обработкой заглушек, которые присылают обратно пиры ниже v4; валидаторы при импорте прототипа; описание `FeedRefresh.fetched_from`. Веб (MR-W1/W2) с этим MR совместим: межклиентская проверка прошла. Отправку отредактированной координации старым пирам и удаление присланных ими заглушек веб пока не делает, это предложение для FRID и веба. 30 коммитов (`git log --oneline podcasts/tab-order..podcasts/tui`, вершина `ea7cdc4`). Последний — «Point frid deps at the fork branch» (`ea7cdc4`). Коммиты шага 1: - `bc04587` Bump music-dht to 0.6.0 and furumi-library to 0.3.0 - `07dcd05` Fetch podcast feeds and stamp store actions from the sync log - `99c4d05` Replace the Podcasts placeholder with subscriptions, seasons and episodes - `043caf1` Document podcast subscriptions and their runtime boundaries - `7583afa` Box large AppEvent payloads after TrackItem grew Коммиты шага 2: - `3567f5f` Key queue items by source and keep episodes out of music-only paths - `9321e82` Play podcast episodes from the queue and save their progress - `54db297` Document episode playback, queue identity and progress saving - `253583b` Complete episodes after a seek into their last seconds Коммиты шага 3: - `e771326` Use the shared device-sync wire types - `4c3edbc` Store peer protocol versions as the peers report them - `79372e0` Sync podcast state with devices on protocol v4 - `a92e12f` Hand off podcast queues to v4 devices and keep episodes private in Jam - `c6d7848` Document podcast sync between devices and release 0.4.0 - `a79f0a0` Save a seek from a controlling device as an explicit episode action Коммиты исправлений по первому ревью: - `70df945` Keep podcast URLs out of the personal-sync debug log - `8d87fe3` Keep older devices hearing from a podcast queue owner - `2989747` Stop broken episode streams instead of completing them - `42f22f0` Document lost connections, cancellation and seeks of episodes - `fe373e4` Parse imported prototype feeds on their first check - `e0da2dd` Move a feed to its permanent address behind a temporary redirect - `268ea91` Keep podcast store work in sync handlers off Tokio workers - `34c096a` Bound a whole feed fetch and test the fetch limits - `96e615b` Refuse an episode seek without leaving the effect early Коммиты исправлений по повторному ревью: - `42ecc31` End a sizeless episode stream where it ends when only the feed knew its length - `d03a330` Resume dropping prototype feed validators after an interrupted start - `2806e67` Leave out placeholders an older device echoes back as music - `e0624ab` Document what an older device's takeover does to a podcast queue Коммит после межклиентской проверки: - `c7e6a36` Test that an older Jam guest cannot drop the host's episodes - `ea7cdc4` Point frid deps at the fork branch 🤖 Generated with [Claude Code](https://claude.com/claude-code)
sanapach added 35 commits 2026-11-20 13:26:26 +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>
sanapach changed title from Podcasts/tui to Подкасты в TUI на контракте FRID: подписки, воспроизведение, прогресс, синхронизация устройств v4 (MR-T2) 2026-11-20 13:40:07 +00:00
ab merged commit 7659313dc2 into federation 2026-11-20 14:11:09 +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#3