- сумма плотностей SNOW_BANDS 0.0415 (комментарий и CLAUDE.md говорили
  0.0405 — арифметическая ошибка при удвоении слоёв).
- «58 узлов канала» → 59 (Math.round(176/3)).
- цвет вспышки — из LIGHTNING_COLOR (литерал 0xdfe8ff дублировал
  константу и мог разойтись при смене).
- комментарий setArea теперь честен: камера ставится на центр тайла
  входа, герой — на safeEntry (возможен сдвиг спиралью), подхват на
  первом тике, а не «продолжит без микро-скачка».
- index.ts: экспортированы LIGHTNING_COLOR, weatherWindow,
  RAIN_LAYERS/SNOW_LAYERS (нужны агентам/тестам наружу).

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

- VoxelRenderer.dispose(): контекст GL, пост-проход, туман, свет с
  shadow map; ModelViewer.dispose зовёт его — раньше каждое открытие
  вьювера оставляло рендерер с тремя теневыми источниками в GL.
- тест ветвей болта больше не тавтологичен: считал «alpha < 1», что
  выполнял ореол канала (0.22); теперь 2×5 бледных сегментов, спуск.
- гейт weather.mjs (+1 чек, 26 всего): тени вспышки реально рисуются —
  тёмные пиксели земной трети кадра гаснут при setLightningShadows(false)
  (1258 → 1028). Направление света вспышки от точки удара не зависит,
  так что чек — сравнение с тенями/без, а не «переброс стороны».
- мост + VoxelRenderer.setLightningShadows(on) — диагностика гейтов.

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

Lit-слои получали env-свет только от ambient+солнца — направленный свет
вспышки на них не действовал (ночью дождь оставался невидимым в разряд).
lightningEnvLight(k, nightK) добавляет долю вспышки (0.2) в uEnv и
uFogColor при пересчёте света в setSun: ночью дождь проявляется во
вспышку вместе с миром, туман вспыхивает тем же цветом.

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

Движок (render/lightning.ts): LightningSystem — strike(at?) (без точки —
случайная точка окна видимости, детерминирована номером удара), update(t)
гонит огибающую мерцания (пик + два рестрайка, 0.55 с), info(). Разряд —
излучающий слой частиц: непрерывный зигзаг (сумма двух синусов) 58 узлов
на высоту 176 (за верх кадра) + ореол и две ветви. Вспышка — отдельный
направленный свет рендера setLightning(at, k) с shadow map: свет из точки
разряда вниз с наклоном, ночью усилен (×(1+nightK)); setSun не трогает.

Игра: мост makeLightning(at?)/lightningInfo(), тик системы, кнопка в
секции погоды дев-панели. Гейт weather.mjs: +6 чеков (25 всего).
Тесты чистой части (огибающая, геометрия, жизненный цикл) — 387 ✓.

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

Композитный проход: сцена → RT с DepthTexture, полноэкранный квад
реконструирует мировую точку (в орто глубина линейна) и красит кадр
стопкой из 6 слоёв по дистанции вдоль взгляда ОТ КАМЕРЫ. Клубы — fbm
по мировым XZ с дрейфом ветра (глубокие слои медленнее — параллакс),
высотное затухание собирает туман в низинах; цвет — env-свет сцены
(день светло-серый, ночь тёмный). Полоты ⟂ оси взгляда забракованы
пробой-изолятом: при взгляде ~63° плоскости уходят под рельеф.

Главная грабля: d в шейдере обязан быть dot(wp − uCamPos, uCamF) —
глубиной от КАМЕРЫ; вариант от цели давал для видимых пикселей
d ∈ [−1.12·V, +1.12·V] при слоях на 2.5..5·V — все smoothstep'ы
нули, туман полностью прозрачен (изолят маскировал: камера ближе).

Попутно чинит pow-граблю из 55876f8: степень PARTICLE_LIT_GAMMA из TS
в GLSL-шаблоне печаталась «2» (int) — pow(int) не компилировался в
GLSL ES, lit-слои частиц (дождь/снег/пепел/листья/пыль) молча не
рисовали; в GLSL-шаблоны числа из TS — через .toFixed(1).

