feat(game): контент освещения + сценарий проверки lighting ...

- locations.ts: ambient областей (луга/пруды/Звенец/интерьеры), окна трёх
  домов Звенца, очаг дома Ирвина (hearth_low -> hearth_high по флагу квеста),
  лампа прилавка лавки, холодный отсвет башни после звонка
- LocationScene: вызов lightView.update(dt) — время/лерп ambient/кадры
  к спрайтам (сценарий поймал замороженное мерцание)
- tools/checks/lighting.mjs: 6 шагов (ambient областей, окна, тёмный интерьер,
  мерцание с допуском, лампа следует за героем, очаг ярче после сдачи),
  регистрация в agent.mjs
- доки: demo.md (матрица), plan.md (задача 10 + точки расширения day/night),
  art-style.md (свет — оверлей, цвет из гаммы жизни, интенсивность ≤ 1.1)

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

Аудио: стерео-музыка, динамические темы (бой/настороженность), room tone интерьеров ...

- Движок: renderMusicStereo (interleaved L,R, equal-power pan треков,
  нормализация по общему пику каналов), createBuffer(channels 1|2);
  моно renderMusic бит-в-бит прежним сэмплам
- Игра: темы боя и tension-стем в data/music.ts; threat-тик
  LocationScene.updateMusic — chase → тема боя, wary → тихий стем
  (setVolume с флагом stemPending против шторма перезапусков)
- Room tone интерьеров: ROOM_TONES (hum-спеки, шина ambience),
  запуск в enter, стоп в exit, validate-тест ключей
- checks/music.mjs: инвариант «тема лугов не перезапускается»
  (динамические темы/стем — легитимная реакция на врага)
- Доки: assets-audio-save.md (стерео), practices.md (динамическая
  музыка, pending-флаг), plan.md (Работа G — сделано)

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

audio: палитра спеков (tone/wobble/sweep/layers) — все sfx на спек-синтезе (E4) ...

- SoundSpec: kind 'tone' (чистый тон + свип freqTo), параметры w/attack/
  fadeTo/wobbleHz|Depth|Base|Phase, доп. голоса layers (SpecVoice с delay);
  без модификаторов бит-в-бит прежним формулам
- data/sfxSpecs.ts: 16 спеков — все бывшие файловые sfx, включая шаги
  (StepVariants: варианты renderSpec с сидами base+i·10, fallback — базовый
  спек); ui_click во всех сценах через playSfx
- gen.mjs остался только амбиенту; assets/audio/sfx/ удалён; формулы
  бывших sfx экспортированы для парити-теста (bit-в-бит / eps 1e-5)
- мост: scene:synthesize принимает kind tone; доки: agent.md,
  assets-audio-save.md, practices.md, plan.md (E4 ✅)

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

audio: миграция bell_hit/whoosh на спек-синтез (E3), мёртвый door.wav удалён ...

- SoundSpec: флаг swell (огибающая «0 → 1 → 0» у hit/scrape), у chime 4-й
  партиал и константная амплитуда клика — формулы совпали с gen.mjs дословно
- data/sfxSpecs.ts: реестр SPEC_SFX + playSfx — единая точка проигрывания
  sfx (AudioSystem, useTransition, collectFlower); ключи в AUDIO_KEYS
- gen.mjs: CLI-гвард (WAV при импорте не пишутся), формулы bellHit/whoosh
  экспортированы для парити-теста sfxSpecs.test.ts (бит-в-бит равенство)
- доки: plan.md (E1–E3 ✅, F/G ✅), practices.md, assets-audio-save.md

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

Движок: секвенсор renderMusic + playLoopBuffer; игра — тема лугов (работа G) ...

Партитура MusicSpec (bpm, beats, партии-стемы: pluck/bell/pad) чисто
компилируется в луп; playLoopBuffer играет буфер памяти на любой шине.
Тема лугов — правило-базовый генератор в data/music.ts (сид, ля-минорная
пентатоника), компиляция в рантайме — WAV для музыки не нужен; у области
поле theme, у Game — playTheme с guard-ом и кроссфейдом. Проба
checks/music.mjs в agent:check. Секвенция тем (бой) — до боевой темы.

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

