Приём: пропажа источника у активной загрузки → failed(source_gone) (MAJOR-3)

Раздача активной (downloading) загрузки, исчезнувшая из qBittorrent (удалил
пользователь/другой клиент), делала задачу вечным зомби: поллинг промахивался
по torrentFor, писал Warn и continue каждый тик — состояние не менялось,
уведомления и телеметрии не было, checkTimeouts без торрента не срабатывал.
Пропажей источника у downloading не владел никто (сверка рассинхрона покрывает
только done/target_missing/orphaned, восстановление — failed/stuck).

Активный цикл Poll теперь применяет тот же дебаунс пропажи источника, что и
сверка рассинхрона (source_miss_count / source_missing_threshold): после порога
подряд идущих промахов задача уходит downloading → failed с distinct error_code
source_gone и уведомлением. До порога транзиентная недоступность qBit
(рестарт демона) задачу не роняет. source_gone восстановлению сверкой не
подлежит (удаление намеренно), но штатно retriable — Retry заново отдаёт
сохранённый источник; Retry сбрасывает source_miss_count, чтобы вернувшаяся
задача получила полное грейс-окно, а не упала снова на ближайшем тике.

Ребро downloading → failed уже было в графе, миграций/полей БД нет. Спека
download-tracking дополнена требованием, диаграмма workflow.md — ребром.
Change downloading-source-gone заархивирован.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-07-08 18:05:04 +03:00
co-authored by Claude Opus 4.8
parent bfd469bd43
commit 2a5a65f2d5
13 changed files with 524 additions and 21 deletions
+31 -2
View File
@@ -133,6 +133,12 @@ const (
// catch_timeout (устойчивая недоступность qBit). Раздачи в qBittorrent нет,
// восстановлению сверкой не подлежит.
errCodeQbitAdd = "qbit_add"
// errCodeSourceGone — раздача активной (downloading) загрузки устойчиво (после
// дебаунса source_missing_threshold) пропала из qBittorrent: пользователь/другой
// клиент её удалил. Distinct-код, отличный от qbit_error (реальная ошибка qBit) и
// magnet_timeout/stalled (наша нетерпеливость). Восстановлению сверкой НЕ подлежит
// (удаление намеренно) — но задача штатно retriable: Retry заново отдаёт источник.
errCodeSourceGone = "source_gone"
)
// Notifier — исходящие пинги (Telegram). Вызывается неблокирующе.
@@ -501,9 +507,22 @@ func (w *Worker) Poll(ctx context.Context) error {
continue // нечем сопоставить (в Ф1 не случается: magnet всегда с infohash)
}
t, ok := torrentFor(d, byHash)
// Дебаунс пропажи источника у активной загрузки (тот же счётчик, что и
// сверка рассинхрона): промах наращивает source_miss_count, появление
// раздачи сбрасывает его. Устойчивая пропажа (после порога) уводит задачу
// в failed(source_gone) — иначе downloading без раздачи в qBittorrent
// оставался бы вечным зомби (MAJOR-3).
if present := w.debounceSource(ctx, d, ok); !present {
lctx := w.scoped(ctx, capIngest, d.ID, d.PrimaryInfohash())
logctx.From(lctx).Warn("active download source gone from qbittorrent",
"miss_count", d.SourceMissCount+1)
w.transition(lctx, d, store.StateFailed, errCodeSourceGone,
"источник удалён из qBittorrent")
continue
}
if !ok {
w.log.Warn("active download not found in qbittorrent",
"capability", capIngest, "download_id", d.ID, "infohash", d.PrimaryInfohash())
// До порога: транзиентный промах (например рестарт демона qBit) — ждём
// следующий тик, задачу не трогаем.
continue
}
w.captureInfohashes(ctx, d, t)
@@ -839,6 +858,16 @@ func (w *Worker) Retry(ctx context.Context, id string) error {
w.log.Warn("retry basis reset failed",
"capability", capReview, "download_id", id, "error", err)
}
// Сброс счётчика пропусков источника: retried source_gone-задача иначе вошла бы
// в downloading с source_miss_count == threshold и упала бы снова на ближайшем
// тике, если переотданная раздача ещё не видна в выдаче qBittorrent — без
// обещанного грейс-окна (MAJOR-3). Best-effort: сбой лишь лишает свежего окна.
if d.SourceMissCount != 0 {
if err := w.store.SetSourceMissCount(ctx, id, 0); err != nil {
w.log.Warn("retry miss count reset failed",
"capability", capReview, "download_id", id, "error", err)
}
}
logctx.From(w.scoped(ctx, capReview, id, d.PrimaryInfohash())).Info("download retried", "from", d.State)
return nil
}