Files
jellybit/openspec/changes/ingest-dedup-integrity/tasks.md
T
avandClaude Opus 4.8 4475fbd548 Приём: гард дедуп-дозаписи хешей (F1) и апгрейд catched-magnet до torrent (F6)
Два дефекта дедуп-веток приёма (ревью Fable 2026-07-08), оба про инвариант
«≤1 активная загрузка на infohash» и сохранность источника.

F1: дедуп-ветка CreateDownloadIfNoActive дописывала все хеши входящего
источника в найденную активную задачу без пер-хеш гарда владения (в отличие
от AddInfohashes). Гибрид {v1,v2}, дедупнувшись на задачу B (владелец v2),
крал v1 у активной A → две активные владели v1. Теперь дозапись под тем же
гардом: хеш, которым владеет другая активная задача, не дописывается.

F6: при дедупе .torrent-байт на пойманную magnet-задачу (catched) байты
выбрасывались, source_type оставался magnet → worker добавлял по magnet-URL →
вечный metaDL → failed (magnet закрытого трекера без DHT метаданные не
докачает). Новый guarded-метод UpgradeCatchedMagnetToTorrent атомарно
сохраняет байты и меняет source_type magnet→torrent, но только пока задача в
catched (worker источник ещё не отдал). Ingest зовёт апгрейд на обоих
дедуп-путях. Это целевое исключение из правила спеки «при дедупе байты не
сохраняем» — оформлено MODIFIED-дельтой ingest.

Схема БД не меняется (download_torrent и source_type уже есть).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 17:18:28 +03:00

1.9 KiB
Raw Blame History

1. F1 — пер-хеш гард дедуп-дозаписи

  • 1.1 В CreateDownloadIfNoActive (internal/store/download.go) заменить безусловный цикл INSERT OR IGNORE дедуп-ветки на пер-хеш гард как в AddInfohashes: пропускать хеш, которым владеет другая активная задача (findActiveByInfohash(..., existing.ID)), внутри уже открытой tx.
  • 1.2 Тест в internal/store: гибридный дедуп на B не крадёт хеш, принадлежащий активной A (инвариант сохранён).

2. F6 — апгрейд catched-magnet до torrent

  • 2.1 Добавить guarded-метод хранилища UpgradeCatchedMagnetToTorrent(ctx, downloadID, torrentBlob) (bool, error): в одной tx гардированным UPDATE source_type='torrent' при source_type='magnet' AND state='catched', затем сохранить байты в download_torrent; вернуть, был ли апгрейд.
  • 2.2 В internal/ingest/ingest.go свести оба дедуп-пути к attached() и вызвать апгрейд, когда входящий источник — torrent с байтами (best-effort: неуспех логируется, приём не валится).
  • 2.3 Обновить интерфейс ingest.Store и fakeStore в тестах.
  • 2.4 Тесты в internal/store: апгрейд из catched+magnet сохраняет байты и меняет source_type; из downloading/не-magnet — no-op. Тест в internal/ingest: дедуп .torrent на catched-magnet вызывает апгрейд.

3. Проверки

  • 3.1 openspec validate --strict ingest-dedup-integrity
  • 3.2 task test
  • 3.3 task lint