Приём: пропажа источника у активной загрузки → 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
+134
View File
@@ -260,3 +260,137 @@ func TestStallIgnoresFutureLastActivity(t *testing.T) {
t.Errorf("last_activity из будущего игнорируется (фолбэк на возраст 5ч > stuck_after 1ч → stuck), got %q", got)
}
}
// --- MAJOR-3: пропажа источника у активной (downloading) загрузки ---
// Источник активной загрузки устойчиво пропал из qBittorrent → задача уходит в
// failed(source_gone) с уведомлением, а не остаётся вечным зомби.
func TestSourceGoneMarksFailed(t *testing.T) {
const ih = "541adcff3b6dd5dba7088ea83317d9d6fac331d6"
st := oneDownloading(ih, timeRecent)
w := newTestWorker(st, &fakeQbt{torrents: nil}) // раздачи нет
w.cfg.SourceMissingThreshold = 1 // помечаем при первой же пропаже
n := &recordingNotifier{ch: make(chan notifyEvent, 4)}
w.SetNotifier(n)
if err := w.Poll(context.Background()); err != nil {
t.Fatalf("Poll: %v", err)
}
d := st.downloads["1"]
if d.State != store.StateFailed {
t.Fatalf("state = %q, want failed", d.State)
}
if got := d.ErrorCode.String; got != errCodeSourceGone {
t.Errorf("error_code = %q, want %q", got, errCodeSourceGone)
}
if e := waitNotify(t, n); e.ev != EventFailed {
t.Errorf("пинг: ev=%v, want failed", e.ev)
}
}
// Кратковременная пропажа (меньше порога) не роняет задачу — дебаунс терпит
// транзиентную недоступность qBittorrent (рестарт демона).
func TestSourceGoneDebounced(t *testing.T) {
const ih = "541adcff3b6dd5dba7088ea83317d9d6fac331d6"
st := oneDownloading(ih, timeRecent)
w := newTestWorker(st, &fakeQbt{torrents: nil})
w.cfg.SourceMissingThreshold = 3
for i := 1; i <= 2; i++ {
if err := w.Poll(context.Background()); err != nil {
t.Fatalf("Poll %d: %v", i, err)
}
if got := st.downloads["1"].State; got != store.StateDownloading {
t.Fatalf("tick %d: state = %q, want downloading (до порога)", i, got)
}
if got := st.downloads["1"].SourceMissCount; got != i {
t.Errorf("tick %d: miss = %d, want %d", i, got, i)
}
}
if err := w.Poll(context.Background()); err != nil { // третий промах
t.Fatalf("Poll 3: %v", err)
}
if got := st.downloads["1"].State; got != store.StateFailed {
t.Fatalf("tick 3: state = %q, want failed (порог достигнут)", got)
}
if got := st.downloads["1"].ErrorCode.String; got != errCodeSourceGone {
t.Errorf("error_code = %q, want %q", got, errCodeSourceGone)
}
}
// Возврат раздачи до порога сбрасывает счётчик промахов и задача ведётся
// обычной сверкой (не падает).
func TestSourceGoneResetOnReturn(t *testing.T) {
const ih = "541adcff3b6dd5dba7088ea83317d9d6fac331d6"
st := oneDownloading(ih, timeRecent)
qb := &fakeQbt{torrents: nil}
w := newTestWorker(st, qb)
w.cfg.SourceMissingThreshold = 3
if err := w.Poll(context.Background()); err != nil { // промах 1
t.Fatalf("Poll miss: %v", err)
}
if got := st.downloads["1"].SourceMissCount; got != 1 {
t.Fatalf("miss = %d, want 1", got)
}
// Раздача вернулась (свежий metaDL — не падает по таймауту).
qb.torrents = []qbt.Torrent{{Hash: ih, State: "metaDL", AddedOn: addedRecent}}
if err := w.Poll(context.Background()); err != nil {
t.Fatalf("Poll return: %v", err)
}
if got := st.downloads["1"].State; got != store.StateDownloading {
t.Errorf("state = %q, want downloading (источник вернулся)", got)
}
if got := st.downloads["1"].SourceMissCount; got != 0 {
t.Errorf("miss = %d, want 0 (сброс)", got)
}
}
// source_gone восстановлению сверкой не подлежит: даже если раздача снова
// появилась и продвинулась, reconcileRecovery её не воскрешает — нужен ручной
// Retry.
func TestSourceGoneNotAutoRecovered(t *testing.T) {
const ih = "541adcff3b6dd5dba7088ea83317d9d6fac331d6"
st := oneFailed(store.StateFailed, errCodeSourceGone, ih, timeOld)
qb := &fakeQbt{torrents: []qbt.Torrent{{Hash: ih, State: "downloading", AddedOn: addedRecent}}}
w := newTestWorker(st, qb)
if err := w.Poll(context.Background()); err != nil {
t.Fatalf("Poll: %v", err)
}
if got := st.downloads["1"].State; got != store.StateFailed {
t.Errorf("state = %q, want failed (source_gone сверкой не воскрешается)", got)
}
}
// Retry задачи source_gone сбрасывает source_miss_count, чтобы вернувшаяся в
// downloading задача получила полное грейс-окно, а не упала снова на ближайшем
// тике, если переотданная раздача ещё не видна в qBittorrent.
func TestRetryResetsSourceMissCount(t *testing.T) {
const ih = "541adcff3b6dd5dba7088ea83317d9d6fac331d6"
st := oneFailed(store.StateFailed, errCodeSourceGone, ih, timeRecent)
st.downloads["1"].SourceMissCount = 3 // задача упала по порогу
qb := &fakeQbt{torrents: nil} // раздачи всё ещё нет (Add вслепую)
w := newTestWorker(st, qb)
w.cfg.SourceMissingThreshold = 3
if err := w.Retry(context.Background(), "1"); err != nil {
t.Fatalf("Retry: %v", err)
}
if got := st.downloads["1"].SourceMissCount; got != 0 {
t.Fatalf("после retry miss = %d, want 0 (сброс)", got)
}
if len(qb.added) != 1 {
t.Errorf("retry без живой раздачи должен переотдать источник, got %d Add", len(qb.added))
}
// Грейс-окно: раздача ещё не видна — задача НЕ падает на ближайшем тике
// (miss стал бы 1 < 3, а не 4 при несброшенном счётчике).
if err := w.Poll(context.Background()); err != nil {
t.Fatalf("Poll after retry: %v", err)
}
if got := st.downloads["1"].State; got != store.StateDownloading {
t.Errorf("state = %q, want downloading (грейс-окно не съедено)", got)
}
if got := st.downloads["1"].SourceMissCount; got != 1 {
t.Errorf("miss = %d, want 1 (один промах после сброса)", got)
}
}