Sprinter-SDCC/applications/PoP/roomtest/NEXT_SESSION.md

Точка входа для следующей сессии (обновлено 2026-08-12, вечер)

Файл для старта с чистого контекста: где всё стоит, что делать первым, какие грабли уже собраны. Читать целиком — он короткий. Дальше по ссылкам: TASKS_OPEN.md (доска), BUGS_OPEN.md (открытые баги), CLAUDE.md.

---

1. СЛЕДУЮЩАЯ ЗАДАЧА: smoke-прогон уровня 8

Зелья приняты пользователем (уровень 2 — «−HP», уровень 7 — перо), уровень 7 считается прошедшим smoke. Спецсобытие уровня 8 — L8-MOUSE — закрыто 2026-08-12: мышь портирована, покрыта хост-набором t_mouse (17 проверок) и проверена живьём в MAME (появилась, нажала кнопку (0,7) комнаты 16, решётка (0,3) поехала вверх, ушла и погасла). Новых тайлов уровень 8 не приносит вовсе.

Осталось пройти сам уровень: он длинный, с возвратом через два чомпера комнаты 4, и стражи там сильнее прежних — комната 5 держит skill 7 (максимум из встречавшихся), комнаты 12/22/24 — skill 2/3/3.

Правило появления мыши (сверено с оригиналом, детали в TASKS_CLOSED): счётчик — сам leveldoor_open, растёт только пока Кид в комнате 16, срабатывание ровно на 150, второго раза нет; сбрасывает только рестарт уровня. Тупика это не создаёт — низом через провал есть путь к двери уровня ценой 1 HP.

Резидент разгружен (MEM-COLD1): холодная половина главного цикла уехала в банк 8 (roomtest_cold.c), куча 879 → 1707 Б. Следующие кандидаты — MEM-COLD2.

Ощущенческий хвост прежний — GRAB-KBD-TIMING, разбирается после готовности всех уровней (решение пользователя).

2. Состояние репозитория

Всё закоммичено, main чист. tests-host: 6 наборов проходят ([char] 65, [geom] 3144, [grab] 55, [mouse] 17, [phys] 1727, [wall] 1). make size-check: OK (65 программ, роста нет).

Коммиты 2026-08-12:

хеш	что
b5951c9	зацеп за кромку нижнего ряда: do_fall пускает ряд до 3 + check_grab в midair
d7d18ae	зелье медленного падения (перо) + цвет пузырьков по типу зелья

Раньше (2026-08-11, вечер): abe4a83 уровень 5, 740cc6d арка у ворот, e4ef489 L6-SHADOW, 9ecea17 уровень 6 → 7.

Уровни 1-6 проходятся.

3. Состояние окружения

• MAME запущена с мостом, на HDD — roomtest, собранный с -DFIRST_LEVEL=8. ПРАВИЛО ПОЛЬЗОВАТЕЛЯ: перед сборкой образа — make clean, потом make, потом make hdd (memory mame_build_clean_rule). Без этого make hdd кладёт на диск ПРОШЛУЮ сборку: FIRST_LEVEL живёт внутри roomtest.c, и без изменения исходника make считает .exe актуальным — 2026-08-12 на этом уехал уровень 1 вместо 8, заметил пользователь. После пересборки образа MAME обязана пройти полный рестарт (memory mame_hdd_rebuild_restart).
• Адреса состояния сместились после MEM-COLD1: брать из .sprinter-cc-roomtest/roomtest.map заново (cur_room 0xA33D, pop_leveldoor_open 0xA34C, Kid 0xA3B1, Guard 0xA759 — на сборку 2026-08-12). Мост: setmem ADDR HEXBYTES (не write), mem ADDR N.
• Остановка MAME — mame/v306/bridge_cmd.sh 'cmd exit', НЕ kill (правило пользователя). pkill -f бывает не срабатывает, и остаются ДВА инстанса, оба отвечающих на файловый IPC — тогда скриншоты приходят от чужой машины. Проверять pgrep -f mame.arm после остановки.
• Прогон без MCP-инструментов: запустить run_bridge.sh → sleep 6 → bridge_cmd.sh 'cont' → sleep 8 → keyseq d:{ENTER} → keyseq roomtest{ENTER} → snap <путь>.png. Тайминги — правило пользователя, длиннее ставить не надо. Имя .exe на образе — не длиннее 8 символов (FAT 8.3) и БЕЗ подчёркивания (keyseq не умеет _).
• Вести игру из моста — по обратной связи из памяти, а не по скриншотам: mem 0xA46A 10 = pop_char_t Кида, mem 0xA3F7 1 = номер комнаты (адреса из .sprinter-cc-roomtest/roomtest.map+.sym). Полный рецепт (удержания, чит-навигация, тайминги нажатий) — memory mame_mcp_bridge.
• MCP-инструменты mame-z80 не поднимались: сервер падал на ModuleNotFoundError: mcp.server.fastmcp — вышел mcp 2.0, где FastMCP переехал. В ~/.claude.json зафиксировано --with "mcp<2"; подхватится при следующем СТАРТЕ сессии Claude (внутри текущей — нет).
• SDLPoP собран с отладочной информацией (-O0 -g3); pkg-config на машине нет, команда сборки — в истории этого файла (git log -p).
• НЕ ПРИБРАНО: в SDLPoP/src/seg008.c диагностический fprintf с меткой DBGMIRROR в начале add_objtable (гейтится по obj_type == 1 || == 4).

