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

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

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

---

## 1. СЛЕДУЮЩАЯ ЗАДАЧА: зацеп в ПАДЕНИИ (вход на уровень 7)

Уровень 6 пройден и принят: спецсобытие с тенью работает, переход на уровень
7 падением работает.  Но **вход на 7-й ломается на механике**: Кид влетает в
комнату сверху и, пролетая мимо края пола, ДОЛЖЕН иметь возможность
зацепиться за него руками.  Похоже, этого у нас нет вовсе — проверить и
реализовать.

Куда смотреть: `check_grab` / ветка `action == actions_3_in_midair` в
seg005-seg006 SDLPoP (у нас `POP_ENABLE_JUMP_GRAB` и `check_grab_run_jump`
в `pop_map.c` — это ДРУГОЙ случай, зацеп из прыжка).  Начинать, как всегда,
с чтения оригинала, а не с догадок.

Опора: вход падением уже портирован — `FALLING_ENTRY_LEVEL/ROOM` в
`pop_guard.h` + ветка в `pop_start_level` (`roomtest.c`), Кид появляется в
комнате 17 и экран сразу переводится на комнату под ней.

## 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`](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`](../docs/shadow_render.md).

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

- **[FORE-DUP](BUGS_OPEN.md#fore-dup)** — передний слой тайла рисуется дважды
  при перекрытии объектов (Кид+отражение всегда, Кид+соперник — весь ближний
  бой).  Картинку не портит, тратит такты.  **Сначала замерить, потом
  чинить** — окно клипа в своё время дало 3.2×.
- **[DIED-ON-BUTTON](BUGS_OPEN.md#died-on-button)** — `died_on_button`
  (seg007:776) не портирован.
- **TORCH-ANIM-RIGHT** — под запечённым пламенем могут застыть пики/меч/зелье
  справа от факела; на уровнях 1-4 такого соседства нет.
- **GUARD-PHYS ЗАКРЫТ** 2026-08-11: нажатие напольной кнопки НЕ-Кидом
  проверено живьём на уровне 6 (тень встаёт на `closer` и роняет решётку).
- **[GATE-FORE-KID](BUGS_OPEN.md#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.