Батч 4: ИИ врагов (LOS, шум, патруль, настороженность, отступление) ...

- los.ts: линия видимости по сетке (дискретизация 0.25 юнита), тайлы с
  tall-объектами непрозрачны; кэш LOS раз в 3 тика в EnemySystem.
- EnemyBrain: состояния patrol/wary/flee/return поверх существующего цикла;
  расширенные сенсоры (pos, canSee, noise, patrolPoints, home, hpFraction);
  бег при отступлении (run в EnemyIntent.move); warySec-таймер.
- CombatWorld.noise(pos, level): шаги героя 0.35, удар конусом 1.0, плевок и
  смерть 0.6; спящих будит только уровень >= 0.7, бодрых слышат от 0.35 в
  hearRadius (окно слышимости 0.5 с).
- Патруль — per-spawn (AREAS[*].enemies patrol {points, pauseSec}): тяжеловес
  и плевун на лугах бродят по маршрутам, ползуны спят в пепле как раньше.
- Поля ИИ в EnemyKindDef + withDefaults; инварианты enemy-state-legal и
  enemy-in-bounds; команды scene:noise и scene:damageEnemy.
- Сценарий tools/checks/ai.mjs (7 проверок) в agent check; 14 новых юнит-
  тестов (EnemyAI) + 6 (los); доки: agent.md, practices.md, demo.md.

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

Батч 3: взаимодействие с миром шире (знаки, моты, колокол) ...

- Предмет mote («Пепельный мот») — зачаток экономики по docs/world.md.
- InteractResponse.addVar: прибавление к вару (подбор мотов копит, не затирает).
- Контент: столбы у троп (луга, пруды, Звенец), три пепельных мота на лугах,
  верёвка колокола башни (флаг rang_tower, повтор с другим текстом).
- Мила: повторный диалог trader_repeat с веткой по вару (whenVar motes >= 1);
  чинён dialogueRepeat (был trader_first — полотно давалось повторно).
- Инвариант interact-used-consistent в мосте: флаг used:<id> <=> снапшот used.
- walkTo моста пропускает узлы-объекты на пути (клик в мот/цветок больше
  не ломает маршрут); docs/agent.md и practices.md обновлены.
- Плейсхолдеры-вью по видам: столб/рычаг/кучка с искрой/ящик.
- Сценарий tools/checks/interact-world.mjs (7 проверок) в agent check.
- Тесты: addVar, ветка trader_repeat (dialogues.test.ts).

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

Батч 2: интерьеры и интерактивные объекты ...

- Интерьеры 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>

Батч 1: единый механизм переходов + телепортация ...

- data/locations.ts: TransitionDef/TransitionTarget/AreaDef/AREAS/areaOf —
  выходы между областями (step) и двери/колодцы (click) в одном механизме
- data/transitions.ts: чистый resolveTransition (триггер, условия
  requiresFlag/requiresItem с lockedText, дисарм тайла входа) + 8 тестов
- LocationScene: checkExits -> checkTransitions, клик-переходы в
  handleWorldClick (NPC -> переход -> остальное), returnTo для kind 'return',
  тост «заперто» без спама, дисарм при входе через переход
- Сейвы v3: SaveData.area + returnTo, normalizeSave для v1/v2
- Новые тайлы FLOOR/WALL/WELL + арт (колодец — бронзовый обруч), WELL на
  карте: парные колодцы Звенец (9,6) <-> луга (22,20), duration 0.2
- Валидатор: переходы вместо exits (существование области, entry проходим)
- tools/checks/transitions.mjs (step + клик туда/обратно + снапшот) в check
- docs: практики (мимо-картная запись в генераторе, async-шаг Checks),
  дорожная карта, легенда колодцев в world.md

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

Батч 0: агентный набор инструментов (мост, валидация, CLI, доки) ...