4. Что сделано в libbgi и чем это полезно дальше

Блочные операции акселератора — полный набор AND/OR/XOR/NOT, строками и колонками: gfx_blit_op / gfx_blit_part_op, gfx_blit_cols_op / gfx_blit_cols_part_wx_op (клип-окно и флип — как у копирующих близнецов), опкод патчится SMC. putimage лишился попиксельного пути целиком (закрыт пункт 2d-1 docs/TODO.md). Регресс — tests/accop (10/10 PASS в MAME, побайтно). Механика и три ловушки — memory accel_block_ops; главные: операция читает ОЗУ-КОПИЮ экрана (не VRAM), а прозрачность #FF совместима с AND/OR, но не с XOR.

Вид тени (OR+XOR) отложен до готовности всех уровней — разбор, замеры и варианты в ../docs/shadow_render.md.

5. Остальное открытое

• FORE-DUP — передний слой тайла рисуется дважды при перекрытии объектов (Кид+отражение всегда, Кид+соперник — весь ближний бой). Картинку не портит, тратит такты. Сначала замерить, потом чинить — окно клипа в своё время дало 3.2×.
• DIED-ON-BUTTON — died_on_button (seg007:776) не портирован.
• TORCH-ANIM-RIGHT — под запечённым пламенем могут застыть пики/меч/зелье справа от факела; на уровнях 1-4 такого соседства нет.
• GUARD-PHYS ЗАКРЫТ 2026-08-11: нажатие напольной кнопки НЕ-Кидом проверено живьём на уровне 6 (тень встаёт на closer и роняет решётку).
• GATE-FORE-KID — Кид в проёме ворот виден поверх решётки; портирован только шовный случай.
• Долгие: BUG-SPIKE-1, BUG-CHOMP-JUMP-1 (оба низкий приоритет), L3-COLOR, L1-SPEED (игра на ~39 % быстрее оригинала), TUNE-1.

6. Грабли, собранные 2026-08-12

• Тест, который «проходит» и на сломанном коде, ничего не стоит. Первая версия регресса на спуск-зацеп засчитывала ЛЮБОЙ вис — а Кид на первых кадрах падения цепляется обратно за ту же верхнюю кромку. Признак цели обязан быть позиционным. Проверять новый регресс откатом фикса — обязательно.
• action == 3 (midair) — это не только падение: кадры спуска seq_68 тоже идут с ним. Ждать «начала падения» по одному action нельзя.
• Клавиши, зажатые из моста, переживают точечный release: плагин переустанавливает удержания каждый кадр, и после серии hold осталось 6 незакрытых входов — у пользователя «Кид ходит как с зажатым Shift». Заканчивать работу с вводом только pause + cont (release_all).
• Чит-навигация +/− теряет нажатия и роняет Кида из комнат без пола: уровень 7 из комнаты 17 всегда сваливается в 1, и кольцо − до комнаты 14 не доходит никогда. Ходить циклом с проверкой номера комнаты.

Грабли 2026-08-10/11

• Не оценивать железо по своей же memory-заметке. Заявил, что accel умеет только копирование и XOR потребует ~25 % кадра на CPU — неверно, поправил пользователь. Заметка описывала копирование, я принял её неполноту за свойство железа. Проверять по драйверу MAME (mame/sources/MAME/src/mame/sinclair/sprinter.cpp) и docs/new/06-accel.md.
• lldb через FIFO — плохая идея. Повторяющиеся -o при breakpoint command add записываются НЕПОЛНЫМИ. Работает надёжно: fprintf(stderr, ...) прямо в SDLPoP, пересборка (секунды) и чтение stdout.
• make без hdd не обновляет образ MAME, а FIRST_LEVEL живёт в roomtest.c — при смене нужен touch roomtest.c.
• Доска отставала от кода на три задачи (L3-CHOMP, L3-SKEL, шаги 3/5 L4-MIRROR значились несделанными). Перед планированием — сверять TASKS_OPEN.md с кодом грепом, а не верить записи.
• Диапазон obj_x = −416..695 (посчитан из kid_data.bin). Пригодится всякий раз, когда нужна таблица по экранной X.