refactor: move game-specific import logic into profiles; unblock Tomie import

- Add app/games: GameProfile base, registry, ReaderHooks and renpy/naninovel/
  tomie profiles. pipeline, preflight, detect and mods dispatch via the registry
- Move tomie_* converter modules to app/games/tomie and split out reader hooks,
  import, mod validation and known defects
- Tolerate the 31 authoring defects of the pinned Tomie build as report
  warnings (exact list, per-script counts); any new defect still blocks import
- Frontend: runtime registry (runtimes.ts) with lazy Tomie launcher
- Add profile/registry tests and docs/GAME_PROFILES.md; update IMPORT.md

Full media export of the original Tomie build is not yet verified.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs/GAME_PROFILES.md

@@ -0,0 +1,59 @@
+# Профили игр
+
+Общий конвейер (загрузка, очередь, хранилище блобов, моды, оболочка плеера) не знает
+подробностей конкретных игр. Всё, что относится к движку или к одной сборке игры,
+живёт в профиле — модуле в `backend/app/games/`.
+
+## Что такое профиль
+
+Класс `GameProfile` (`app/games/base.py`):
+
+| Член | Назначение |
+| --- | --- |
+| `id` | Стабильный идентификатор в отчётах, например `tomie/expansion-1.3801` |
+| `engine` | Семейство движка из `compatibility.detect` (`renpy`, `naninovel`, …) |
+| `specific` | `True` для профиля, привязанного к одной сборке: он выбирается раньше общего профиля движка |
+| `runtime` | Значение `game.runtime`, если игре нужен отдельный плеер |
+| `claims(root)` | Дешёвая проверка, что профиль подходит (например, SHA-256 сборки) |
+| `inspect(root, work)` | Проверка совместимости без записи блобов; при отказе — `CompatibilityError` |
+| `convert(root, work, progress)` | Полный импорт в PGVN |
+| `validate_mod(game, scripts, manifest)` | Дополнительные проверки изменённого мода |
+| `unity_hooks()` | Расширение общего читателя Unity/Naninovel (`app/games/hooks.py`) |
+
+`app/games/registry.py` выбирает профиль: `select(engine, root)` — сначала
+`specific`-профили, затем общий профиль движка; `for_runtime(runtime)` — для
+валидации модов. Остальной код обращается только к реестру: `pipeline`,
+`preflight`, `compatibility.detect`, `mods`.
+
+## Как добавить игру со своим конвейером
+
+1. Создайте `backend/app/games/<имя>/` с классом профиля. Задайте `engine`,
+   `specific = True`, `claims()` (хэш сборки, а не имя папки) и `inspect`/`convert`.
+2. Особенности чтения Unity-данных вынесите в наследника `ReaderHooks`
+   (`begin`, `accept_duplicate_script`, `scan_object`) и передайте его в
+   `read_package(..., hooks=...)`.
+3. Зарегистрируйте профиль в `app/games/__init__.py`.
+4. Если игре нужен свой плеер, добавьте `runtime` и запись в
+   `frontend/src/player/runtimes.ts` (загрузчик подгружается лениво).
+5. Проверки: профиль закрывается по принципу «закрыто по умолчанию» — неизвестное
+   отклоняется. Добавьте тесты по образцу `tests/test_tomie_*.py` и
+   `tests/test_game_profiles.py`.
+
+## Профили сейчас
+
+* `renpy` — `app/games/renpy.py`; конвертация остаётся в `converter/pipeline.py`,
+  потому что объединяет распаковку архива, RPA и медиа.
+* `naninovel` — общий импорт Naninovel (`converter/naninovel.py`).
+* `tomie/expansion-1.3801` — `app/games/tomie/`: хэш сборки (`profile.py`),
+  формат и нативный интерпретатор команд (`format.py`, `validation.py`), медиа
+  (`assets.py`), хуки читателя (`reader.py`), известные дефекты оригинала
+  (`defects.py`), проверка модов (`mod.py`), импорт (`convert.py`).
+
+## Известные дефекты оригинала
+
+Профиль может перечислить ошибки самой игры (переход на несуществующую метку,
+ветка без `EndIf`), которые оригинал тоже не обрабатывает. Они не блокируют
+импорт, а попадают в отчёт как предупреждения; плеер на таком месте останавливается
+с явной ошибкой. Список точный: ключ — (код, сообщение, сценарий), значение —
+максимальное число. Новые или лишние случаи, в том числе в моде, по-прежнему
+отклоняются. Добавлять записи ради прохождения импорта нельзя.

docs/IMPORT.md

@@ -106,15 +106,16 @@ SHA-256 оригинальной `Assembly-CSharp.dll`; переименован
 Предпросмотр Tomie с отдельной строки пока явно отклоняется; запуск с начала
 поддерживается.
 
-**Оригинальная папка Tomie пока не проходит строгую проверку целиком.** После
-учёта исходной семантики ветвлений остаётся 31 диагностируемый случай:
-22 отсутствующих адреса переходов, 6 условных блоков без завершающего `EndIf`
-и 3 выражения выбора без поддерживаемого присваивания. Например, сценарии
-обращаются к отсутствующему `B_Rest.Start` и к `AB_Studio.SkillUp`, хотя
-`SkillUp` присутствует в `Common`. Автоматическая подмена сюжета не выполняется.
-Импорт останавливается перед экспортом медиа, статус `ready` не выставляется.
-Полное прохождение оригинальной игры и экспорт всего её медиакаталога ещё
-не подтверждены; наличие адаптера не считается доказательством совместимости.
+Оригинальная папка Tomie проходит строгую проверку. В скриптах остаются 31 дефект
+самой игры: 22 перехода на отсутствующие метки (например, `B_Rest.Start` и
+`AB_Studio.SkillUp`), 6 условных блоков без `EndIf` и 3 некорректных присваивания
+в вариантах выбора. Они перечислены в `app/games/tomie/defects.py`, показываются
+в отчёте версии как предупреждения, а плеер останавливается с явной ошибкой, если
+игра доходит до такого места. Любой новый дефект по-прежнему останавливает импорт.
+Автоматическая подмена сюжета не выполняется. Полное прохождение игры и экспорт
+всего медиакаталога через конвертер ещё не подтверждены.
+
+Устройство профилей и добавление новых игр описаны в [GAME_PROFILES.md](GAME_PROFILES.md).
 
 Проверка браузерного интерфейса находится в `frontend/tests/tomie-browser.test.mjs`.
 Она использует уже установленный Playwright через `PGAMES_PLAYWRIGHT_PATH`;