Движок: auto-mute по visibilitychange, bus в PlayOptions, exponential-фейд ...

Свернул таб — ctx.suspend, вернулся — resume (опция pauseOnHide, без
DOM listener не ставится). Разовый sfx можно направить в любую шину
(bus, по умолчанию sfx). Затухания лупов — экспоненциальные (линейный
спад слышен ступенькой); нарастание осталось линейным — экспонента не
определена от нуля. Доки и план (работа F ✅) в том же коммите.

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

Мост: scene:synthesize — звук по спеку из агентных проверок (работа E2) ...

Агент без слуха описывает звук параметрами (SoundSpec), движок
компилирует его в буфер (playSpec), факт запуска наблюдаем в
__gameAudioLog. Проба checks/synth.mjs в agent:check: удар/звон/
скрип/гул по спекам, громкость доезжает до голоса, повторный синтез
играет, негодные спеки возвращают null, гул не глушит амбиент.
Формы спеков — в docs/engine/agent.md.

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

Движок: playSpec — спек-синтез звука по описанию (работа E1) ...

SoundSpec (kind hit/chime/scrape/hum + параметры) детерминированно
компилируется renderSpec в сэмплы; AudioManager.playSpec кэширует
буфер по ключу. Путь «звук по запросу» для ИИ-агента без слуха.
Типы synth.mjs — декларацией рядом (synth.d.mts): TS резолвит
specifier к реальному файлу и игнорирует ambient declare module.
План работ E/F/G (спек-синтез, хвосты аудио-инфраструктуры, музыка)
— в docs/plan.md; доки движка обновлены в том же коммите.

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

Движок: playBuffer/createBuffer (sfx из памяти); игра — вариативные шаги ...

D2 работы D. AudioManager: общий запуск голоса вынесен в startSfx,
playBuffer(key, buffer, opts) играет буфер из памяти в шину sfx,
createBuffer(Float32Array, rate=22050) строит AudioBuffer (null до unlock).

Чистые примитивы синтеза вынесены в @rpg/engine/tools/synth.mjs (без
node-импортов — wav.mjs тянет node:fs и в браузере не соберётся); wav.mjs
реэкспортирует их для тулз, WAV-файлы побайтно не изменились.

