- ids.ts: флаг FLAGS.evening; граф elder_hand_in.json ставит его узлом accept
  («вернусь до темноты» — контент-driven, валидатор держит флаг упомянутым)
- LightingDef.nightAmbient: GameLighting.update ведёт ночную цель ambient
  (guard по последней цели, фейд 6 c); лампа героя — в тёмной области или вечером
- тёмные ауры зон наката: пятно на каждый тайл HazardDef (multiply под светом)
- виньетка: низкий hp (0.3) / накат без полотна (0.35), фейд 0.5 c
- импульсы: combat:hurt → тёплая вспышка в точке врага, резонанс → вспышка
  у героя + подъём ambient, урон герою → красная вспышка на весь экран
- LocationScene: maxLights: MAX_LIGHTS (движковый пул больше не теряет
  источники), setTileTracked — индекс layerTilePos живой при смене тайлов
- мост: scene:damagePlayer (полный боевой путь), снапшот lighting.vignette,
  инвариант lighting-bounded расширен виньеткой 0..1
- доки: agent.md (vignette/scene:damagePlayer), practices.md (ночь = флаг,
  импульсы = тот же пул)

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

- data/locations.ts: LightSourceDef/LightingDef (ambient + источники at/tiles,
  радиус в юнитах, цвет/интенсивность/мерцание, whenFlag/notFlag), поле lighting в AreaDef
- systems/Lighting.ts: GameLighting — сборка активных источников (статика +
  runtime add/remove + лампа героя в тёмных областях), проекция camera.toScreen
  каждый тик, детерминированный seed мерцания по id, снапшот для моста
- LocationScene: lightView в renderer.lightRoot, тик света до ранних выходов
  (свет живёт в диалогах/катсценах), зачистка в exit()
- агентный мост: слой lighting {ambient, sources}, инвариант lighting-bounded
- движок: Lighting.destroy принимает опции (делегирует в Container)

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

- DialogueSystem.pickChoiceByText(text) — выбор варианта по тексту реплики
  (реплики героя в графе — выборы по библии мира; elder_first теперь ветвится)
- DialogueSnapshot += mood/tags/path — снапшот показывает настроение и путь
  прохождения графа
- мост: команда сцены scene:pickChoiceByText, GameAgent.pickChoiceByText
  (ждёт waitingForChoice, берёт по тексту), прокси AgentClient (+timeout
  у runDialogue)
- новый checks/quest-bells.mjs — полный цикл квеста «Три цветка»: взятие
  у Ирвина выбором по тексту -> сдача (кат-сцена посадки, цветы списаны)
  -> Мила (полотно из do[] в сумке) -> эпилог trader_after; входит в agent:check
- доки: agent.md (снапшот диалога, команды, API), practices.md (typewriter
  и выбор в сценариях; метод моста = 3 места), в том же коммите

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

Расталкивание через реестр сцены: герой выталкивает себя из NPC
(PlayerController), враг — из героя, NPC и своих (EnemySystem); каждый
актор двигает только себя (separateCircles). attackStop (0.85) больше
суммы радиусов — авто-атака не дрожит.

A* не ведёт героя сквозь тело: SceneObjects.walkGrid() считает тайлы
NPC занятыми (герой застревал «на носу» у Ирвина — звон в верёвку
не поднимал флаг). Проводка: клик по миру, авто-подход к цели,
scene:route моста.

Карта коллизий агенту: слой s.collision {width, height, blocked (0/1
с footprint пропов), props} + команды scene:walkable {x, y} и
scene:raycast {from, to} (прямая видимость, вода прозрачна). Новый
сценарий checks/collision.mjs: слой валиден, walkable/raycast на
конкретных тайлах, клик в дерево — герой в проходимом, телепорт в
тело спящего ползуна — враг выталкивает себя.

Доки: agent.md (слой + 2 команды), practices.md (ситуация «проверяю
коллизии/движение» + грабли телепорта на тайл перехода).

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

- testing/ (только для *.test.ts, в бандл не попадает):
  combatWorld.ts (fakeMap/fakeWorld/run/far), gameState.ts (fakeState),
  maps.ts (mapWithWall). EnemyAI/los/Interactables тесты переведены —
  бойлерплейт фейковых карт/стейтов выведен из трёх файлов.
- GameAgent.waitFor: top-level обращения s.<ключ> сверяются с
  AGENT_SNAPSHOT_KEYS до компиляции предиката; неизвестный ключ ->
  { ok: false, error: 'неизвестный ключ s.X', ticks: 0 } — опечатка
  больше не тихий false на весь таймаут. predKeys — чистая функция,
  тестируется в snapshot.test.ts.
