Поддержать MAME.HT/sprinter в SDK и документации

docs/project-reorganization.md

@@ -18,7 +18,8 @@ MAME приложению не нужны.
 ```text
 ~/Projects/DIY/Z80/Sprinter/
 ├── C-Compiler/                  # Sprinter-CC
-├── MAME/                        # fork MAME, сборки и локальная среда запуска
+├── MAME/                        # прежний fork MAME 0.287, локальные ресурсы
+├── MAME.HT/                     # новый fork Holub/Tolik, сборка sprinter
 ├── Examples/                    # один Git-репозиторий примеров
 ├── Applications/                # каталог без собственного Git
 │   ├── SprPoP/                  # самостоятельный Git-репозиторий
@@ -45,6 +46,7 @@ MAME приложению не нужны.
 | PoP-Archive | `716c639` | `54d0b3d` |
 | VSCode-Sprinter | `68a821e` | `abfc29d` (`901d91a` — функциональные изменения) |
 | MAME | baseline `b0c4527c`, backend/MCP `fe7ee37a` | `37b89b78` |
+| MAME.HT | Holub/Tolik `7f64914880f`, backend `46e89112836`, plugin `1188177a516` | `e0c509c7150` (перенос рецептов и исправление раннего MCP callback) |
 
 Первые пять base-коммитов получены из подготовительного коммита Sprinter-CC
 через `git subtree split`; поэтому их история прослеживается до исходного
@@ -55,7 +57,8 @@ MAME приложению не нужны.
 | Проект | Что остаётся/переходит | Причина |
 |---|---|---|
 | Sprinter-CC | `bin/`, `runtime/`, `libc/`, `libbgi/`, `lib/`, общие `toolchain/`, `tests/`, `testkit/`, `app.mk`, справочник API, платформенные исследования, `release_docs/`, рецепт SDCC в `third_party/` | Это target SDK, его ABI, инструменты и собственные регрессионные тесты. libc/libbgi пока остаются вместе: их версия и ABI тесно связаны с `sprinter-cc`; дальнейшее выделение возможно после стабильного интерфейса. |
-| MAME | Выделенный `../MAME` со своим Git, изменения драйвера/OSD, патч debugger backend, общие `mamebridge` и `mame_mcp.py`, рецепты stock/sdbg сборок | Изменения ядра и общий транспорт MCP должны проверяться и выпускаться вместе с конкретной ревизией MAME. |
+| MAME | Прежний `../MAME` 0.287 и локальные ROM/DSS/CHD, пока новая среда не подготовлена | История проверенной сборки и ресурсы остаются доступными для сравнения и совместимости. |
+| MAME.HT | Новый `../MAME.HT` Holub/Tolik: драйвер, OSD, backend `sdbg`, raw `mamebridge`/`mame_mcp.py`, рецепты stock/sdbg с выходом `sprinter` | Это активный исходный fork; его нельзя подменять исходниками MAME 0.287, а патчи и бинарники проверяются на его собственной базе. |
 | Examples | Выделенный `../Examples`: `balls`, `mdview`, `mdview2`, `rpgwalk`, `scroll`, `space` и относящиеся к ним ресурсы/документы | Это демонстрации SDK с общей версией. Один репозиторий избегает множества мелких релизов. |
 | SprPoP | Всё из прежнего `applications/SprPoP/`: исходники, конверторы, тесты, собственные ресурсы и планы | Уже почти автономное приложение; оригинальные ресурсы и дальше остаются внешними. |
 | Volkov | Всё из прежнего `applications/Volkov/`: исходники, сценарии MAME, собственные тестовые носители и документы | Продукт и его проверки должны развиваться без дерева тулкита. |
@@ -88,13 +91,15 @@ MAME, а не к его исходникам. Стандартные пути в
 контракт установленной среды и допускают переопределение из окружения, аргументов `make` или
 локального игнорируемого файла настроек. Если `MAME_HOME` не задан,
 необходимые пути можно указать отдельно; отсутствие обоих источников
-диагностировать в цели запуска, не превращая пустое значение в `/mame.arm`:
+диагностировать в цели запуска, не превращая пустое значение в путь от
+корня файловой системы:
 
 ```make
-MAME_BIN              ?= $(MAME_HOME)/mame.arm
-MAME_ROMPATH          ?= $(MAME_HOME)/roms
-MAME_DSS_IMAGE        ?= $(MAME_HOME)/IMG/dss171u.img
-MAME_SYSTEM_HDD_IMAGE ?= $(MAME_HOME)/IMG/sp_hdd_sys.chd
+MAME_HOME             ?=
+MAME_BIN              ?=
+MAME_ROMPATH          ?= $(if $(strip $(MAME_HOME)),$(MAME_HOME)/roms,)
+MAME_DSS_IMAGE        ?= $(if $(strip $(MAME_HOME)),$(MAME_HOME)/IMG/dss171u.img,)
+MAME_SYSTEM_HDD_IMAGE ?= $(if $(strip $(MAME_HOME)),$(MAME_HOME)/IMG/sp_hdd_sys.chd,)
 MAME_BIOS             ?= v3.06
 ```
 
@@ -107,8 +112,13 @@ MAME_BIOS             ?= v3.06
 DAP-launch должны брать один источник настройки, даже если конкретный профиль
 не монтирует DSS-дискету.
 
-`MAME_HOME/mame.arm` — стандартный установленный бинарник, а stock/sdbg
-сборки находятся отдельно и выбираются явным `MAME_BIN`. Сборка одного
+В новом `MAME.HT` команда
+`make SUBTARGET=sprinter SOURCES=src/mame/sinclair/sprinter.cpp` создаёт
+`sprinter`, не `mame.arm`. SDK при наличии `MAME_HOME/sprinter` выбирает его;
+для прежних установок сохраняется `MAME_HOME/mame.arm`. Явный `MAME_BIN`
+имеет приоритет и позволяет запускать `MAME.HT/sprinter` со старым каталогом
+ROM/DSS без копирования образов. Stock/sdbg сборки находятся отдельно и
+выбираются явным `MAME_BIN`. Сборка одного
 варианта не перезаписывает другой и не меняет молча активный бинарник.
 Для запуска с нетипичной установкой можно переопределить каждый путь, не
 копируя ROM/CHD в каталог приложения. Все цели запуска валидируют свои