WeatherSpec.fog (0..1), база прудов 0.3; 6-й слайдер «туман» в дев-
панели. Гейт weather: 19 проверок (+6 туман: рисуется, глубинный
градиент, дрейф, ночь тёмная, слайдер панели). check:fast — 377 ✓.

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

В облачный день свет рассеян и переотражается так, словно есть доп свет
прямо сверху. Второй DirectionalLight в зените (кастер тень вбок не
смещает — фрустум только на видимую область) даёт минимальную тень ПОД
объектом, куда косые лучи солнца не достают, и чуть подсвечивает
горизонтальные грани (пасмурный «молочный» свет).

- zenithIntensity(cloudK, nightK, daySunScale) — чистая функция,
  OVERCAST_TOP_LIGHT = 0.55; ночь и тёмный интерьер гасят вместе с небом;
- мягкость общая с солнцем (shadowSoftK), пересчёт в setSun;
- в игре: у деревьев/валунов/героя в пасмурный день мягкий ореол у
  основания, направленные солнечные тени исчезают.

Тесты 368 ✓, гейты atmosphere/weather/panels ✓.

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

Рассеяный свет освещает затенённые места со всех сторон — в пасмурный
день тени не только мягче (3ba9b1d), но и светлее. Ручка —
sun.shadow.intensity (three 0.186: mix(1.0, shadow, intensity) в шейдере):

- shadowIntensity(strength, cloudK) — чистая функция: сила тени гасится
  облачностью множителем 1 − k·SHADOW_CLOUD_FADE (0.45);
- setShadowStrength(k) — ручное управление (0 — тени исчезают);
- setCloud по умолчанию тянет контраст вниз (не перезаписывает силу,
  в отличие от мягкости); пересчёт в setSun — переживает тики света.

Замер на изоляте (земля + куб): контраст свет/тень 3.6 в ясный →
1.5 в пасмурный. Тесты 361 ✓, гейты atmosphere/weather ✓.

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

Движку нужна ручка резкости теней: облачность гасила солнце, но тени
оставались резкими, хотя рассеяный свет даёт мягкую полутень.

Механика: PCF three (0.186) масштабирует диск сэмплов Вогеля
shadow.radius'ом — мягкость без смены типа shadow map. Радиус в текселях
считает чистая функция shadowBlurTexels(k, frustumHalf, mapSize) из
мирового размытия (0..SHADOW_BLUR_MAX = 3 юнита) — зум и высота солнца
меняют фрустум, мировое размытие постоянно (setSun пересчитывает тексели).

API: VoxelRenderer.setShadowSoftness(k) (0 — резкие, ручное поверх);
setCloud(k) тянет мягкость своим k — пасмурная погода даёт диффузные тени
без правок игрового кода. Замер пробы: резких краёв на кадре 14101 → 6614
при облачности 1. Тесты функции — 4, check:fast 357 ✓, гейты
atmosphere/weather ✓.

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

Движок (packages/engine):
- WeatherSpec (windDir/windStrength/cloud/rain/snow), clampWeather,
  windVector; weather.ts — WeatherSystem на слоях частиц (addParticles):
  окно осадков = след кадра + маржа, wrap, альфа у края; дождь —
  тяжёлая капля (дрейф ветра ×0.6), снег — покачивание + полный дрейф
- VoxelRenderer.setCloud: гашение солнца (×1−0.6k), облачный тинт
  ambient/фона через cloudDim (обесцвечивание + затемнение), встроен
  в setNight (lastNightTint пересчитывается)
- agent-lib: startDevServer показывает stderr vite при падении

Игра: погода по областям (AREA_WEATHER) + ручной режим дев-панели,
переживает смену области; setAsh(false) глушит погоду (гейт-режим);
в тике погода анимирует даже при открытой панели. Мост: weatherInfo,
setWeather (merge/сброс), devSetWeather. Дев-панель: слайдеры
облачность/дождь/снег/ветер/направление, счётчики капель и снежинок.

Гейт tools/checks/weather.mjs — 14 проверок (базы областей, ливень/
снег падают, облачность темнит, панель, глушение). 343 теста ✓.

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

