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

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

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

---

1. СЛЕДУЮЩАЯ ЗАДАЧА: живая проверка зелий в MAME

Код зелья медленного падения НАПИСАН (все шесть шагов плана TASKS_OPEN.md#l7-feather) и закрыт хост-тестом, но в MAME ещё не смотрелся. Проверить две сцены:

• уровень 7, комната 1 — зелье пера: зелёные пузырьки, зелёная вспышка при питье, спуск в шахту заметно медленнее обычного и без урона;
• уровень 2, комната 13, тайл (1,3) — зелье «−HP»: пузырьки СИНИЕ (были красные — цвет по типу зелья не был портирован вовсе), HP убавляется на единицу, экран краснеет ровно один раз.

Заодно попадают под проверку pop_flash_color (жёлтый/красный/зелёный) и атлас pop_pot (23 → 37 спрайтов: добавлены зелёный и синий наборы кадров пузырька).

Зацеп в падении — закрыт 2026-08-12 (GRAB-BELOW-ROOM). Оказалось, что зацеп из падения был жив, а сломан был спуск через НИЖНЮЮ кромку комнаты (уровень 7, комната 14): do_fall не пускал ряд персонажа до 3, и check_grab на этом отрезке не звался ни разу. Плюс восстановлена ветка ACT_MIDAIR (кадры 102..105 — начало падения). Проверено хост-тестом t_grab и живьём в MAME.

Осталась ощущенческая часть — GRAB-KBD-TIMING: зацеп при входе на уровень 7 срабатывает менее стабильно, чем в оригинале (подозрение на клавиатурный модуль и на общий темп игры, L1-SPEED). Решение пользователя: разбирать после того, как будут готовы все уровни.

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

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

Коммиты 2026-08-11 (вечер):

хеш	что
abe4a83	уровень 5: тень не дерётся, кнопка в шве, узор паласа после зелья
740cc6d	арка у ворот: спецслучай «Lattice + door A» (seg008:622)
e4ef489	L6-SHADOW: тень роняет решётку + кромка ряда ниже
9ecea17	уровень 6: переход на 7-й, портал, многокомнатное падение плиты

Уровни 1-6 проходятся; всё, что пользователь ловил в этой сессии, закрыто и разобрано в BUGS_CLOSED.md (шесть записей за вечер).

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

• MAME запущена с мостом, но на её HDD сейчас лежат ТЕСТЫ libbgi (accop.exe, bgiimg.exe), а не roomtest. Под roomtest пересобрать образ: make hdd (или make PROF_FLAGS="-DFIRST_LEVEL=5" hdd — при смене FIRST_LEVEL нужен touch roomtest.c, иначе не переедет), после чего MAME обязана пройти полный рестарт (memory mame_hdd_rebuild_restart).
• Остановка MAME — mame/v306/bridge_cmd.sh 'cmd exit', НЕ kill (правило пользователя). pkill -f бывает не срабатывает, и остаются ДВА инстанса, оба отвечающих на файловый IPC — тогда скриншоты приходят от чужой машины. Проверять pgrep -f mame.arm после остановки.
• Прогон без MCP-инструментов: bridge_cmd.sh 'cont' → sleep ~45 с (бут DSS) → bridge_cmd.sh 'keyseq d:{ENTER}' → keyseq <имя>{ENTER} → snap /tmp/mame_snap/x.png. Имя .exe на образе — не длиннее 8 символов (FAT 8.3) и БЕЗ подчёркивания (keyseq не умеет _).
• 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-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.