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

30 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 1. F1 — пер-хеш гард дедуп-дозаписи
- [x] 1.1 В `CreateDownloadIfNoActive` (`internal/store/download.go`) заменить
безусловный цикл `INSERT OR IGNORE` дедуп-ветки на пер-хеш гард как в
`AddInfohashes`: пропускать хеш, которым владеет другая активная задача
(`findActiveByInfohash(..., existing.ID)`), внутри уже открытой tx.
- [x] 1.2 Тест в `internal/store`: гибридный дедуп на B не крадёт хеш,
принадлежащий активной A (инвариант сохранён).
## 2. F6 — апгрейд catched-magnet до torrent
- [x] 2.1 Добавить guarded-метод хранилища
`UpgradeCatchedMagnetToTorrent(ctx, downloadID, torrentBlob) (bool, error)`:
в одной tx гардированным UPDATE `source_type='torrent'` при
`source_type='magnet' AND state='catched'`, затем сохранить байты в
`download_torrent`; вернуть, был ли апгрейд.
- [x] 2.2 В `internal/ingest/ingest.go` свести оба дедуп-пути к `attached()` и
вызвать апгрейд, когда входящий источник — torrent с байтами
(best-effort: неуспех логируется, приём не валится).
- [x] 2.3 Обновить интерфейс `ingest.Store` и `fakeStore` в тестах.
- [x] 2.4 Тесты в `internal/store`: апгрейд из `catched`+magnet сохраняет байты
и меняет `source_type`; из `downloading`/не-magnet — no-op. Тест в
`internal/ingest`: дедуп `.torrent` на catched-magnet вызывает апгрейд.
## 3. Проверки
- [x] 3.1 `openspec validate --strict ingest-dedup-integrity`
- [x] 3.2 `task test`
- [x] 3.3 `task lint`