- Движок: общий блок юниформ света на рендере (packParticleLights,
  setParticleLights), шарится ссылками между слоями; шейдерный вклад
  ламп/конуса умножается на цвет частицы, ×2 на согласование с GAIN-пулами.
- Игра: GameLighting отдаёт снапшот источников + конус фонарика каждый тик;
  снапшот моста — lightingInfo.particleLights.
- Гейт atmosphere +2 (день 0 / ночь = источникам), 332 теста.

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

- Вода: яма y=1 пуст / вода y=0; непроходимость — physicsWorld
  (невидимый коллайдер над ямами); декор на воде не штампуется.
- Деревья: стволы 25-38, кроны 17-24, чанк 64.
- Манекен 8×12×4 (134 вокс, 19 тайлей — детализация на текстурах),
  снаряжение пропорционально меньше (рюкзак 40 / факел 4 / фонарик 16).
- Тени: динамический фрустум в setSun (visible·aspect + высота кастера),
  mapSize 2048 — граница включения теней больше не видна.
- Частицы: uTint в ParticleLayer, ночной тинт PARTICLE_NIGHT,
  размеры уменьшены (пепел/листья/пыль/дымка/мотыльки).

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

- Бездна: неосвещаемая плоскость под миром — за границей области тьма
  в любое время суток.
- mapTreeModel: сетка 12×12, стволы 22–36, крона до r≈5; высота чанка
  мира 52→64 (дерево до 53 не влезало).
- Солнце: движок умел setSun(k), но игра не вызывала — тени стояли на
  полудне. GameLighting зовёт setSun((часы−6)/12) каждый тик; снапшот
  моста — sunK. Гейт детерминизма областей пинит часы перед кадрами
  (солнце едет каждую игровую минуту — кадры в разные минуты различны).
- Фонарик: движок addSpotLight (SpotLightHandle setTarget) +
  flashlightModel (2×2×5); игра — крепление в левой руке (armL,
  зеркально факелу), конус по hero.yaw ночью/в темноте, снапшот
  flashlight.on/intensity; gear по умолчанию 110 вокс.
- Доки v2/CLAUDE.md: трек 34 + генераторы/прожектор.

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

- modelCenter (движок): ось орбиты ModelViewer — центр bbox занятых
  вокселей, а не угол сетки; экспорт из index.ts, тест на углы.
- Точечные источники: three r155+ считает PointLight в физических
  единицах — POINT_LIGHT_GAIN=8 в addPointLight И setIntensity
  (мерцание каждый кадр затирало усиление — свет оставался тусклым).
- Реестр объектов игры (apps/game/src/registry.ts): каталог дев-вьювера
  собирается сам из мест создания (areas/main/fauna), без ручного
  списка; devview только рисует DOM. 20 записей, id стабильны —
  гейт panels без изменений.
- Доки v2/CLAUDE.md: трек 33 + структура modelViewer/addPointLight.

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

- Движок: VoxelRenderer.setPostPass (сцена в RT NearestFilter 1:1, затем
  квад на экран; PostPassHandle {uniforms, dispose}) + сборщик postPass
  ({vignette?, grain?, wobble?}); uTime заводится рендерером всегда.
  Детерминизм гейтов: зерно статично (хэш по координатам), анимируется
  только дисторсия через uTime.
- Игра: PostFx (виньетка 0.32→0.5 к ночи, зерно 0.02, дисторсия жары
  0.004 в зале Машины — проход пересобирается в setArea, active=ashEnabled);
  AirFx (листопад рощи 26 шт с покачиванием, пыль разъезда 40 шт —
  взвесь с edgeAlpha в марже окна видимости); карта AIRFX в данных;
  ambientInfo.air.
- Гейт atmosphere +5 проверок (виньетка по зонам кадра, листья, пыль);
  гейт panels: статы манекена синхронизированы с треком 29 (19 тайлей).
  317 тестов, 7+11 гейтов зелёные.

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

Частицы больше не воксели: отдельный 2D-слой поверх мира (THREE.Points
билборды и InstancedBufferGeometry квады в XZ), без освещения и теней.
Окно видимости частиц — точный AABB сляба ортокамеры на слое [y0,y1]
(polyWindow, перебор вершин полиэдра). Пепел/мотыльки/дымка/блики воды
переведены на слой: частицы живут в мировых координатах, окно камеры
заворачивает их с маржой за экран, в марже альфа гаснет — без появления
из воздуха. Окно покрывает весь кадр с перекрытием.

