feature(lookup): добавить Yandex fallback и ISBN hint flow

[gman-dev-nov]

Что изменилось

Добавлен дополнительный путь поиска книги через Yandex с Playwright, а также интерактивный ISBN hint flow в Telegram.

Теперь если стандартная цепочка lookup не находит книгу по ISBN, бот:

1. пробует дополнительный поиск через Yandex;
2. если результата все равно нет, просит у пользователя короткую текстовую подсказку;
3. повторяет поиск с учетом этой подсказки.

Зачем это нужно

На практике встречаются ISBN, которые не находятся через основные каталоги или находятся нестабильно. Из-за этого пользователь упирался в тупик: ISBN есть, а бот не может собрать карточку книги.

Новый flow нужен как safety net:

• сначала используется дополнительный автоматический источник;
• если он не помог, пользователь может уточнить контекст без ручного заполнения всей книги.

Что получает пользователь

• меньше тупиковых сценариев при добавлении книг;
• выше шанс найти книгу по редким или плохо индексируемым ISBN;
• более понятный и управляемый сценарий, когда автоматический поиск не справился с первой попытки.

Технически

• добавлен Yandex provider;
• добавлен общий _serp_parser.py для переиспользуемой логики разбора поисковой выдачи;
• расширена lookup-цепочка;
• в Telegram добавлен pending_isbn_hint flow;
• обновлены e2e- и provider-тесты;
• добавлена документация и настройки для опционального Playwright-пути.

Ограничения

• Yandex fallback опционален и активируется только при YANDEX_ENABLED=1;
• для него нужен установленный playwright и playwright install chromium;
• если Playwright не включен, бот по-прежнему корректно работает, просто пропускает этот шаг.

Проверка

• venv/bin/python -m pytest tests/test_home_library_providers.py tests/test_home_library_e2e.py -q

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ee2d85482b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Preserve pending ISBN hint until input is successfully handled

pending_isbn_hint is removed before validating/processing the hint, so an empty message or a transient lookup failure drops the flow immediately. In these cases the bot tells the user to try again, but the next message is treated as a normal search because the pending state is already gone. This makes the new hint flow brittle and user-visible retries impossible without rescanning the barcode.

Useful? React with 👍 / 👎.