Движок (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>

Батч 6: CutsceneRunner + кат-сцена сдачи квеста ...

- Движок: packages/engine/src/cutscene/CutsceneRunner.ts — view-агностичный
  раннер шагов (call/cameraMove/burst/wait/setFlag); шаг с seconds: 0 —
  параллельный; 5 тестов.
- Демо: кат-сцена сдачи «Трёх цветков» — посадка → камера к башне →
  удар колокола (звон, shake, кольцо) → зелень → финальный тост.
- Смоук tools/smoke-act1.mjs: полный прогон акта 1 от «Новой игры»
  до кат-сцены (сцелиться в тайл триггера, диалог через Space).
- Доки: docs/engine/cutscene.md, README (карта + структура),
  docs/demo.md (матрица, дорожная карта — следующий срез: телепортация,
  интерьеры, взаимодействие, ИИ врагов), CLAUDE.md (грабля клика вне экрана).

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

пейзажная фауна: безгласные олени и мотыли ...

- спрайты chars/fauna_deer_1/2.png (выцветший, без тёплых пикселей)
  -> атлас chars/fauna_sheet.json, грузится в BootScene
- FaunaSystem: мини-StateMachine (idle/wander/approach) - стоит,
  бродит по соседним тайлам, на громкий звон рядом подходит к источнику
- мотыли: серые частицы, дрейф вверх от точки звона (combat:attack)
- спавны: два оленя на лугах, один у прудов

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

зоны наката у прудов + полотно-маска; починен атлас героя ...

- HazardDef в locations.ts: разметка низин у Серых прудов (требуют cloth)
- герой в накате без маски: скорость x0.5, дымка-оверлей, тост при входе;
  с полотном - только лёгкая дымка
- звон как 'проверка воздуха': резонанс в низине подсвечивает пепел
  вспышками и шипением
- PlayerController.speedMul - множитель скорости, управляется сценой
- фикс: hero_sheet собирался data.set с неверным строковым шагом -
  кадры жались в полосы; теперь построчное копирование

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

локация Звенец: деревня-хаб вокруг башни с колоколом ...

- buildZvenetsMap (28x20): площадь, тропа с лугов, башня-талл 2.5 юнита,
  три дома-талла 1.75 юнита; безопасный хаб без врагов
- спрайты tiles/tower.png и tiles/house.png в генераторе арта
- Ирвин и Мила переезжают в Звенец (диалоги без изменений)
- луга получают обратный переход в Звенец (26,14) с расчисткой
- амбиент-трек music/zvenets: низкий колокольный тон из рельсов
- смоук tools/smoke-zvenets.mjs, чеклист арт-библии и доки

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

квестовая система: декларативные стадии ...

- data/quests.ts переписан: QuestDef/QuestStage, реестр QUESTS;
  состояние квеста — флаги/вары GameState (ставятся графами диалогов);
- API: questTaken/questDone/activeStage, questDialogueFor (диалог NPC
  по активной стадии), questEffectFor (побочные эффекты из стадий +
  знакомства), questLog (журнал с прогрессом);
- LocationScene.talkTo/onDialogueFinished: хардкод-ветки заменены
  квест-моделью (полотно — эффект trader_first);
- тесты: 199/199 (новые — стадии квеста и сумка).

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

сейвы v2 + предметы + инвентарь ...

- движок: Inventory — контейнер Map<id, count> (add/remove/count/has/all,
  onChange), inventoryFromData; тесты;
- Game.inventory: сумка героя, сброс в новой игре;
- SaveData v2: поле version + items, normalizeSave дополняет сейвы v1;
- data/items.ts: реестр предметов (cloth, bellflower, salt, water_flask);
- сбор цветка кладёт bellflower в сумку; полотно выдаётся предметом
  после диалога Милы (флаг got_cloth остаётся меткой);
- InventoryScene: строки сумки из инвентаря (имя + ×N);
- тесты: 192/192.

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

Фаза 5: документация и смоуки мировых юнитов ...

- docs/engine/render.md: преамбула «мир в юнитах, экран в px», Camera
  в юнитах, deadZonePx, правило display-слоя для частиц;
- docs/engine/maps.md: секция мировых юнитов (worldToScreen/screenToWorld/
  unitsToPx), TallSpec.height в юнитах, worldBounds вместо screenSize;
- docs/engine/recipes.md: скелет локации и click-to-move в юнитах;
- docs/engine/README.md: принцип №3 «мир в юнитах, UI в пикселях»;
- docs/demo.md: боевая модель в юнитах;
- CLAUDE.md: правило №4 (две линейки), грабли (ромб/указатель/facing);
- смоуки и пробы пройдены (smoke, smoke-ponds, smoke-quest, walk-probe,
  cam-probe, far-test) — рендер, переходы, квест и камера в норме.

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

Фаза 4: TallSpec.height в мировых юнитах ...

- плейсхолдер-колонна: h = tall.height * iso.tileW (вместо px);
- удалён устаревший map.screenSize (остался worldBounds в юнитах);
- data/map.ts: высота дерева 1.5 юнита (те же 48 px на экране);
- .map-файлы перегенерированы (diff — только height: 48 -> 1.5);
- parseMap отвергает tall.height > 16 как высоту в px (защита от
  протухших карт-файлов);
- тесты: 186/186.

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

Фаза 3: мир игры в мировых юнитах ...

PlayerController, CombatWorld, EnemyBrain, CombatViews и LocationScene
переведены с виртуальных пикселей на мировые юниты (1 юнит = 1 тайл):
- позиции/дистанции/скорости в юнитах (герой 1.75 юн/с, скорости и
  радиусы врагов, knockback 0.75, INTERACT_RANGE 1.5);
- конус/окружности через inConeW/inCircleW (метрика проекции);
- вью-позиции — через worldToScreen, округление до px только на границе;
- гистерезис дистанции плевуна ±0.4 юнита, attackStop 0.85 юнита;
- тесты EnemyBrain/stats обновлены под юниты (185/185).

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

камера: позиция и границы в мировых юнитах ...

- Camera.x/y и bounds в юнитах (1 юнит = 1 тайл); клэмп по экранному
  bbox мирового прямоугольника; deadZone -> deadZonePx (окно на экране)
- IsometricTileMap.worldBounds; LocationScene использует его
- camera.test.ts переписан в юнитах (проверка проекций)

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

движок: мост мировых юнитов (worldToScreen, unitsToPx, метрика проекции) ...

- math/iso.ts: проекция мир↔экран (float, без округления), линейка
  скаляров (tileW px на юнит), метрика проекции (worldLen/worldNorm/
  worldDist/moveTowardsW), тайлы (tileToWorld/worldToTile), bbox
  прямоугольника (worldRectToScreen)
- shapes.ts: inCircleW/inConeW — метризованные варианты
- тесты: world.test.ts (18) + эквивалентность W-вариантов

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

доки: Camera.deadZone/snap и SpriteDebugView ...

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

камера: dead zone (окно следования) + дебаг-просмотр спрайта ...

- Camera.deadZone: цель двигает камеру только у границ окна,
  внутри окна камера неподвижна; Camera.snap — мгновенная постановка
  минуя окно (спавн/респаун)
- SpriteDebugView: текущий кадр героя с целым zoom (nearest) и сеткой
  по границам пикселей (KeyP в локации)
- PlayerController: followPath для готовых путей, currentTexture
- фикс сборки hero_sheet: Buffer.set принимает offset в байтах —
  кадры затирали друг друга, атлас был перемешанным мусором
  (отсюда «сжатый» герой)

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

движок: дистанция взаимодействия + findPathToNeighbor ...

- pathfinding.findPathToNeighbor(grid, start, goal): путь к ближайшей
  проходимой клетке рядом с goal (8-соседство) — цель может быть занята
  NPC/объектом или непроходима; тесты (3 новых)
- PlayerController.followPath: пойти по готовому пути тайлов
- LocationScene: клик по NPC/цветку срабатывает только в радиусе 44px;
  издалека герой подходит к краю тайла и взаимодействие срабатывает
  на месте; исключение — force у requestTalk (сюжетные триггеры)
- доки: maps.md (findPathToNeighbor), demo.md (новое в движке)

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

полировка: плавная камера при ходьбе + кадры походки с бобом туловища ...

- камера следует за непрерывной позицией ног героя, а не за центром
  тайла: в покое картинка та же, в движении нет рывка на границе тайлов
- кадры ходьбы (down/up/side ×2): вторые кадры — туловище на пиксель
  ниже (классический stride/passing боб) — походка читается целиком,
  а не «перестановкой кусочков»
- пробы: tools/walk-probe.mjs (кадры ходьбы), tools/cam-probe.mjs
  (сэмплы worldRoot — движение монотонное)

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

рендер: резкий UI при пиксельном мире + тайлы без обводки ...

- Renderer: бэкинг-стор канваса в пикселях устройства (scale × dpr) —
  UI и текст рендерятся 1:1 с экраном, без «мыльного» апскейла на HiDPI;
  CSS-размер канваса не изменился (виртуальное × целое)
- PixelText: setPixelTextResolution — глифы растеризуются с resolution
  канваса (синхронизирует Renderer при смене масштаба)
- AssetLoader: текстуры мира (и кадры атласов) сэмплируются nearest —
  пиксель-арт остаётся чётким квадратным
- тайлы без обводки граней (fillDiamond без light/dark линий):
  смежные тайлы сливаются в поля, сетка больше не «шумит»
- доки: render.md (двухслойный пайплайн), ui-and-dialogue.md (resolution
  текста), CLAUDE.md (правило №2)

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

полировка: читаемость шрифтов (кегль VT323 ≥ 10) + перерисовка героя ...

- DialogueBox: минимум 10px, панель расширена (8–9px у VT323 нечитаемы);
  проба tools/font-probe.mjs подтвердила на честном конвейере игры
- подсказка локации укорочена и опущена под сердечки (налезала на HUD)
- кегли в сценах: меню/настройки/сейвы/сумка/boot 9→10, тосты 11
- герой перерисован (все направления): крупнее лицо, два симметричных
  глаза, плечи/пояс/сапоги — без «кляксы», читается как человек;
  размер 16×24, имена кадров и якорь не тронуты

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

доки: docs/demo.md (витрина среза), обновление docs/engine, README, CLAUDE ...

- docs/demo.md: внутренняя проектная дока — матрица «подсистема → где показана»,
  сюжетная рамка, боевая модель, новое в движке, дорожная карта
- docs/engine: maps.md — setTile; input.md — мульти-биндинг; ui-and-dialogue.md — DebugOverlay
- README: команды art/maps, счётчик тестов, управление срезом
- CLAUDE.md: новые команды и грабли (autoplay, мульти-биндинг, пространства координат)
- tools/smoke-ponds.mjs: доведён до устойчивого кругового перехода луга->пруды->луга

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

игра: тач-джойстик и дебаг-оверлей (F3) ...

- VirtualJoystick в LocationScene: включается при первом касании,
  мышь проходит насквозь (клик-ход и бой не задеты)
- прямое движение PlayerController.moveFree с проверкой стен
- DebugOverlay (F3): fps, тайл, позиция, hp/киллы

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

игра: квест «Три цветка» — сбор, журнал, сумка, сдача и крючок акта 1 ...

- движок: IsometricTileMap.setTile — изменение тайла с перерисовкой ячейки (+тест);
  InputManager: одна клавиша маппится на несколько действий (Space = advance+attack)
- data/quests.ts: журнал квестов и предметы из флагов/варов GameState
- сбор лунных колокольчиков кликом на прудах (тайл зеленеет, прогресс flowers)
- сдача квеста Ирвину (elder_hand_in) — посадка цветов у тропы, крючок «Машина дышит»
- повторные реплики Милы (trader_repeat/trader_after)
- InventoryScene: сумка и журнал на Panel (клавиша I / геймпад Y)
- tools/smoke-quest.mjs: смоук диалога и сумки

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

игра: вторая локация «Серые пруды» — карты-файлы .map, переходы, сейв-слоты ...

- encodeMap/parseMap: карты локаций теперь файлы assets/maps/*.map (RLE v1),
  генерируются тестом tools/maps/gen.test.ts (npm run maps), грузятся в BootScene
- LocationScene параметризована LocationDef (spawn, NPC, враги, выходы, амбиент);
  Серые пруды: гладь воды, туман-частицы, 5 сгустков, обратный переход
- переход между локациями по тайлу-триггеру с fade и точкой входа
- SaveSlotsScene: меню сейвов (autosave + 3 слота, listSlots/delete)
- хук window.__game (dev) для смоук-тестов; tools/smoke-ponds.mjs — сценарий перехода

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

игра: бой в реальном времени — сгустки на ECS, конус/резонанс, HUD, интеграция в LocationScene ...

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

игра: звук и настройки — WAV-генератор, AudioManager, SettingsScene ...

- tools/audio/gen.mjs: генератор WAV из кода (моно 22050, 16-бит, без зависимостей):
  bell_hit, bell_low, ash_hiss, ash_die, spit, hurt, step, ui_click, chime
  + зацикленные амбиенты meadows/ponds (кроссфейд краёв лупа)
- engine: AudioManager.preload — декодирование до первого play
- Game.audio + связка settings.onChange -> setBusVolume
- unlock аудио на первом жесте (main.ts), preload в BootScene
- SettingsScene (Panel+MenuList): громкости master/music/sfx, вход из главного меню
- музыка локаций через Game.playMusic (защита от перезапуска того же трека)
- sfx: шаги героя (PlayerController.onStep), колокольчик реплик (DialogueSystem.onLineShown)

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

engine: примитивы боя — Shake+Camera, shapes, Cooldown, TintFlash, particleSim, burst/oneShot, justReleased, transitionAny ...

- render/shake.ts + Camera.addShake/clearShake/update (Engine.tick тикает камеру)
- math/shapes.ts: inCircle, inCone, angleBetween, nearest
- core/Cooldown.ts: кулдаун на фиксированном шаге
- anim/flash.ts (TintFlash, lerpColor) + render/spriteFx.ts (SpriteFlash)
- render/particleSim.ts: чистая интеграция частиц; Particles.burst/oneShot + radialSpeed
- InputManager: isActionJustReleased, wasKeyReleased, pointer.downTicks
- StateMachine.transitionAny — переход из любого состояния
- Тесты: shapes, Cooldown, shake, flash, particleSim, InputManager (фейковый canvas), transitionAny (130 всего)
- docs/engine: core.md, render.md, input.md обновлены

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

Миграция игры на новые API движка + документация docs/engine ...

Игра:
- диалоги переписаны на графы DialogueRunner + GameState (тексты сохранены)
- меню на MenuList, шрифт VT323 через PixelText во всех сценах
- герой из атласа hero_sheet (gen.mjs), акторы в IsoDepthLayer
- пепел через ParticleEmitter, fade-переходы сцен, сейв с GameState
- Vite: publicDir: 'assets', алиас regex, шрифт через ?url-импорт

Документация: docs/engine/ — 10 файлов (архитектура, подсистемы, рецепты).
CLAUDE.md и README.md обновлены под новые модули и грабли.

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