Восстановление зависших загрузок и уведомления о падении (state-reconciliation)

Долгий metaDL больше не убивается агрессивным таймаутом: дефолт
magnet_timeout 30m → 24h (страховочный предохранитель), базис отсчёта —
added_on из qBittorrent, а не created_at (переживает retry/усыновление).

Авто-восстановление: фоновая сверка возвращает в поток задачи, упавшие по
нашей нетерпеливости (magnet_timeout/stalled), когда источник ожил и
продвинулся за условие падения (downloading/completed по статусу торрента);
qbit_error не воскрешается. Конфликт idempotency (infohash занят другой
активной задачей) — оставляем в failed.

Уведомления: любой переход в failed/stuck пингует автора (включая приёмный
qbit_add через ingest), с дебаунсом против спама при флаппинге stalled.
Ручной retry добавлен в веб-UI и Telegram; Retry перецепляется к живому
торренту вместо слепого Add.

Дельта state-reconciliation влита в живые спеки; обновлён workflow.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

internal/tgbot/bot.go

@@ -36,6 +36,7 @@ type Reviewer interface {
 	SetType(ctx context.Context, id int64, mediaType string) error
 	Defer(ctx context.Context, id int64) error
 	Cancel(ctx context.Context, id int64) error
+	Retry(ctx context.Context, id int64) error
 }
 
 // Config — параметры бота.
@@ -191,6 +192,9 @@ func (b *Bot) handleCallback(ctx context.Context, cq *tgbotapi.CallbackQuery) {
 	case "reject":
 		err = b.reviewer.Cancel(ctx, id)
 		note = "Отклонено"
+	case "retry":
+		err = b.reviewer.Retry(ctx, id)
+		note = "Повторяю…"
 	case "type":
 		err = b.reviewer.SetType(ctx, id, val)
 		note = "Меняю тип…"
@@ -248,6 +252,8 @@ func (b *Bot) Notify(ctx context.Context, downloadID int64, event worker.NotifyE
 		text = b.renderDone(rd)
 	case worker.EventTargetMissing, worker.EventOrphaned:
 		text, kb = b.renderDesync(rd, event), b.webOnly(downloadID)
+	case worker.EventFailed:
+		text, kb = b.renderFailed(rd)
 	default:
 		text, kb = b.renderCard(rd)
 	}

internal/tgbot/bot_test.go

@@ -65,6 +65,7 @@ type fakeReviewer struct {
 	typed    map[int64]string
 	deferred []int64
 	canceled []int64
+	retried  []int64
 }
 
 func (f *fakeReviewer) ReviewData(context.Context, int64) (*worker.ReviewData, error) {
@@ -96,6 +97,10 @@ func (f *fakeReviewer) Cancel(_ context.Context, id int64) error {
 	f.canceled = append(f.canceled, id)
 	return nil
 }
+func (f *fakeReviewer) Retry(_ context.Context, id int64) error {
+	f.retried = append(f.retried, id)
+	return nil
+}
 
 func reviewData(state store.State) *worker.ReviewData {
 	s, e := 2, 1
@@ -252,6 +257,29 @@ func TestBot_NotifyDone(t *testing.T) {
 	}
 }
 
+func TestBot_NotifyFailed(t *testing.T) {
+	b, api, _, rev := newTestBot(t, []int64{7})
+	rev.data = reviewData(store.StateFailed)
+	b.Notify(context.Background(), 5, worker.EventFailed)
+
+	if len(api.sent) != 1 || !strings.Contains(api.sent[0].text, "не удалась") {
+		t.Errorf("sent = %+v", api.sent)
+	}
+	if !api.sent[0].hasKB { // кнопка повтора
+		t.Error("уведомление о падении без клавиатуры повтора")
+	}
+}
+
+func TestBot_CallbackRetry(t *testing.T) {
+	b, _, _, rev := newTestBot(t, []int64{7})
+	rev.data = reviewData(store.StateFailed)
+	b.handleCallback(context.Background(), cbFrom(7, "retry:5"))
+
+	if len(rev.retried) != 1 || rev.retried[0] != 5 {
+		t.Errorf("retried = %v", rev.retried)
+	}
+}
+
 func TestParseCallback(t *testing.T) {
 	a, id, v := parseCallback("type:5:series")
 	if a != "type" || id != 5 || v != "series" {

internal/tgbot/render.go

@@ -31,6 +31,10 @@ func (b *Bot) renderCard(rd *worker.ReviewData) (string, *tgbotapi.InlineKeyboar
 		if msg := rd.Download.ErrorMsg.String; msg != "" {
 			text += "\n" + msg
 		}
+		// failed/stuck — даём кнопку повтора; остальное только «в вебе».
+		if state == store.StateFailed || state == store.StateStuck {
+			return text, b.retryKeyboard(id)
+		}
 		return text, b.webOnly(id)
 	}
 }
@@ -111,6 +115,41 @@ func (b *Bot) renderDesync(rd *worker.ReviewData, event worker.NotifyEvent) stri
 	}
 }
 
+// renderFailed — уведомление об упавшей/зависшей задаче с кнопкой повтора.
+func (b *Bot) renderFailed(rd *worker.ReviewData) (string, *tgbotapi.InlineKeyboardMarkup) {
+	id := rd.Download.ID
+	var sb strings.Builder
+	verb := "не удалась"
+	if rd.Download.State == store.StateStuck {
+		verb = "зависла"
+	}
+	fmt.Fprintf(&sb, "❌ Задача #%d %s", id, verb)
+	if code := rd.Download.ErrorCode.String; code != "" {
+		fmt.Fprintf(&sb, " (%s)", code)
+	}
+	sb.WriteString(".")
+	if msg := rd.Download.ErrorMsg.String; msg != "" {
+		sb.WriteString("\n")
+		sb.WriteString(msg)
+	}
+	if src := contextOrSource(rd); src != "" {
+		fmt.Fprintf(&sb, "\nИсточник: %s", shorten(src, 80))
+	}
+	return sb.String(), b.retryKeyboard(id)
+}
+
+// retryKeyboard — клавиатура для failed/stuck: повтор + опц. ссылка в веб.
+func (b *Bot) retryKeyboard(id int64) *tgbotapi.InlineKeyboardMarkup {
+	row := []tgbotapi.InlineKeyboardButton{
+		tgbotapi.NewInlineKeyboardButtonData("🔄 Повторить", "retry:"+itoa(id)),
+	}
+	if url := b.reviewURL(id); url != "" {
+		row = append(row, tgbotapi.NewInlineKeyboardButtonURL("🌐 В вебе", url))
+	}
+	kb := tgbotapi.NewInlineKeyboardMarkup(tgbotapi.NewInlineKeyboardRow(row...))
+	return &kb
+}
+
 func (b *Bot) webOnly(id int64) *tgbotapi.InlineKeyboardMarkup {
 	url := b.reviewURL(id)
 	if url == "" {