Композитный проход: сцена → 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>

Фидбек: «освещаемые партиклы в темноте сделаем ещё темнее». Две правки
ветки #if LIT шейдера частиц:

1) vis гасит и цвет, и альфу: vColor*(uTint*vis + received) — раньше
   гасилась только альфа, цвет оставался полным, и полупрозрачные СЕРЫЕ
   точки читались на тёмном фоне;
2) кривая видимости нелинейная: vis = clamp((max-канал(received)*1.6)^2) —
   степень давит слабый свет (ночь received ~0.05-0.1: линейная кривая
   оставляла vis ~0.1), а день/лампа по-прежнему насыщают vis в 1.

Чистая функция litVisibility(maxChannel) зеркалит шейдерную кривую —
тесты без WebGL (371). Замер пробы (пара кадров ночью «дождь вкл/выкл»,
пиксели ярче фона): 815 -> 641 (гашение цвета) -> 10 (квадрат); день
не изменился (дождь 101 -> 100), мотыльки (излучающие) светятся как
раньше (961 тёплых px).

Гейт weather «облачность темнит кадр» ослаблен до x0.93: зенитный свет
пасмурного дня (fd7a331) намеренно добавляет освещённости — падал и до
этой правки (воспроизведено на старом шейдере, цифры те же).

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

Живучий баг «частицы светятся одинаково при любом освещении»: теперь
режим — свойство слоя. renderer.addParticles({lit: true}) — освещаемый
слой: полученный свет (env-свет сцены + точечные источники) правит и
цветом, и видимостью (альфа = clamp(max-канал·PARTICLE_LIT_VIS)) — ночью
в темноте частица исчезает, у лампы/фонарика проявляется, днём вид как
раньше. Излучающий режим (по умолчанию) — прежняя формула.

- particleEnv(amb, sun) — чистая функция env-света (ambient + доля
  солнца PARTICLE_ENV_SUN 0.3: у билборда нет нормали); рендер
  пересчитывает uEnv в конце setSun — туда сходятся все изменения света;
- игра: lit — дождь/снег (WeatherSystem.setTint удалён), пепел,
  листья/пыль; tint остался самосветящимся: мотыльки, дымка, блики.
  Ручной ночной tint был подменой реакции на свет — больше не нужен.

Замер в игре: дождь день 101 / ночь 14 яркости, в луче фонарика капли
проявляются; мотыльки ночью светятся как раньше. Тесты 368 ✓ (+particleEnv),
гейты atmosphere/weather/panels ✓.

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>

Диагноз: реакции частиц на свет были перцептивно нулевыми при исправной
проводке. Точечные источники: кубический фоллофф концентрировал вклад в
внутреннем ~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>

- Вода: яма 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>

- 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>

Движок: экспорт 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>