Статус: все три шага 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://, редактирование.
поток идёт с сервера издателя через 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).
Версия из запроса на сопряжение хранится в новой колонке.
При первом запуске новой версии устройство объявляет её в журнале.
Протокол 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)
(high) Старый клиент забирал воспроизведение примерно через 2 минуты и терял выпуски. Пир v3 теперь получает координацию с отредактированной очередью. Тест: движок 0.3.x с конфигурацией по умолчанию в течение 3 × owner_timeout не перехватывает владение. Без исправления тест падает.
(high) Обрыв потока полностью завершал выпуск. Теперь сохраняется последняя позиция, выпуск не отмечается прослушанным, очередь не двигается.
(medium) Пауза во время подключения терялась. Теперь намерение читается в момент старта источника.
(medium) После переноса базы прототипа сезоны не появлялись. Валидаторы прототипа сбрасываются.
(low) Перемотка записывалась, даже если не сработала. Теперь она записывается только по подтверждению плеера; во время подключения и без Range отклоняется.
(low) Вытесненная подготовка продолжала скачивание. Добавлена отмена по поколению плеера.
(low) Застрявшее чтение блокировало аудиопоток до 30 с. Stop, Play и новый запуск освобождают его за ~100 мс.
(low) Цепочка 301 → 302 не переносила ленту.
(low) Хранилище вызывалось на воркерах Tokio. Теперь через block_in_place; ARCHITECTURE исправлен.
(low) URL с токенами попадали в журнал.
(low) Лимиты не были покрыты тестами. Добавлены тесты и общий дедлайн загрузки.
Исправления по повторному ревью (коммиты после 96e615b)
(medium, замечания 1 и 4) Старое устройство присылало заглушки обратно как музыку. После его перехвата или команды очередь v4 заполнялась неиграбельными треками «Private item», которые расходились по всем пирам v4. Теперь такие треки удаляются при приёме, а в статусе показывается сообщение. Документация больше не утверждает того, что не выполнялось, и описывает перехват через failover. Тест повторяет полный путь: отредактированная очередь разбирается точными типами 0.3.x, старое устройство публикует её заново как в 0.3.x и перехватывает владение с более высоким claim; ещё один сценарий — команда, собранная по устаревшему зеркалу очереди. Без исправления тест падает.
(low, замечание 2) Сброс валидаторов прототипа выполнялся один раз и не был атомарным с импортом. Теперь есть маркер рядом с базой, и при сбое сброс повторяется. Импортированный счётчик ошибок (consecutive_failures) восстанавливается в прежнем значении.
(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.
Клиент 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 локальный и не синхронизируется. Побочный эффект: у подкаста, импортированного с ошибкой, появляется время последнего успеха, равное последней проверке. Пока показывается ошибка, интерфейс это время не выводит.
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.tomlmusic-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 раза — зелёный.
Новый тест c7e6a36app::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; подкастовых данных, названий и 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-tuipodcasts/discovery @ 409188b, включает этот MR;
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 прогонов хранятся у автора и могут быть приложены по запросу.
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
> **Серия «Подкасты»:** 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)
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>
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>
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>
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>
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>
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>
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>
sanapach
changed title from Podcasts/tui to Подкасты в TUI на контракте FRID: подписки, воспроизведение, прогресс, синхронизация устройств v4 (MR-T2)2026-11-20 13:40:07 +00:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Статус: все три шага 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в каталоге данных платформы. База прототипа переносится на месте.ETag,Last-Modified) сбрасываются, и первая проверка ленты загружает её целиком. Иначе сервер отвечал бы 304, и не появились бы сезоны, номера выпусков и новые ключи выпусков без GUID. Сброс можно повторить: до импорта рядом с базой записывается маркерpodcasts.sqlite3.full-check-pending, и он удаляется только после обработки всех подкастов. Если запуск прервался между миграцией и сбросом, сброс выполнится при следующем запуске. Это обход contract gap в F2, см. «Решения и отступления».Загрузка и обновление RSS (
src/podcasts/)furumi/<версия> (podcast reader);music_dht::podcast::feed, а записываетPodcastStore::apply_feed. Постоянный редирект илиitunes:new-feed-urlстановится алиасом.Retry-After;Вкладка Podcasts
●,◐,✓;SxEy, длительность.Шаг 2. Очередь, воспроизведение, долговечный прогресс
TrackItem::podcast_episode(PodcastEpisodeRef).idу всех выпусков одинаковый (−1) и никогда не служит идентичностью.ep:<episode id>, затемcontent:,fed:,lib:<id>.frid://, редактирование.Shift+Jоткрывает подкаст.src/podcasts/stream.rs,playback.rs, плеер):PlaySourceнесёт поколение источника, поэтому запоздавший поток отбрасывается;StreamProbe). Выпуск завершается и очередь идёт дальше, только если поток дошёл до описанного сервером конца или оборвался уже в окне завершения (playback::played_to_the_end). Иначе сохраняется последняя позиция, воспроизведение останавливается на этом выпуске и показывается сообщение;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.Enter— воспроизвести или продолжить;b— начать сначала;a/Shift+A— добавить в очередь;▶и текущая позиция.Шаг 3. Синхронизация устройств v4, перенос воспроизведения, Jam
Общие wire-типы
src/devices.rsбольше нет. Используются типы изmusic_dht::device_sync:InviteWire,DeviceProfileWire;SyncOpWire/SyncOpPayload,SyncSnapshot;Playback*,WireMessage;src/devices/wire_compat_tests.rs):fixtures/v3_hello.golden.jsonсовпадает с файлом веб-версии.Версия протокола пира (исправление)
device_profile_setи принятое сопряжение записывали чужому устройству собственную константу этой сборки, и отсечка по версии не работала.profile_protocol_version):devices;device_profile_set.relayed_protocol_version).p,device_profile_setнесётprotocol_version.Протокол v4 и данные подкастов
PROTOCOL_VERSION = 4.PodcastStore::apply_remote_op. Невалидные пропускаются, но подтверждаются.sync_podcast_pendingи применяются, когда хранилище подключается.fill_snapshot;podcast_snapshot_budget);apply_snapshotпосле операций того же сообщения.block_in_place. Пока хранилище занято обновлением большой ленты, другие задачи этого воркера Tokio продолжают работать.op_id, без URL лент и аудио.Отсечка по версии пира
Пирам ниже v4 никогда не отправляются:
op_allowed_for_peer, фильтр в SQL);SyncSnapshot::for_peer);playback_allowed_for_peer).Старое устройство всё равно получает snapshot воспроизведения с координацией, но каждый выпуск в очереди заменён непрозрачным «Private item» (
redact_for_jam). Иначе его движок владения через 2 минуты тишины сам забирал воспроизведение, и очередь с выпусками пропадала. Это отступление от правила 1PLAYBACK_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и последнее известное поколение прогресса. Принимающее устройство играет выпуск даже без подписки.SetState/ActiveChangedот такого устройства отклоняются, пока в очереди есть выпуски. Проверка идёт до движка владения.Jam
redact_for_jam. Гости видят «Private item» без названия, ленты и URL.restore_jam_private_items).Документация и версия
furumi-tui0.3.5 → 0.4.0.Исправления по первому ревью (коммиты после
a79f0a0)owner_timeoutне перехватывает владение. Без исправления тест падает.block_in_place; ARCHITECTURE исправлен.Исправления по повторному ревью (коммиты после
96e615b)consecutive_failures) восстанавливается в прежнем значении.bилиm. Тест: настоящий MP3 без заголовка Xing, отданный без Content-Length, длиной 100 с при длительности в ленте 120 с, завершается.Клавиши в контексте
podcastsEnterbo/Shift+R/Ctrl+RShift+SfmShift+U(Shift+D)Решения и отступления
PLAYBACK_PROTOCOL.md, правило 1).None. Но движокmusic_dht::playbackпродлевает жизнь владельца только по его собственным объявлениям, поэтому старый клиент сautomatic_failoverперехватывает владение черезowner_timeout_ms.Snapshot { state: redact_for_jam(state), coordination: Some(..) }.source), и они попадают в очереди v4 после его перехвата или в его командах. TUI удаляет их при приёме от пиров ниже v4 (drop_echoed_private_items).music_dht::device_syncобщую функцию с тем же критерием:source == None, title =PRIVATE_ITEM_TITLE, нет content id, fed, артистов, релиза и длительности;etag/last_modifiedпрототипа.NULLв той же транзакции или отмечать fetch state как «нужна полная загрузка».user_version(только чтение,LEGACY_PROTOTYPE_SCHEMA_VERSION) и записывает маркер рядом с базой;record_fetch_successсNoneпри сохранении времени и следующей проверки, затемrecord_fetch_failureстолько раз, сколько ошибок было у прототипа;FeedRefresh.fetched_from).apply_feedиспользует поле только для алиаса и fetch URL, поэтому поведение уже согласовано.reaches_completion) не меняется: он по-прежнему применяется к позиции во время воспроизведения и к длительности, измеренной декодером.listen_recordedнижняя граница — v2, как в вебе: каждый пирfurumi/sync/2хранит историю.PlaybackSource::Private.TrackItem.podcastвBox;PodcastStore::apply_snapshotизменённые записи, а не только счётчики;Совместимость и версии
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.tomlmusic-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 перегенерируется ещё раз.furumi/sync/2.pиprotocol_versionстарые клиенты игнорируют.Как проверено (macOS 26.5.2, Darwin 25.5.0, arm64, rustc 1.100.0)
c7e6a36(CARGO_TARGET_DIR=…/.targets/tui-t2, fridpodcasts/store@d2530dcчерез[patch]): fmt — OK, check — OK, набор предупреждений clippy совпадает с прежней вершинойe0624ab(новых нет), тесты — 299 passed, 0 failed, 4 ignored. Наe0624abбыло 298 passed, полный прогон повторён ещё 3 раза — зелёный.c7e6a36app::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). Тест прошёл без изменения кода.localhost_web_peer(нуженscripts/test_device_interop.pyи репозиторий веба),onnx_model_smokeи два ручных бенчмарка.__eh_frame section too large. Оно появилось на шаге 1 и не относится к предупреждениям кода.federation-net 0.4.Проверено автоматически (TUI ↔ TUI, внутри процесса):
podcast_sync_tests;localhost_devices_sync_podcasts— по настоящим iroh-потокам черезsync_device→handle_hello.playback::resolve(StartAt::Resume). Checkpoint схлопываются в журнале.Superseded). Через сеть тоже.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);ActiveChangedигнорируется, пока в очереди есть выпуски, и проходит, когда их нет.InProgressна ~30 с, 0 завершённых прослушиваний;a_stream_shorter_than_the_feed_says_completes_at_its_end,a_stream_shorter_than_its_feed_duration_completes_at_its_end);b/m;STARVE_TIMEOUT/2;finishи отказ в перемотке;Controller;dropping_prototype_validators_resumes_after_an_interrupted_start);ftp://, зависший сервер, обложки;block_in_placeне держит единственный воркер.Не проверено:
scripts/test_device_interop.pyне запускался (его заменил харнесс, см. ниже).app/mod.rs(обработчикиTrackFinishedиSeeked, переход к следующему треку послеFinished::Completed) автотестом в репозитории не покрыта, её косвенно проверили сценарии 2–3 межклиентского прогона.Межклиентская проверка
Окружение. macOS (Darwin 25.5, arm64), 20.11.2026, вершина всего стека:
furumi-tuipodcasts/discovery@409188b, включает этот MR;furumi-webpodcasts/discovery@0e985b4;podcasts/discovery@9c82f6dчерез локальный[patch];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.
podcast_id; второй веб-аккаунт ничего не видитsrc/podcasts/proxy_tests.rscapabilities.rs,without_protocol(JAM_ID)); это отсутствующая функция, не дефектan_older_jam_guest_cannot_drop_the_hosts_episodes(c7e6a36)jam_guests_see_placeholders_and_their_commands_keep_the_hosts_episodesan_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_episodeSQL-запросом. Подписки, регистры и операции идут только через настоящие API и настоящий device sync.Замечания, не связанные с этим MR: на вебе исчезнувшее браузерное устройство остаётся «активным» (старое поведение хаба устройств, не из этой серии).
Ограничения
Не сделано: «Поделиться» и публичный поиск подкастов (MR-T3), поэтому критерии §11 про стороннего участника C и публикацию в этом MR не закрыты.
Старое устройство (протокол ниже v4) всё ещё становится владельцем в трёх случаях:
take_paused_on_startup);Тогда старое устройство играет свою копию очереди, где вместо каждого выпуска стоит неиграбельный «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, это предложения: правило 1PLAYBACK_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:
bc04587Bump music-dht to 0.6.0 and furumi-library to 0.3.007dcd05Fetch podcast feeds and stamp store actions from the sync log99c4d05Replace the Podcasts placeholder with subscriptions, seasons and episodes043caf1Document podcast subscriptions and their runtime boundaries7583afaBox large AppEvent payloads after TrackItem grewКоммиты шага 2:
3567f5fKey queue items by source and keep episodes out of music-only paths9321e82Play podcast episodes from the queue and save their progress54db297Document episode playback, queue identity and progress saving253583bComplete episodes after a seek into their last secondsКоммиты шага 3:
e771326Use the shared device-sync wire types4c3edbcStore peer protocol versions as the peers report them79372e0Sync podcast state with devices on protocol v4a92e12fHand off podcast queues to v4 devices and keep episodes private in Jamc6d7848Document podcast sync between devices and release 0.4.0a79f0a0Save a seek from a controlling device as an explicit episode actionКоммиты исправлений по первому ревью:
70df945Keep podcast URLs out of the personal-sync debug log8d87fe3Keep older devices hearing from a podcast queue owner2989747Stop broken episode streams instead of completing them42f22f0Document lost connections, cancellation and seeks of episodesfe373e4Parse imported prototype feeds on their first checke0da2ddMove a feed to its permanent address behind a temporary redirect268ea91Keep podcast store work in sync handlers off Tokio workers34c096aBound a whole feed fetch and test the fetch limits96e615bRefuse an episode seek without leaving the effect earlyКоммиты исправлений по повторному ревью:
42ecc31End a sizeless episode stream where it ends when only the feed knew its lengthd03a330Resume dropping prototype feed validators after an interrupted start2806e67Leave out placeholders an older device echoes back as musice0624abDocument what an older device's takeover does to a podcast queueКоммит после межклиентской проверки:
c7e6a36Test that an older Jam guest cannot drop the host's episodesea7cdc4Point frid deps at the fork branch🤖 Generated with Claude Code
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>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>Podcasts/tuito Подкасты в TUI на контракте FRID: подписки, воспроизведение, прогресс, синхронизация устройств v4 (MR-T2)