Игра: systems/StepVariants.ts — 3 процедурных варианта шага на поверхность
(сиды 253–256, полосы как в gen.mjs), AudioSystem.playStep(surface) вместо
ключа+джиттера rate, LocationScene отдаёт поверхность. До unlock — файловый
шаг. Гвард: @rpg/engine/tools/* — публичное API. Доки и план обновлены.

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

План: работа D — возможности аудио-движка (sfx-хендл, полифония, наблюдаемость, буферы) ...

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

Игра: амбиент на шину ambience вместо music, слайдер «Амбиент» ...

- gen.mjs: ключи ambience/meadows|ponds|zvenets -> assets/audio/ambience/ (music/ удалён)
- AUDIO_KEYS вынесен в data/audio.ts (валидатор в node-тестах без ?url-импортов Game)
- Game.playAmbience(key, 0.7) c guard ключа; '' — stopAmbience; шина ambience в settings
- AreaDef: визуальное ambience -> atmosphere, аудио ambience?: string (интерьеры — тишина)
- SettingsScene: Общая / Амбиент / Звуки (ползунок music не показываем — треков нет)
- validate-тест: area.ambience и Interactables.responses[].sound ∈ AUDIO_KEYS
- хвосты music/ в доках вычищены; agent:check зелёный

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

Реестр размеров спрайтов: sizes.mjs + AssetLoader.frameSize ...

Единый источник номиналов для тулз (gen.mjs, lint-art.mjs), рантайм
читает размер кадра из атласного JSON. Захардкоженные 16×24/16×16
заменены ссылками на реестр; VIRTUAL-дубли 480/270 в сценах — на
Game.VIRTUAL_W/H; маркер NPC считается от реальной высоты кадра.

- tools/pixelart/sizes.mjs: SIZES (tile/tall/prop/char/fauna/clump/decor)
  + SLOTS для линтера; тест sizes.test.ts
- gen.mjs, lint-art.mjs: импорт из реестра вместо локальных констант
- AssetLoader.frameSize(key, frameName?) — sourceSize из атласного JSON
- IsoLayout как параметр игры — отложено (docs/plan.md)

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

aiart: примерка tryon + бобинг walk-кадров; фикс startDevServer (cwd) ...

- tryon.mjs: примерка AI-сборки в игре до promote — подмена целевого
  атласа, rename кадров <id>_ → hero_ (контракт LocationScene),
  скриншот героя в локации, восстановление файлов в finally.
- Бобинг: при bob:true 2-й кадр = 1-й, сдвинутый вниз на 1px —
  различимая ходьба из одинаковых поз стоя; манифест bob:true.
- agent-lib startDevServer: опция cwd (приложение передаёт каталог с
  index.html — vite от корня репо отдавал 404), spawn detached +
  kill группы (зомби-дети npx держали порт), детект выхода при занятом
  порте; игровой lib.mjs по умолчанию cwd apps/game; docs/engine/agent.md.
- meta.image в buildAtlas — basename (Pixi резолвит относительно URL
  JSON; путь с каталогом давал /chars/chars/… и 404).
- docs/plan.md: статус проекта — техно-демка движка.

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

feat(aiart): палитровый ремапер + линтер арта ...

recolor.mjs — перекраска квантованного спрайта по ключам палитры/hex (CLI +
поле remap в манифесте атласов: плащ звонаря приведён к каноническим C0/C1).
lint-art.mjs (npm run art:lint) — авто-чеклист арт-библии: палитра, слоты,
детект «мыла»; все 31 кодовых ассета и AI-атлас проходят, негативы проверены.
Тест ремапера (3). Доки plan.md, art-pipeline.md, CLAUDE.md.

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

feat(aiart): пайплайн атласов персонажей gen/build/promote + полный прогон звонаря ...

Манифест-драйвенно (atlas-manifest.json): промпт, seed, ракурсы→направления,
палитра (game | palettes/*.json), crop-оверрайды. sd_sheet.py — генератор
листов в репо (интерпретатор — env RPG_SD_PYTHON). Прогон: 6 кадров звонаря
(3 направления × 2) + обзорный лист build/bellringer/_review.png на апрув,
статус draft — promote в assets закрыт. Сырые листы — в .gitignore (seed
детерминирован). Скрипт npm run aiart; доки plan.md и art-style.md.

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

docs(plan): список недостающих AI-графических тулз (sheet2atlas, ремапер, линтер) ...

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

docs(plan): B3-доп — ускорители (iGPU/q8) отвергнуты, fp32-CPU остаётся ...

iGPU HD 620 (Vulkan/ggml) не бенчмарка: 24 EU и общая память ~30 ГБ/с —
на порядок слабее CPU в матмулах, OpenCL для Gen9.5 мёртв. Рабочий рычаг —
меньше шагов (25→15 = 11→6.6 мин). В доку и кадр демо пост-обработки.

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

B3-проба: SD_PixelArt_SpriteSheet_Generator на CPU — путь рабочий, квантование отвергнуто ...

- fp32/diffusers, 15 шагов = 6.6 мин/вид (25 шагов — 11 мин): 4 фигуры
  читаются, но это позы стоя, не walk-цикл; кадры ~120 px.
- q8_0 через stable-diffusion.cpp: 34 мин (int8-ядра ggml без VNNI на
  i5-7300U медленнее fp32-oneDNN) и VAE в q8 даёт шум — квантование на
  этой машине не берём.
- Вердикт в docs/plan.md: разовые атласы ≈ 30 мин/персонажа (4 вида),
  доработка кадров руками; пробы в tools/aiart/probe-b3/.

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

Крупные объекты: props с footprint в движке, слоты арта, проба дома кодом ...

Работа C из docs/plan.md — подготовка к зданиям акта 2.

Движок:
- TileMapData.props: крупный объект с footprint w×h от СЗ-угла — коллизия
  по всему прямоугольнику, земля под ним (ground), спрайт якорем низ-центр
  footprint'а; без текстуры — колонна-плейсхолдер (общий с tall хелпер).
- IsoDepthLayer.addRect: глубина по диагонали юго-восточного угла
  footprint'а — герой у южной стены перекрывается домом, перед южным
  углом рисуется поверх.
- mapFormat: props в файловом формате + валидация (целые w/h ≥ 1,
  footprint внутри карты, высота в юнитах).
- LocationScene вставляет map.propViews в общий depth-слой.
- Доки движка: maps.md (секция props), render.md (addRect).

Арт (проба C2):
- Арт-библия: слоты крупных спрайтов (дом 2×2 — 64×80, 3×3 — 96×96,
  4×4 — 128×112); плотность пикселя как у тайлов.
- gen.mjs: tiles/house_big.png (64×80) — композит: модули щитов + крыша
  из шпал + козырёк + окна. Сравнение с AI-апскейлом 24→48 —
  tools/aiart/probe-c2.png: код-композит заметно чище, апскейл — мыло с
  чужой плотностью пикселя. Вывод: крупные объекты — код-композит;
  апскейл только как болванка (см. docs/plan.md, работа C).

Тесты: 318 (+9: footprint, depth-rect, валидация пропов).

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

B1: доменный PoC на PixelGPT-24×24 — 44% годных, отказов нет, лицензии нет ...

Вторая GPT-пиксель-модель (68M, CPU ~22 с/спрайт) с обусловливанием палитрой
игры (5 цветов на запрос). 18 доменных спрайтов (колодец, столб, рычаг,
колокол, камин, прилавок, дверь, моты + сундук как контроль).

Итог: критерий 30% выполнен (44% good); главное отличие от PXG-Tiny —
модель не отказывается от доменных объектов (колокол, дверь, камин, столб,
моты — good). Ограничения: даунскейл 24→16 губит деталь (колодец good на
24×24), фон часто залит, ровно 5 цветов, лицензии на код/веса нет — в игру
нельзя. Вывод в docs/plan.md: критичные интерактивы — RD API или ручной
арт; дообучение под игру не делаем.

- tools/aiart/prompts-b1.txt, review-b1/ (18), processed-b1/ (19),
  manifest-b1.json (вердикты).
- post.mjs: опциональный каталог вывода (партии не затирают листы друг
  друга).
- Раннер генерации и модель — вне репо (~/.cache/rpg-ai), в git только
  промпты/манифест/PNG.

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

B0 PoC: AI-генерация спрайтов PXG-Tiny + пайплайн пост-обработки ...

tools/aiart/ — пробный контур AI-арта:
- post.mjs: декодер PNG без зависимостей, кроп по альфе, nearest-вписывание
  в 16×16, квантизация в палитру palette.mjs, обзорный лист для апрува;
- manifest.json: вердикты прогона (40% годных, стиль совпал на 100%);
- prompts-b0.txt + review/ + processed/ — сырьё и результат.

Модель PXG-Tiny (MIT/CC0) локально на CPU (~6 с/спрайт, iGPU-машина).
Ограничение зафиксировано в docs/plan.md: домен 38 классов не покрывает
критичные ассеты игры — для них дообучение / RD API / ручной арт.

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

Дока: план развития — AI-генерация спрайтов и аудио ...

docs/plan.md — живой документ планирования (актуальные задачи + крупные
направления). Проработаны две отложенные работы:

- B (изображения): тайлы/объекты — локальные GPT-пиксель-модели (PXG-Tiny,
  Pixel Forge, PixelGPT-24×24 — CPU, нативная палитра), персонажи-атласы —
  открыто (дообучение vs Retro Diffusion API vs ручной арт). Пайплайн:
  манифест + seed + пост-обработка в палитру + апрув-гейт.
- A (аудио): три класса потребностей (окружение, SFX, музыка/катсцены);
  основной рантайм — Stable Audio 3 Small-SFX/Small-Music (433M, CPU),
  ACE-Step 1.5 — офлайн-пакет для музыки катсцен. Формат игры не меняется.

Ограничение зафиксировано: машина разработки без дискретного GPU (iGPU,
4 ядра) — только CPU-инференс; модели с NC-весами в основной пайплайн
не брать. AI-вывод — только сырьё (палитра 32 цвета, WAV 22050 моно).

Зарегистрирован в docs/llms.txt и CLAUDE.md.

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