Рассеяный свет освещает затенённые места со всех сторон — в пасмурный
день тени не только мягче (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>

Диагноз: реакции частиц на свет были перцептивно нулевыми при исправной
проводке. Точечные источники: кубический фоллофф концентрировал вклад в
внутреннем ~10% радиуса (среднее a³ по сфере ≈ 1/60) — изолят с игровыми
условиями давал +1.4% яркости. Фонарик: тонкий горизонтальный луч едва
пересекает видимый ортокамерой слой — ~20 капель (76 px diff), глаз не
ловил; подтверждено хирургическим A/B в живой игре (flip uSpotOn при
замороженном времени).

Фикс: квадратичный фоллофф точечных источников в LIGHT_FRAG (капли в
пятне лампы тёплые и яркие), конус спота для частиц в 2.2× шире
поверхностного с клампом полуугла (луч читается светящейся цепочкой
капель). Гейт atmosphere/weather ✓, check:fast — 353 теста.

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

Фидбек: дождь и снег медленные, выглядят плоско. Скорости ×1.4
(дождь 31 юнит/с, снег 1.7). Глубина: камера ортографическая, параллакса
нет — глубина симулируется расхождением параметров частицы от стабильной
глубины d∈[0..1] (sin-хэш, уклон в дальний план): дальнее меньше/
медленнее/бледнее (аэроперспектива), ближнее крупнее/быстрее; у дождя
дальние штрихи короче, у снега ближние качаются шире. Снежинка несёт
свой размер в позах (раньше размер слоя был фиксированным). Тесты
респавна переведены на фазовый скан (скорость теперь пер-частица),
добавлен тест разброса планов. 352 теста, гейт weather ✓.

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

Редирект layer.update = fresh.update при росте ёмкости ломался, когда
держатель слоя (WeatherSystem) снял методы заранее: ссылка навсегда
указывала в замыкание старой реализации, каждый тик сверх ёмкости
создавал новый слой с однократной записью — замороженные снимки дождя
копились в сцене (пелена на весь экран, ~46 слоёв).

Теперь createSpriteLayer/createQuadLayer держат стабильный фасад:
публичный объект один на всю жизнь слоя, при росте подменяется только
внутренняя реализация, первый кадр после роста рисуется сразу.
Регрессия particleLayers.test.ts (метод снят заранее — меш один).
Живой прогон: veil% 3.6→13.5 (накопление) → стабильные 0.07-0.09.

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

Сдвиг колонки при респавне в узкой окрестности якоря (±20 юнитов) оставлял
каплю падать в одной и той же полосе: трек «горел» на экране вечно, а поле
колонн было квази-статично в мире — кадры, разнесённые на полный цикл
падения, совпадали. Теперь sin-хэш от номера цикла растягивается на большой
период (RAIN_SPAN 731 / SNOW_SPAN 613) — капля перебрасывается по всему
периоду. Колонка внутри падения неизменна (капля падает по прямой).
Тесты: переброс ≥80% капель за цикл, стабильность колонки внутри падения.

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

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

Якорь x/z был постоянным: капля после «приземления» респавнилась
наверху в той же колонке и вечно повторяла одну траекторию (~2 с),
рисунок дождя на экране зациклен. Теперь к якорю добавляется sin-хэш
от номера цикла падения (чистая функция t — детерминизм гейтов): каждый
цикл — новая колонка; то же у снежинок. Тест «респавн меняет колонку».
344 ✓, гейт 14 ✓.

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

Ливень при rain=1 выглядел как редкая субпиксельная пыль: окно слоя
[0,40] (след кадра до дальней плоскости) при камере игры (viewSize 80,
far 800) — 342×342 юнита, а 260 капель с фиксированным счётчиком
размазывались по нему (капля 0.5 юнита при 3.3 px/юнит — 1.7 px).

- счётчик капель/снежинок — плотность на кв. юнит окна (RAIN_DENSITY
  0.016 / SNOW_DENSITY 0.007, потолки RAIN_MAX/SNOW_MAX): зум камеры
  не меняет видимую плотность; info() отдаёт фактические счётчики
- капля рисуется штрихом — цепочкой из 3 точек над головой (хвост
  бледнее и тоньше), размер поднят до 0.55/0.7 юнита
- мост: windowInfo(y0, y1) — окно видимости частиц + параметры камеры
  (диагностика плотности агентом)

Тесты 344 ✓ (число точек = плотность × площадь окна; счётчики после
update), гейт weather.mjs 14 ✓ (ливень — стена капель >1000).

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>

- Движок: attach.ts — Attachment {bone, model, pos?, rot?}: предмет
  (обычная VoxelModel со своей палитрой) размещается в связочном
  пространстве базы и едет с костью (boneWorlds); attachVoxels мержит
  воксели предметов в позу, attachTiles — общий реестр тайлей со сдвигом
  id за базу. Неизвестная кость — throw. Тесты: предмет едет ровно как
  воксель кисти (равенство сдвигов 1e-9), тайли, детерминизм.
- Генераторы: backpackModel (84 вокс, пряжка — перекраска, не добавление),
  torchModel (6 вокс), палитра GearPalette.
- Character: CharacterOptions.attachments + setAttachments; visual()
  мержит attachVoxels до yaw-маппинга — предмет поворачивается с моделью.
- Игра: герой с рюкзаком (root, за спиной) и факелом (armR, машет с
  рукой); мост heroGear(ids|null) + heroInfo.gear/gearVoxels. Гейт
  gear.mjs (6 проверок): счёт 90/84/0, снятие меняет кадр, ходьба цела.
- Багфиксы, найденные пробой: пост-проход затемнял день ~втрое (RT
  хранит linear, квад рисовал без linearToOutputTexel — конверсия сразу
  после сэмпла, до эффектов; тест на порядок) и дев-панель была видна
  с самого старта страницы (#dev[hidden]{display:none}).

326 тестов, гейты gear/atmosphere/panels/render зелёные.

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>

- баг: дома шире тайла — safeEntry ищет свободную позицию спиралью (collides)
- лоад-скрин #loading до первого кадра
- меню: слоты auto + s1..s3 (сохранить/загрузить/удалить), мост menuInfo.slots/saveTo/loadFrom/saveDelete
- панель сумки по I (#bag), мир стоит; мост bagInfo/toggleBag
- движок: ModelViewer (орбитальная камера, клипы, turntable, статы modelStats; юнит-тесты орбиты/статов)
- игра: дев-панель F3 (каталог 14 объектов, скины, вьювер), мир стоит
- гейт panels.mjs (21 проверка), пробы probe-house/probe-load/probe-dev
- доки: CLAUDE.md (структура + трек 28), plan.md, 303 теста, 18 гейтов зелёные

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>

Системный поиск ошибок (ревью движка + сверка с v1 + стресс рантайма).

Игра: тема лугов не останавливалась и наслаивалась (GameAudio держит хендл
лупа и кроссфейдит); «E» сквозь катсцену/фейд по протухшим целям; порядок
диалогов NPC как в v1 (незнакомый — всегда first); «E» — ближайшая цель с
приоритетом при ничьей (v1 pickInteract); радиус NPC 4.5; скорость героя
5.25 вокс/с (v1 1.75 юнита/с); колокольчик в сумку при сборе; ночной свет
колокольчиков следует за полем (живой слой тайлов); пустой return-стек —
фолбэк на спавн (фейд не зацикливается); кэш декода RLE (isFlower 25/тик);
камера входа в область без округления (микро-скачок).

Движок: stepTick вне ручного режима = 0 (защита от двойных шагов);
addComponent на мёртвой сущности = undefined; dispose закрывает AudioContext
и гасит все лупы (Loops.stopAll — свободные слоты playLoopBuffer раньше не
останавливались никогда); validateDialogue — kind в do[] узла и циклы
узлов-действий; DialogueRunner — реентрантность abort/start в эффектах;
dayNightFactor без NaN на вырожденных границах; remapSlots с пустой
палитрой без TypeError. Тесты 281→287, все 5 гейтов зелёные.

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>