(new): support Bot API 10.3

(fix): finalize v2 contracts
(tests): cover v2 migration
(doc): prepare release guidance

README_RU.md

@@ -31,13 +31,7 @@
 ## 📦 Установка
 
 ```bash
-go get git.scuroneko.dev/scuroneko/laniakea
-```
-
-или
-
-```bash
-go get github.com/scuroneko/laniakea
+go get git.scuroneko.dev/scuroneko/laniakea/v2@v2.0.0-rc.1
 ```
 
 ## 🚀 Быстрый старт (с пошаговыми комментариями)
@@ -49,7 +43,7 @@ package main
 import (
 	"log"
 
-	"git.scuroneko.dev/scuroneko/laniakea" // Импортируем библиотеку Laniakea
+	"git.scuroneko.dev/scuroneko/laniakea/v2" // Импортируем библиотеку Laniakea
 )
 
 // echo — это функция-обработчик команды.
@@ -270,32 +264,32 @@ import (
 
 // Одноразовый раннер — запускается один раз в горутине при старте (по умолчанию).
 bot.AddRunner(
-    laniakea.NewRunner("seed-cache", func(b *laniakea.Bot[*MyDB]) error {
-        return b.GetAppData().SeedCache()
-    }),
+	laniakea.NewRunner("seed-cache", func(ctx context.Context, b *laniakea.Bot[*MyDB]) error {
+		return b.GetAppData().SeedCache(ctx)
+	}),
 )
 
 // Периодический раннер — запускается каждые 10 минут в горутине.
 bot.AddRunner(
-    laniakea.NewContextRunner("refresh-stats", func(ctx context.Context, b *laniakea.Bot[*MyDB]) error {
-        return b.GetAppData().RefreshStats(ctx)
-    }).Every(10 * time.Minute),
+	laniakea.NewRunner("refresh-stats", func(ctx context.Context, b *laniakea.Bot[*MyDB]) error {
+		return b.GetAppData().RefreshStats(ctx)
+	}).Every(10 * time.Minute),
 )
 
 // Синхронный одноразовый — блокирует запуск runtime до завершения.
 bot.AddRunner(
-    laniakea.NewRunner("migrate", func(b *laniakea.Bot[*MyDB]) error {
-        return b.GetAppData().Migrate()
-    }).Async(false),
+	laniakea.NewRunner("migrate", func(ctx context.Context, b *laniakea.Bot[*MyDB]) error {
+		return b.GetAppData().Migrate(ctx)
+	}).Async(false),
 )
 ```
 
 Методы builder:
-- `Async(bool) *Runner[T]` — если `true` (по умолчанию), запускается в горутине; если `false`, блокирует запуск runtime.
-- `Every(time.Duration) *Runner[T]` — задаёт интервал повторного запуска. Ноль (по умолчанию) означает одноразовый запуск; положительное значение — периодический. Периодические раннеры требуют `Async(true)`.
+- `Async(bool) Runner[T]` — если `true` (по умолчанию), запускается в горутине; если `false`, блокирует запуск runtime.
+- `Every(time.Duration) Runner[T]` — задаёт интервал повторного запуска. Ноль (по умолчанию) означает одноразовый запуск; положительное значение — периодический. Периодические раннеры требуют `Async(true)`.
 
-Для I/O и блокирующей работы предпочитайте `NewContextRunner`. Его context
-отменяется при остановке polling или webhook runtime, поэтому shutdown может завершиться.
+Каждый runner получает context, который отменяется при остановке polling или
+webhook runtime. I/O и блокирующие операции должны передавать его во вложенные вызовы.
 
 ### tgapi: API и Uploader
 
@@ -362,7 +356,7 @@ func adminOnlyMiddleware(ctx *laniakea.MessageContext, db *MyDB) bool {
 
 ## ⚙️ Расширенная настройка
 - **Инлайн-клавиатуры**: Создавайте клавиатуры с помощью `laniakea.NewInlineKeyboardJSON`, `laniakea.NewInlineKeyboardBase64` или `laniakea.NewInlineKeyboard`. `Bot.SetPayloadType(...)` задаёт payload format по умолчанию, а `InlineKeyboard.SetPayloadType(...)` переопределяет его для конкретной клавиатуры.
-- **Валидация клавиатур**: Вызывайте `InlineKeyboard.GetValidated()` перед отправкой недоверенных или динамически собранных callback payload; Telegram ограничивает `callback_data` диапазоном 1–64 байта.
+- **Валидация клавиатур**: `InlineKeyboard.Get()` проверяет все кнопки и строки перед возвратом markup; Telegram ограничивает `callback_data` диапазоном 1–64 байта. Для явного отключения автоматического переноса используйте `SetUnlimitedRows()`.
 - **Ограничение запросов**: Передайте настроенный `utils.RateLimiter` через `BotOpts` для корректной обработки лимитов Telegram.
 - **Observer**: Во время runtime callbacks observer выполняются асинхронно и по порядку через ограниченную очередь. Медленный observer не блокирует handlers; при переполнении события отбрасываются с редкими предупреждениями, а shutdown обрабатывает уже поставленные в очередь события.
 - **Локализация**: `L10n` безопасен для конкурентного использования после подключения к боту.
@@ -379,7 +373,7 @@ func adminOnlyMiddleware(ctx *laniakea.MessageContext, db *MyDB) bool {
 Этот проект лицензирован под GNU General Public License v3.0 - подробности см. в файле [LICENSE](LICENSE).
 
 ## 📚 Дополнительная информация
-[GoDoc Laniakea](https://pkg.go.dev/git.scuroneko.dev/scuroneko/laniakea)
+[GoDoc Laniakea](https://pkg.go.dev/git.scuroneko.dev/scuroneko/laniakea/v2)
 
 [Wiki](https://git.scuroneko.dev/ScuroNeko/Laniakea/wiki)