- Список ключей: ENGINE_SNAPSHOT_KEYS (движок) + сценические + слой игры;
  анти-дрейф тесты держат список согласованным со слоями снапшота.

Проверки: typecheck, 307 тестов (+6), agent check 45/45 (ни один чек
валидация не отторгла), smoke-act1. Доки: agent.md (поведение waitFor),
practices.md (проверка сценариев).

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

LocationScene (1169 строк) — god-object: каждая фича трогала один файл.
Сцена остаётся оркестратором вьюх, логика переезжает в два модуля:

- systems/ClickRouting.ts: чистый резолвер приоритетов resolveClick
  (NPC → клик-переход/заперто → интерактив → цветок → враг → движение)
  с юнит-тестами без Pixi + рантайм InteractionRouter (пути, отложенные
  взаимодействия, step-переходы с дисармом тайла входа). Сцена получает
  его deps-объектом и колбэками (talkTo/collectFlower/useTransition и
  др. остаются в сцене — они трогают вьюхи/катсцены/смену сцен).
- agent/SceneAgentView.ts: агентный фасад (снапшот/инварианты/команды),
  слои снапшота собираются фабриками snapshot.ts — дублирование слоёв
  невозможно. LocationScene implements SceneAgent → 3 однострочника.

Попутно: TransitionSnapshot получает типизированное поле trigger
('step' | 'click') — фактический объект его уже клал.

Сцена: 1169 → 823 строки. Проверки: typecheck, 301 тест, agent check
45/45, smoke-act1. Доки: CLAUDE.md, practices.md (ситуация «меняю
клик-роутинг / агентный мост сцены»).

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

- Интерьеры house_elder/shop: buildInteriorMap (тайлы FLOOR/WALL), двери
  кликом внутрь, выход через проём (transition kind 'return' по returnTo).
- InteractableDef/INTERACTABLES: реакции по when (flag/notFlag/varAtLeast),
  once -> флаг used:<id>, эффекты setFlags/clearFlags/setVar/gives/sound.
- Системы: resolveInteractable (чистый) + Interactables (InteractSink);
  pendingInteraction в LocationScene, подписи объектов при близости.
- Сундук/очаг/записка (дом Ирвина), прилавок (лавка Милы).
- Снапшот interactables; GameAgent.waitFor ждёт по полному снапшоту игры.
- Валидатор: переходы в существующие области + объекты в границах.
- Сейвы v3 (returnTo), миграция v1/v2.
- Исправление: колодец (22,20) перенесён в buildMeadowsMap (индекс 582
  за пределами 28x20 молча дорастал массив).
- Сценарий tools/checks/interact.mjs (7 проверок); тесты резолвера/рантайма.
- Доки: agent.md (waitFor по полному снапшоту, валидация), practices.md
  (ситуация «интерьер/объект»), demo.md, CLAUDE.md.

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

Движок (packages/engine/src/agent/):
- types.ts: SceneAgent/AgentHost/Invariant/SnapshotLayer — каркас жанронезависим
- EngineAgent: снапшот+инварианты, step/waitFor, атомарные tapVirtual/press/key
- invariants.ts: checkFinite/checkRange/checkBounds/checkWalkable
- Engine.stepTick/stepTicks/tickCount; GameLoop.setManual/resetTiming
- InputManager.inject*: инъекция через те же структуры ввода
- DialogueRunner: nodeId/choices/waitingForChoice раскрыты для снапшота

Игра (apps/game):
- agent/GameAgent.ts: window.__agent (DEV): snapshot/step/waitFor/walkTo/runDialogue
- agent/snapshot.ts: чистые слои hero/enemies/npcs/dialogue/game
- data/validate.ts: runtime-валидация контента → Invariant[] (нашла 4 врага на воде)
- сцены реализуют SceneAgent: whitelist-команды, lastToast в снапшоте

Инструменты и доки:
- tools/agent-lib.mjs (openGame/AgentClient/Checks), tools/agent.mjs (CLI check/run/snapshot/screenshot/dev)
- tools/checks/agent-invariants.mjs; смоуки переписаны на мост; maps:fresh в gen.test.ts
- docs/llms.txt, docs/engine/agent.md, docs/engine/practices.md (живой документ)
- CLAUDE.md, docs/engine/README.md, docs/demo.md обновлены

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