Движок: particles.ts (ParticlePoint/ParticleLayer, createSpriteLayer/
createQuadLayer, addParticles/addFlatParticles), polyWindow.ts,
visibleWindow(y0,y1), 4 теста (симметрия следа, покрытие окна,
сдвиг от высоты, вырожденность). Игра: particlesWindow.ts (маржа,
wrap, edgeAlpha), миграция ash/ambientParticles/waterShimmer,
setAsh пересобирает частицы области.

Грабли: знаки полуплоскостей n·δ≤b; AABB в дельтах — прибавлять target;
окно без кэша (едет за камерой); квады на воде — над гранью y=3;
fresh.update после роста ёмкости; скорости по v1 (px/s ÷ 32).

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

Движок: слой тайлей мира (Chunk.tex / VoxelWorld.getTex/setTex, мешер
texAt → per-vertex tiles/uvs, stampModel с opts.texRemap), рендер —
worldTileAtlas (общий атлас чанков, шейдерная инъция общая с облаком).
Манекен: скины деталей (подол/застёжка/подошвы, пряжка — слот metal).
309 тестов (+6), все 18 гейтов зелёные.

Игра: редизайн строений (дом — 3 стиля стен по сиду + tall, круглые
башня и колодец с воротом, клёпаная Машина), природа (валун-купол
с трещиной/мохом, высокий и малый кусты — варианты по сиду), олень.
Скины домов (houseTexture: кладка/доски/штукатурка/дранка/дверь) и
персонажей идут через реестр worldTex с дедупликацией тайлей по
контенту. Палитра мира дополнена слотами 18-23. Гейты areas/interact
поправлены под UNIT=10 (устаревшие константы), props — центр тайла.

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

Character.yaw раньше вращал только позиции вокселей — кубы оставались
осями-выровненными и на диагональном ходе «пилили» силуэт углами.
Теперь PosedVoxel.rotY (опциональный поворот самого куба): visual()
ставит rotY = yaw на каждый воксель, рендер строит матрицу инстанса
makeRotationY(rotY) + setPosition — жёсткое вращение модели целиком.
Олень без изменений (четверти оборота держат сетку на осях). Проба
tools/probe-diag.mjs: герой на мировой диагонали, силуэт чистый.
6 гейтов игры + 11 демок зелёные, 301 тест.

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

Формат: тайли пиксель-арта на грани вокселя (VoxelTile, тексель = слот
палитры — перекраска красит и текстуры) + tex (id тайля на воксель);
encodeModel(g, palette, texture?), texIdAt/texBytes/resolveTiles,
числовая валидация слоя. Рендер: addVoxelCloud(voxels, tiles) — атлас
(ячейка = 6 суб-граней тайля, 0 белая), aTileId + шейдерная инъция
(грань куба из нормали). Манекен: 14×24×8 (498 вокс) → 10×16×4 (164);
лицо — арт 8×8 текселей (бахрома/глаза/рот) на фасаде головы, волосы —
макушка и затылок. Игра: BODY_SIZE [5,16,5], stride 9.6, облака с
resolveTiles. Порог маха anim-гейта 1.0→0.8 (ноги вдвое короче).
6 гейтов игры + 11 демок зелёные, 300 тестов.

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

Движок: экспорт daynight (dayNightFactor/dayNightAmbient/flickerFactor),
новые API VoxelRenderer — setNight(k, tint) (hemisphere → тон ночи, фон
сцены, гашение солнца) и setDayAmbient(color) (дневная база области:
тёмные интерьеры гасят hemisphere и солнце по яркости), addPointLight.

Игра (apps/game): GameClock (1 сек = 1 игровая минута, старт 8:00),
данные освещения 8 областей v1 1:1 (bells, окна, очаги, отсвет башни;
whenFlag/notFlag/whenNight), GameLighting (diff источников, мерцание,
лампа героя HERO_LAMP), AshParticles (пепел лугов), GameAudio (темы
областей с кроссфейдом — только луга, как в v1). Мост: clockInfo/
setClock/lightingInfo/audioInfo/setAsh. Гейт tools/checks/atmosphere.mjs
— 18 проверок; areas.mjs научен отключать пепел для кадр-равенств.

