avandClaude Opus 4.8
4cc4de4269
Итог параллельной волны фиксов (worktree-изоляция, cherry-pick в master): - ingest-dedup-integrity (F1, F6) → спека ingest - retry-stall-basis (MAJOR-1, MAJOR-2) → спека state-reconciliation - linking-transition-robustness (MAJOR-4, MINOR-7) → спеки file-layout и state-reconciliation Дельты влиты в openspec/specs, changes перенесены в openspec/changes/archive/2026-07-08-*. Беклог не трогаю (по решению). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.1 KiB
Why
Ревью приёма (Fable, 2026-07-08) вскрыло два дефекта в дедуп-ветках приёма, оба про инвариант «≤1 активная загрузка на infohash» и про сохранность источника:
-
F1 — неохраняемая дозапись хешей. Дедуп-ветка
CreateDownloadIfNoActive(internal/store/download.go) безусловно дописывает ВСЕ хеши входящего источника в найденную активную задачу (INSERT OR IGNORE) без пер-хеш гарда владения — в отличие отAddInfohashes, где гард есть. Это единственная неохраняемая запись хешей, и она в авторитетном методе инварианта. Сценарий: активная A владеетv1, активная B владеетv2того же гибридного торрента; приём гибрида{v1,v2}, дедупнувшись на B, допишетv1в B → две активные владеютv1. Инвариант нарушен. -
F6 — потерянный upgrade-путь
.torrentповерх magnet. Пользователь сначала ловит magnet с закрытого трекера (задачаcatched,source_type=magnet), понимает, что без DHT метаданные не докачаются, и грузит правильный.torrent. Приём дедупит по infohash на magnet-задачу; по текущей спеке байты при дедупе НЕ сохраняются,source_typeостаётсяmagnet. Worker добавляет раздачу по magnet-URL → вечный metaDL → failed. Ровно тот артефакт, который бы починил загрузку, выбрасывается с «уже в работе».
What Changes
-
F1: дедуп-ветка
CreateDownloadIfNoActiveприменяет тот же пер-хеш гард, что иAddInfohashes: хеш, которым владеет ДРУГАЯ активная задача, не дописывается. Транзакция уже открыта — правка внутри неё. -
F6: при дедупе, где входящее — байты
.torrent, а активная задача поймана какmagnetи ещё не добавлена в qBittorrent (состояниеcatched), система сохраняет байты и меняетsource_typeнаtorrentв одной транзакции. Тогда worker добавит раздачу файлом и метаданные не придётся докачивать по DHT. Это ПРОТИВОРЕЧИТ действующему правилу спеки ingest «при дедупликации байты сохраняться SHALL NOT» — правило смягчается этим целевым исключением (MODIFIED-дельта).
Схема БД не меняется: таблица download_torrent уже есть, source_type —
существующая колонка; апгрейд — изменение данных, не структуры.
Capabilities
Modified Capabilities
ingest: уточняется поведение дедупа (пер-хеш гард дозаписи; сохранение.torrent-байт и смена источника при апгрейдеcatched-magnet).
Impact
- Код:
internal/store/download.go(гард F1 + новый guarded-метод апгрейда),internal/ingest/ingest.go(вызов апгрейда на обоих дедуп-путях). - Тесты:
internal/store,internal/ingest. - Совместимость: изменение только ужесточает инвариант (F1) и добавляет
целевой апгрейд (F6); существующие потоки без
.torrent-поверх-magnet ведут себя как прежде.