Вне скоупа (отложено): туман прудов, ауры наката, виньетка, амбиент-слои.

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

- core/loop.ts: GameLoop — фиксированный шаг 60 Гц, аккумулятор с
  maxStepsPerFrame, ручной режим setManual+stepTick (детерминизм гейтов),
  now/schedule инъектируются для Node-тестов
- core/ecs.ts: EntityWorld — перенос проверенной минимальной ECS v1
  (открытый вопрос «каркас ядра» решён)
- core/controls.ts: ввод как данные; screenMoveToWorld — экранные оси
  в мировую горизонталь по yaw камеры (проекция на границе, урок №1)
- physics/character.ts: Character — тело физики + walk от скорости
  (фаза = путь/stride, стопы не скользят; покой замирает); spawnY для
  спавна в воздухе; мост тела физики переехал на Character (один путь)
- render: setTarget/currentTarget — камера (и солнце) следит за целью
- Демка: герой на WASD/стрелках + виртуальный стик агента; мост
  setInput/heroInfo/heroTeleport/stepTicks/setManual/setFollow
- Гейт hero.mjs 9 проверок: ввод агента двигает героя, фаза 1.25
  цикла/с, стена по грани, покой замирает, камера следует

115 юнит-тестов; гейты: render 13, turntable 5, anim 8, physics 7,
hero 9 — зелёные.

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

- animation/mat.ts: аффинная математика без three (Affine, порядок
  Эйлера X→Y→Z, rotateAround) — чистая, тестируется без рендера.
- animation/rig.ts: рига (кости: имя/родитель/pivot в связочном
  пространстве), привязка вокселей — явная у генератора или bindNearest;
  validateRig (родители раньше детей, согласованность привязки);
  poseVoxels — жёсткая деформация по цепочкам костей.
- animation/clip.ts: клипы — ключи {t, кость: rot/pos}, линейный
  семплинг с заворотом t, validateClip (монотонность, замкнутость
  цикла «первый = последний»), footMinY (контакт стопы).
- animation/locomotion.ts: walkClip(params) — ноги в противофазе, руки
  против одноимённой ноги, корень приседает дважды за цикл и качается.
- models/mannequin.ts: эталонный манекен 5×11×3 с ригой (5 костей,
  явная привязка — Voronoi по pivot отнёс бы торс к рукам).
- render: addVoxelCloud — InstancedMesh для деформированных вокселей,
  обновление позы без пересборки геометрии.
- Демка: anim.html/anim.ts — аним-лист 8 кадров цикла (4×2); мост
  poseStats(i)/clipCheck()/setModels. Гейт anim.mjs: 8 проверок —
  картинка (ячейки видны, фазы различаются) + числа через мост
  (клип замкнут, противофазы, контакт стоп, качание корня).
- Попутно: turntable sheetInfo отдавал viewSize 30 при камере 32 —
  исправлено на реальное значение (гейт проходил за счёт запаса).
- 91 юнит-тест; гейты: render 13/13, turntable 5/5, anim 8/8.

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

- движок: voxel/grid.ts (Uint8-сетка, палитра по индексам), voxel/mesher.ts
  (culled-грани + классический AO 0..3 с флипом диагонали, 12 тестов),
  render/voxelRenderer.ts (ортокамера диметрии 2:1, dirLight + shadow map,
  низкое разрешение 480×270)
- тулзы: tools/agent-lib.mjs — браузерный каркас проверок v2 (swiftshader),
  tools/png.mjs — PNG-кодек (в т.ч. RGB-скриншоты headless Chromium)
- демка: apps/demo — воксельный пепельный луг в палитре арт-библии,
  мост window.__agent (setSun/stats), чек checks/render.mjs: pageerror,
  меш, тени ползут утро/вечер, апскейл кратен 2×2, многокрасочность
- грабли в v2/CLAUDE.md: камера под землёй при минус-Y (ловится только
  скриншот-гейтом — урок №2 подтверждён в первый же день)

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