@

docs(quantik-game): план завершён — фича смержена в feature/sim-builder Статус ✅ Complete; финальный чек-лист отмечен (merge dabb370). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @
@
2026-06-14 17:31:52 +03:00 · 2026-06-14 17:29:27 +03:00 · 2026-06-14 17:00:13 +03:00 · 2026-06-14 16:09:10 +03:00 · 2026-06-14 10:59:17 +03:00 · 2026-06-14 10:43:18 +03:00
18 changed files with 1741 additions and 75 deletions
@@ -248,3 +248,28 @@ git push origin master
 - **Карта/запуск без правок map.js** (подтверждён хэндофф Ф2): глава `functions` в `CHAPTERS` (key/title/subtitle/accent) — узлы рисуются по метаданным, тип спеки карте безразличен. `unlockStars` 9/11/13/15/17 ≤ 18 (макс звёзд 6 физ-уровней) → **нет дедлока** (даже только физ-главы дают 18 ≥ 17). `QuantikGame.start`→`SimEngine.mount` тот же; спец-вайринг управления НЕ нужен (те же слайдеры). `tintHeroSpec` тинтует point-героя на `curve.runX/runY` штатно. quantik.html: бейдж темы стал per-level (`level.subject`→Физика/Алгебра) — аддитивно, id `qg-pill`.
 - **Сервер `validateSpec` (customSimController.js): `zone` в OBJECT_TYPES + поля.** `zone.track` санитизируется как id; `plot.runner.duration` — checkExpr (длина). Готовит авторённые граф-уровни Ф5. x/y/w/h/r зон проходят общий expr-loop. Тест custom-sims.test.js +2 (приём zone+runner спеки; отказ unknown type при разрешённой zone) → 26/26.
 - **Верификация Ф3**: `node --check` всех изменённых JS + inline-`<script>` quantik.html — OK; headless vm-смоук (РЕАЛЬНЫЕ `_sim_expr.js`+`_sim_engine.js`+`levels.js`, DOM/canvas-стаб + виртуальные часы): **per-level solvability** (сетка коэффициентов 625 комбо/уровень) — line 59/625, sine 290/625, parab 88/625, abs 231/625, exp 36/625, у КАЖДОГО найден full-star комбо; **logic** — правильная f→победа без forbidden, плоская f→fail (зашёл в forbidden), zone.hit флипается по позиции, runX/runY/runDone корректны, регресс всех типов + физики без throw, ctx сбалансирован → 29/29. E2E `QuantikGame.start`→onGoal на graph-line-7 → won 2/2. Смоуки удалены. `npm test` 261/253 pass / 8 baseline fail (без новых); lint:routes 0. Эмодзи/eval/new Function — 0 (только пре-существующие →/⛔ в комментариях; зоны/звёзды — canvas/inline SVG).
 ### Phase 4 — Learnings (Квантовые способности + SR-комнаты)
 - **Все три способности — через БЕЗОПАСНУЮ модель спеки, движок НЕ тронут (engine touch = 0).** План допускал поле `tunnelable` у стены в `_sim_engine.js`, но фактически не понадобилось: **туннелирование** = `forbidden`-зона `wall` + `fail:'wall.hit && tunnel<1'`, где `tunnel` — обычный param (не слайдер). По умолчанию `tunnel` отсутствует в env → SimExpr трактует неизвестный идентификатор как 0 → `tunnel<1` истинно → стена сплошная. Способность зовёт `inst.setParam('tunnel',1)` → `_buildEnv` спредит ВСЕ `this.params` в env (стр.1193) → `fail` видит `tunnel=1` → стена проницаема. **Суперпозиция** = чистый контент (2 тела `ball`+`ball2`, `goal.when` с обоими). **Прицел** = пауза-тоггл (`inst.pause/play`) над пунктир-`plot`. Ни новой грамматики SimExpr, ни новых типов объектов, ни правок движка.
 - **`setParam` для НЕ-слайдер-параметра работает штатно**: ставит `this.params[name]`, слайдера нет → на паузе ре-рендерит. Значение переживает кадр (спредится в env). НО reset физики НЕ трогает `tunnel` (он не нач.условие тела) — поэтому `tunnel` надо ставить ПОСЛЕ `reset()` (в харнессе и в `resetAbilities`). `tunnelUsed`-флаг + сброс `tunnel→0` на новую попытку/mount → заряд тратится один раз за попытку.
 - **Энергия — клиентский ресурс, чистая логика (`window.QuantikEnergy`).** localStorage ключ **`quantik-energy`** (целое 0..99). `getEnergy/setEnergy/grantEnergy/spendEnergy/canSpend/rewardForQuality/onEnergyChange`. `TUNNEL_COST=3`; награда `rewardForQuality`: q=5(Легко)→2, q=4(Знаю)→1, иначе 0 (та же шкала, что flashcards.html). `spendEnergy` атомарен (не хватило → false, без списания). `onEnergyChange`-подписки обновляют HUD без перезагрузки (панель подписывается в mountBar, отписывается в destroy — без утечки).
 - **SR-комната = РЕЮЗ серверного SR, НЕ iframe и НЕ дубль расписания.** `QuantikAbilities.openRestRoom` — своя модалка в стиле игры: `LS.fcListDecks()` → авто-выбор колоды с макс. `due_count` (одна → сразу учить; несколько → пикер) → `LS.fcStudySession(deckId)` (отдаёт `{cards,total_due}`) → лицо→`Показать ответ`→оценки (Снова0/Трудно3/Знаю4/Легко5) → `LS.fcReview(cardId,quality)` (отдаёт `{ok,graduated,...}`; `graduated=false` → re-queue в пределах сессии через RQ_GAP, как flashcards.html). «Знаю/Легко» начисляют энергию ОПТИМИСТИЧНО (до ответа сети). Пусто (нет колод / нет due / SR недоступен) → дружелюбное окно + ссылка `/flashcards`. Картинка карты — только свой `/uploads/flashcards/...` (regex-гейт), текст escape.
 - **Клиентские врапера SR в `js/api.js`**: `fcStudySession(deckId)` = GET `/flashcards/decks/${id}/study`, `fcReview(cardId,quality)` = POST `/flashcards/cards/${id}/review` `{quality}` — стиль блока `fcListDecks/fcCreateDeck/fcAddCard`. Контроллер `flashcardController.getStudySession`/`submitReview` уже существовал (Tier-1 SR, мигр.074) — бэкенд не трогался, lint:routes/тесты неизменны.
 - **`tintHeroSpec` (quantik-game.js) тинтует `ball` И `ball2`**: ball — цвет скина, ball2 — осветлённый «фантом» (`lighten(color,0.42)`, hex→белый). Авторские id ВНЕ `ball`/`ball2` скином не тинтуются (Phase 5 при желании расширит список). Панель способностей оборачивает `inst.destroy` (снимает бар) — аддитивно, без правки lifecycle движка.
 - **Глава `quantum` (L12–L16) появляется на карте без правок map.js** (контракт Ф2 подтверждён 3-й раз): `groupByChapter`+`Levels.chapter` метадата-driven. `CHAPTERS.quantum` (accent `#C4B5FD`). `unlockStars` 19/20/22/24/26 ≤ кумулятив макс-звёзд всех уровней меньшего `order` (по 3 звезды/уровень: 18 физ + 15 граф = 33 до L12 ≥ 19) → **нет дедлока** (проверено цепочкой). `isUnlocked` считает звёзды по ВСЕМ уровням с меньшим глобальным `order`, не по главе.
 - **Активация способностей — по СОДЕРЖИМОМУ спеки, не по флагу уровня**: `levelHasTunnel(level)` = слово `tunnel` в `goal.fail/when/stars[].when`; `levelHasAim(level)` = на сцене `plot` с `id:'aim'` ИЛИ `lineStyle:'dashed'`. Кнопка появляется только если уместна. Контракт для авторского UI Ф5.
 - **ГОЧА харнесса solvability (физ-уровни): mount планирует ОТЛОЖЕННЫЙ rAF, который делает `_fit`+`reset`(+autoplay).** Если не «слить» его ДО своего `play()`, он выстрелит в середине прогона, вызовет `reset→pause→cancelAnimationFrame` и убьёт кадровый цикл (тело стоит на старте, `t=0`, 0 wins у ЗАВЕДОМО решаемого уровня). Фикс: после mount слить отложенный callback БЕЗ продвижения часов, затем `pause()`, конфиг params, `reset()`, `play()`, гнать кадры с виртуальными часами (8.33мс/кадр, `performance.now` синхронен с таймстампом rAF). Headless-смоук физики обязан гнать РЕАЛЬНУЮ физику (`SimPhysics` экспортится из `_sim_engine.js`).
 - **Контент-фикс L16 (поймал sweep)**: монета `(5,6)` r0.7 у параболы `a·(x−5)²+k` (вершина в `(5,k)`) собиралась при `5.3<k<6.7`, а 2-я звезда требует `k≥6.8` → **взаимоисключающие → full-star недостижим**. Сдвинул монету на `(5,6.9)` r0.85 → пересечение с `k≥6.8` есть → full-star достижим (a-0.25/k7.2). **Урок: проверять full-star reachability sweep'ом, а не только «есть ли победа».**
 - **Верификация Ф4**: `node --check` всех изменённых JS + inline quantik.html — OK; headless vm-смоук (РЕАЛЬНЫЕ `_sim_expr`+`_sim_engine`+`levels`+`progress-logic`+`quantik-abilities`, DOM/canvas-стаб + виртуальный rAF-клок): энергия grant/spend/reward/clamp/notify; суперпозиция-`when` требует ОБА тела; tunnel флипает fail (вкл. absent→0); per-level solvability (L12 52 win, L13/L14/L15/L16 ≥3 win + full-star у всех 5; L15/L16 БЕЗ tunnel = 0 win → гейт работает); регресс 11 существующих уровней mount+step без throw → **48/48**, удалён. `npm test` 261/253 pass / 8 baseline fail (без новых); lint:routes 0. Эмодзи/eval/new Function в UI — 0 (`⛔` U+26D4 — только в комментариях, пре-существующая конвенция всего кодбейза; способности — inline SVG `.ic`).
 ### Phase 5 — Learnings (Авторинг уровней в sim-builder + раздача классу)
 - **Бэкенд почти не понадобился — Ф0/Ф3/Ф6 уже всё дали.** `validateSpec` уже пропускал `goal`/`game` (Ф0), `CATS` уже содержал `'game'`, `share`/`clone`/`links`/per-row-ownership/`GET /:id` (own|published|admin) — Ф6. Единственная серверная правка: в `share()` для `cat==='game'` переключить ссылку на `/quantik?level=custom:<id>` + тип `game_level_shared` (иначе `/lab?sim=…`+`sim_shared`); ответ дополнен `link`. Доступ к чужому draft (deep-link/embed-утечка) закрыт ТЕМ ЖЕ `GET /:id` 403 — отдельной защиты не потребовалось.
 - **⚠️ ПАРАЛЛЕЛЬНАЯ СЕССИЯ на ветке правит sim-builder.js/.html → все правки строго АДДИТИВНЫЕ.** В sim-builder.js тронуто минимум существующих строк: по 1 врезке в `blankState`(+блок `game`), `loadFromSim`(+`st.game=loadGame(...)`), `buildSpec`(+материализация при `st.game.enabled`), `renderPanels`(+`sectionGame()`), `validate`(+проверка goal-выражений), `wirePanels`(+блок game-листенеров перед `renderLatexPreviews`), `onAdd`(+ветка `'star'`), `_open`(+`game:false`). НОВЫЕ методы/функции: `sectionGame`, `playGame`, модульные `loadGame`/`buildGoal`/`buildGameMeta`. HTML — только +CSS-блок `.sbu-game-fields/.sbu-star/.sbu-star-hdr/.sbu-stars-list`. **Никаких переформатирований/перестановок** — минимизирует merge-конфликты.
 - **Игровой слой ⇄ UI = `st.game = { enabled, when,title,hint,hold,fail, stars:[{when,label}], chapter,order,par_ms }`.** Хранит «как введено» (строки/числа), как plot-range в Ф4. `buildGoal`/`buildGameMeta` материализуют → `spec.goal`/`spec.game` (числа коэрсятся: hold/order/par_ms; пустые поля выкидываются; звёзды clamp ≤3). `loadGame(spec.goal,spec.game)` включает слой, если присутствует goal ИЛИ game. **Выключенный `enabled` → goal/game НЕ эмитятся** → обычная симуляция ведёт себя ровно как раньше. Round-trip `buildSpec→loadFromSim→buildSpec` — `deepEqual` goal+game (доказано смоуком).
 - **«Играть» = монтировать `SimEngine` в модалке, НЕ открывать /quantik.** На странице sim-builder уже загружены `_sim_expr`+`_sim_engine`; HUD/победа/звёзды активируются САМИ наличием блока `goal` (Ф0 движка) — `QuantikGame` не нужен, доп. скрипт-тегов нет. Тестирует ЧЕРНОВИК без сохранения/сети. Инстанс уничтожается на закрытии модалки (кнопка + `m.onClose`, если поддерживается). Если `goal.when` пуст — тост-подсказка, модалку не открываем.
 - **`QuantikLevels` стал асинхронным (контракт Ф1 исполнен).** `ensureCustom()` (Promise, кэш `_customPromise`): `LS.customSimsList()` → фильтр `cat==='game'` (список БЕЗ spec) → `LS.customSimGet(id)` каждой → `customToLevel(row)`. `list()=LEVELS.concat(CUSTOM)`, `get(id)` ищет в обоих. **`getAsync(id)`** для deep-link: в кэше → синхронно; иначе `custom:<dbid>`→`LS.customSimGet(dbid)` (сервер-доступ own|published|admin), резолвнутый уровень подмешивается в `CUSTOM` (повторное открытие/«Дальше» синхронны). Встроенные уровни — offline, как раньше.
 - **Запись авторённого уровня (`customToLevel`)**: `{ id:'custom:<dbid>', dbid, title, chapter:(game.chapter||'custom'), order:(game.order|| 1000+dbid), unlockStars:(game.unlockStars||0), par_ms, subject, hint:(goal.hint), spec, _custom:true }`. Без `goal` → `null` (не уровень). Глава по умолчанию **`custom`** (новая `CHAPTERS.custom`, accent `#F472B6`) — map.js рисует автоматически (метадата-driven, не тронут, контракт Ф2 подтверждён в 4-й раз). `order` дефолт `1000+dbid` ставит custom-уровни ПОСЛЕ встроенных в сортировке.
 - **Deep-link `?level=custom:<id>` открывается БЕЗ гейта `unlockStars`** (получатель ссылки/автор заходит прямо в уровень); встроенный `?level=<id>` — через `isUnlocked` как раньше. quantik.html: `Promise.all([loadProgress(), ensureCustom()])` до первого `map.render`, deep-link через `getAsync`. Прогресс по custom-уровням: `gameProgressSubmit('custom:<dbid>',…)` — `game_progress.level_id` TEXT≤120, двоеточие проходит, бэкенд НЕ менялся.
 - **Верификация Ф5**: `node --check` всех изменённых JS + inline обоих HTML — OK; headless vm-смоук (РЕАЛЬНЫЕ `_sim_expr`+`sim-builder`+`levels`, DOM-стаб) 7/7: blank без goal/game; материализация goal+game; round-trip `deepEqual`; non-game sim не включает слой; `validate` ловит пустой/битый `when`; `customToLevel` маппинг + дефолты + null-для-non-game — удалён. Бэкенд-тест `tests/quantik-authoring.test.js` 6/6 (создание game-уровня, чужой draft→403, published виден, share→`game_level_shared`+`/quantik`-ссылка+авто-публикация, >3 звезды→400). `npm test` 267/259 pass / 8 baseline fail (без новых); lint:routes 0. Эмодзи/eval/new Function — 0 (новый UI — inline SVG `.ic`, выражения — только `SimExpr`).
@@ -275,10 +275,18 @@ function validateSpec(spec) {
    clean.goal = cg;
  }
-  // game{} — зарезервированный блок мета-слоя (Фаза 1/5). Пропускаем как есть
+  // game{} — мета-слой игрового уровня (Фаза 1/5). Санитизируем ПОИМЁННО (как goal):
-  // (проверен общими лимитами: размер/глубина). Не исполняем.
+  // строки → sanitizeText (escape), числа → проверка типа, неизвестные ключи отбрасываем.
  // Иначе произвольная строка в game.* стала бы хранимым XSS у любого, кому раздали уровень.
  if (spec.game && typeof spec.game === 'object' && !Array.isArray(spec.game)) {
-    clean.game = spec.game;
+    const gm = spec.game;
    const cgm = {};
    if (gm.chapter !== undefined) cgm.chapter = sanitizeText(gm.chapter, 60);
    if (gm.subject !== undefined) cgm.subject = sanitizeText(gm.subject, 60);
    if (typeof gm.order === 'number') cgm.order = gm.order;
    if (typeof gm.par_ms === 'number') cgm.par_ms = gm.par_ms;
    if (typeof gm.unlockStars === 'number') cgm.unlockStars = gm.unlockStars;
    clean.game = cgm;
  }
  if (errs.length) return { ok: false, error: errs.slice(0, 8).join('; ') };
@@ -454,17 +462,24 @@ function share(req, res) {
  }
  const teacherName = (db.prepare('SELECT name FROM users WHERE id = ?').get(req.user.id) || {}).name || 'Учитель';
-  const simTitle = row.title || 'симуляция';
+  const isGame = row.cat === 'game';
-  const link = '/lab?sim=custom:' + row.id;
+  const simTitle = row.title || (isGame ? 'игровой уровень' : 'симуляция');
  // Игровой уровень открывается в «Квантике» (/quantik?level=custom:<id>),
  // обычная симуляция — в лаборатории (/lab?sim=custom:<id>). Фаза 5/6.
  const link = (isGame ? '/quantik?level=custom:' : '/lab?sim=custom:') + row.id;
  const notifType = isGame ? 'game_level_shared' : 'sim_shared';
  const notifMsg = isGame
    ? `Новый игровой уровень от ${teacherName}: «${simTitle}»`
    : `Новая симуляция от ${teacherName}: «${simTitle}»`;
  const recipients = db.prepare('SELECT user_id FROM class_members WHERE class_id = ?').all(classId).map(r => r.user_id);
  let sent = 0;
  for (const uid of recipients) {
    if (!uid || uid === req.user.id) continue;
-    pushNotif(uid, 'sim_shared', `Новая симуляция от ${teacherName}: «${simTitle}»`, link);
+    pushNotif(uid, notifType, notifMsg, link);
    sent++;
  }
-  res.json({ ok: true, sent, status: 'published' });
+  res.json({ ok: true, sent, status: 'published', link });
 }
 /* POST /api/custom-sims/:id/clone — копия спеки текущему пользователю как draft.
@@ -0,0 +1,136 @@
 'use strict';
 /**
 * Integration tests: Квантик Фаза 5 — авторинг/раздача игровых уровней.
 * Уровень = custom_sims с cat='game' + блок goal/game в спеке. Покрываем:
 *   - создание игрового уровня (goal+game принимаются validateSpec'ом);
 *   - доступ: чужой DRAFT игровой уровень → 403 (deep-link/embed не утечёт),
 *             свой draft / чужой published → виден;
 *   - раздача классу игрового уровня шлёт ДОЛГОВЕЧНОЕ уведомление со ссылкой
 *     /quantik?level=custom:<id> (тип game_level_shared), авто-публикация.
 */
 const { describe, it, before, after } = require('node:test');
 const assert = require('node:assert/strict');
 const { app, db, inject, getToken, cleanup } = require('./setup');
 // Mount /api/custom-sims on the shared test app (setup.js его не монтирует).
 app.use('/api/custom-sims', require('../src/routes/customSims'));
 after(() => cleanup());
 /* Минимальная валидная спека ИГРОВОГО уровня: goal + game-метаданные. */
 const GAME_SPEC = {
  specVersion: 1,
  meta: { title: 'Мой уровень' },
  viewport: { xmin: -1, xmax: 11, ymin: -1, ymax: 8 },
  params: [{ name: 'theta', label: 'Угол', min: 10, max: 80, step: 1, value: 45 }],
  physics: { enabled: true, gravity: { x: 0, y: -9.8 } },
  objects: [
    { id: 'ball', type: 'point', x: 0, y: 0, r: 7, body: { mass: 1, vx: 'cos(theta*pi/180)*10', vy: 'sin(theta*pi/180)*10' } },
    { type: 'circle', id: 'gate', x: 8, y: 1, r: 0.8, color: '#A78BFA' },
  ],
  goal: {
    title: 'Попади в портал',
    hint: 'Подбери угол',
    when: 'hypot(ball.x - 8, ball.y - 1) < 0.8',
    fail: 'ball.y < -1 || t > 8',
    stars: [{ when: 't*1000 <= 1500', label: 'Быстро' }],
  },
  game: { chapter: 'custom', order: 3, par_ms: 1500 },
 };
 function seedClass(teacherId, studentIds) {
  const code = 'C' + Math.random().toString(36).slice(2, 10).toUpperCase();
  const r = db.prepare(
    'INSERT INTO classes (name, teacher_id, invite_code) VALUES (?, ?, ?)'
  ).run('Класс ' + code, teacherId, code);
  const classId = Number(r.lastInsertRowid);
  const ins = db.prepare('INSERT INTO class_members (class_id, user_id) VALUES (?, ?)');
  for (const uid of studentIds) ins.run(classId, uid);
  return classId;
 }
 async function createGameLevel(token, overrides) {
  return inject('POST', '/api/custom-sims',
    Object.assign({ title: 'Мой уровень', cat: 'game', spec: GAME_SPEC }, overrides || {}), token);
 }
 describe('Квантик Ф5 — авторинг игровых уровней', () => {
  let teacher, otherTeacher, student, studentB, admin;
  before(async () => {
    teacher = await getToken('teacher');
    otherTeacher = await getToken('teacher');
    student = await getToken('student');
    studentB = await getToken('student');
    admin = await getToken('admin');
  });
  it('teacher creates a GAME level (cat=game, goal+game preserved)', async () => {
    const res = await createGameLevel(teacher.token);
    assert.equal(res.status, 201, `got ${res.status}: ${JSON.stringify(res.body)}`);
    const get = await inject('GET', `/api/custom-sims/${res.body.id}`, null, teacher.token);
    const s = get.body.sim;
    assert.equal(s.cat, 'game', 'cat=game accepted');
    assert.ok(s.spec.goal && s.spec.goal.when, 'goal.when preserved');
    assert.equal(s.spec.goal.stars.length, 1, 'star preserved');
    assert.ok(s.spec.game && s.spec.game.chapter === 'custom', 'game.chapter preserved');
    assert.equal(s.spec.game.order, 3, 'game.order preserved');
    assert.equal(s.spec.game.par_ms, 1500, 'game.par_ms preserved');
  });
  it("another user's DRAFT game level → 403 (deep-link / ensureSpec cannot leak)", async () => {
    const c = await createGameLevel(teacher.token); // draft
    const get = await inject('GET', `/api/custom-sims/${c.body.id}`, null, otherTeacher.token);
    assert.equal(get.status, 403, `got ${get.status}`);
    // student also cannot open another user's draft level
    const getS = await inject('GET', `/api/custom-sims/${c.body.id}`, null, student.token);
    assert.equal(getS.status, 403, `student got ${getS.status}`);
  });
  it('published game level is visible to any user (deep-link works)', async () => {
    const c = await createGameLevel(teacher.token, { status: 'published' });
    assert.equal(c.status, 201);
    const get = await inject('GET', `/api/custom-sims/${c.body.id}`, null, student.token);
    assert.equal(get.status, 200, 'student can read published game level');
    assert.ok(get.body.sim.spec.goal, 'goal present');
    // и присутствует в общем списке для другого учителя
    const list = await inject('GET', '/api/custom-sims', null, otherTeacher.token);
    assert.ok(list.body.sims.find(s => s.id === c.body.id && s.cat === 'game'), 'published game in list');
  });
  it('owner sees own draft game level (for editing)', async () => {
    const c = await createGameLevel(teacher.token);
    const get = await inject('GET', `/api/custom-sims/${c.body.id}`, null, teacher.token);
    assert.equal(get.status, 200, 'owner reads own draft');
  });
  it('share game level → game_level_shared notification with /quantik link + auto-publish', async () => {
    const classId = seedClass(teacher.userId, [student.userId, studentB.userId]);
    const c = await createGameLevel(teacher.token); // draft
    const simId = c.body.id;
    const res = await inject('POST', `/api/custom-sims/${simId}/share`, { classId }, teacher.token);
    assert.equal(res.status, 200, `got ${res.status}: ${JSON.stringify(res.body)}`);
    assert.equal(res.body.sent, 2, 'two students notified');
    assert.equal(res.body.status, 'published', 'auto-published');
    assert.equal(res.body.link, '/quantik?level=custom:' + simId, 'reports game link');
    const after = db.prepare('SELECT status FROM custom_sims WHERE id = ?').get(simId);
    assert.equal(after.status, 'published', 'sim auto-published in DB');
    const notif = db.prepare(
      "SELECT type, link FROM notifications WHERE user_id = ? AND type = 'game_level_shared' ORDER BY id DESC"
    ).get(student.userId);
    assert.ok(notif, 'student has game_level_shared notification');
    assert.equal(notif.link, '/quantik?level=custom:' + simId, 'notification links to /quantik');
  });
  it('rejects game level with too many stars (>3) (400)', async () => {
    const bad = {
      ...GAME_SPEC,
      goal: { ...GAME_SPEC.goal, stars: [{ when: 'a' }, { when: 'b' }, { when: 'c' }, { when: 'd' }] },
    };
    const res = await createGameLevel(teacher.token, { spec: bad });
    assert.equal(res.status, 400, `got ${res.status}`);
  });
 });
@@ -661,28 +661,398 @@
    }
  };
  /* ─────────────────────────────────────────────────────────────────────────
     Глава IV — «Квантовые законы» (созвездие): фирменные способности Квантика.
     Всё выражено через БЕЗОПАСНУЮ модель спеки (params/зоны/plot), без новых
     механик движка и без eval.
       Суперпозиция — у уровня ДВА тела-копии Квантика (ball + ball2), один общий
         «закон» (params) рулит обеими; победа — когда ОБЕ копии у своих порталов
         (goal.when ссылается на ball.* и ball2.*). Реюз мульти-body физики.
       Коллапс/прицел — на сцене всегда есть пунктирная «предсказанная траектория»
         (plot выражения пути от текущего закона). Способность «Прицел» в игре
         ставит паузу — игрок целится по предсказанной кривой до запуска.
       Туннелирование — на пути стоит запретная стена-зона (tunnelable). Проигрыш
         только когда стена задета И заряд не потрачен: fail:'wall.hit && tunnel < 1'.
         Игровой слой тратит ЭНЕРГИЮ (заработанную в SR-комнате) и делает
         inst.setParam('tunnel', 1) → стена временно проницаема. tunnel — НЕ слайдер
         (управляется только способностью); по умолчанию отсутствует в env → 0
         (неизвестная переменная SimExpr = 0) → стена сплошная.
     ──────────────────────────────────────────────────────────────────────── */
  var PHANTOM = '#C4B5FD';   // полупрозрачный «фантом» — вторая копия (ball2)
  var AIM = '#38BDF8';       // предсказанная траектория (пунктир)
  var TUNNEL_WALL = '#F472B6'; // tunnelable-стена (магента — «квантовый барьер»)
  /* helper: вторая копия-герой (ball2) — стартует из (sx,sy), полупрозрачный фантом. */
  function hero2(sx, sy, vxExpr, vyExpr) {
    return {
      id: 'ball2', type: 'point', r: 7, color: PHANTOM, opacity: 0.78,
      x: sx, y: sy,
      glow: true, glowColor: PHANTOM, trail: true, trailColor: PHANTOM, trailFade: true,
      body: { mass: 1, vx: vxExpr, vy: vyExpr }
    };
  }
  /* helper: портал-кольцо «фантомного» цвета (цель второй копии). */
  function portal2Objs(px, py, r) {
    return [
      { type: 'circle', x: px, y: py, r: r, color: PHANTOM, width: 3, glow: true, glowColor: PHANTOM },
      { type: 'circle', x: px, y: py, r: r * 0.45, color: PHANTOM, width: 2, opacity: 0.7 },
      { type: 'label', x: px, y: py + r + 0.9, text: 'портал-2', color: PHANTOM, size: 12 }
    ];
  }
  /* helper: пунктирная предсказанная траектория (plot) — для «прицела». */
  function aimPath(exprStr, a, b) {
    return {
      id: 'aim', type: 'plot', expr: exprStr, var: 'x',
      range: [a, b], samples: 120, color: AIM, width: 1.6, lineStyle: 'dashed', opacity: 0.6
    };
  }
  /* Уровень 12 (обучение суперпозиции): «Раздвоение» — две копии Квантика летят
     симметрично (вправо и влево) под ОДНИМ законом. Один (θ,v) обязан попасть в ОБА
     зеркальных портала. Симметрия гарантирует решение. */
  var L12_PX = 6.5, L12_PY = 0.7, L12_PR = 0.95;     // правый портал (для ball)
  var L12_PX2 = -6.5;                                 // левый портал (для ball2, зеркало)
  var superpos12 = {
    id: 'quantum-superpos-12',
    title: 'Раздвоение',
    chapter: 'quantum',
    order: 12,
    unlockStars: 19,
    par_ms: 1700,
    subject: 'physics',
    hint: 'Квантик в суперпозиции — он сразу в двух местах! Обе копии летят под ОДНИМ законом, зеркально. Подбери угол и скорость так, чтобы каждая копия попала в свой портал.',
    spec: {
      specVersion: 1,
      meta: { title: 'Суперпозиция: раздвоение', desc: 'Два тела, один закон. Симметричный бросок.' },
      viewport: { xmin: -9, xmax: 9, ymin: -1.2, ymax: 7, grid: true, axes: true, bg: BG },
      params: [
        { name: 'theta', label: 'Угол', min: 20, max: 80, step: 1, value: 50, unit: '°' },
        { name: 'v', label: 'Скорость', min: 5, max: 18, step: 0.5, value: 9, unit: 'м/с' }
      ],
      physics: { enabled: true, gravity: { x: 0, y: -9.8 } },
      objects: [
        { type: 'segment', x1: -9, y1: 0, x2: 9, y2: 0, color: GROUND, width: 2 }
      ].concat(portalObjs(L12_PX, L12_PY, L12_PR), portal2Objs(L12_PX2, L12_PY, L12_PR), [
        // ball летит вправо, ball2 — зеркально влево (тот же закон)
        hero(0, 0, 'v*cos(theta*pi/180)', 'v*sin(theta*pi/180)'),
        hero2(0, 0, '-v*cos(theta*pi/180)', 'v*sin(theta*pi/180)'),
        { type: 'readout', label: 'v', expr: 'v', unit: 'м/с', precision: 1 },
        { type: 'readout', label: 'θ', expr: 'theta', unit: '°', precision: 0 }
      ]),
      goal: {
        title: 'Обе копии — в порталы',
        hint: 'Победа — когда ОБЕ копии Квантика достигнут своих порталов одновременно.',
        when: 'hypot(ball.x - ' + L12_PX + ', ball.y - ' + L12_PY + ') < ' + L12_PR +
              ' && hypot(ball2.x - (' + L12_PX2 + '), ball2.y - ' + L12_PY + ') < ' + L12_PR,
        fail: 't > 6',
        stars: [
          { when: 't*1000 <= 1700', label: 'Быстро (≤1.7 с)' },
          { when: 'theta >= 55', label: 'Высокая дуга (θ ≥ 55°)' }
        ]
      }
    }
  };
  /* Уровень 13 (применение суперпозиции): «Две двери» — копии стартуют из РАЗНЫХ
     точек, но скорости связаны одним законом (ball вправо-вверх, ball2 влево-вверх
     одним законом). Обе зеркальные дуги должны перелететь центральную стену и
     одновременно войти в свои порталы на вершинах дуг — нужен точный общий закон. */
  var L13_PX = 5.0, L13_PY = 3.2, L13_PR = 0.85;   // правый портал (вершина дуги ball)
  var L13_PX2 = -5.0;                               // левый портал (зеркало, ball2)
  var L13_WALLH = 2.0;                              // центральная стена — дуги обязаны её перелететь
  var superpos13 = {
    id: 'quantum-superpos-13',
    title: 'Две двери',
    chapter: 'quantum',
    order: 13,
    unlockStars: 20,
    par_ms: 2000,
    subject: 'physics',
    hint: 'Две копии летят зеркально из центра — вправо и влево, под одним законом. Перебрось обе дуги через центральную стену так, чтобы вершина каждой дуги попала в свой портал.',
    spec: {
      specVersion: 1,
      meta: { title: 'Суперпозиция: две двери', desc: 'Один закон ведёт обе зеркальные копии в свои двери.' },
      viewport: { xmin: -7.5, xmax: 7.5, ymin: -1.2, ymax: 6, grid: true, axes: true, bg: BG },
      params: [
        { name: 'theta', label: 'Угол', min: 25, max: 80, step: 1, value: 50, unit: '°' },
        { name: 'v', label: 'Скорость', min: 6, max: 16, step: 0.5, value: 10, unit: 'м/с' }
      ],
      physics: { enabled: true, gravity: { x: 0, y: -9.8 } },
      objects: [
        { type: 'segment', x1: -7.5, y1: 0, x2: 7.5, y2: 0, color: GROUND, width: 2 },
        // центральная стена-препятствие (только визуал + ориентир; дуги должны быть выше)
        { type: 'segment', x1: 0, y1: 0, x2: 0, y2: L13_WALLH, color: '#475569', width: 6 },
        { type: 'label', x: 0, y: L13_WALLH + 0.5, text: 'стена', color: '#94A3B8', size: 11 }
      ].concat(portalObjs(L13_PX, L13_PY, L13_PR), portal2Objs(L13_PX2, L13_PY, L13_PR), [
        // обе копии стартуют из центра (0, 0.2): ball вправо, ball2 зеркально влево
        hero(0, 0.2, 'v*cos(theta*pi/180)', 'v*sin(theta*pi/180)'),
        hero2(0, 0.2, '-v*cos(theta*pi/180)', 'v*sin(theta*pi/180)'),
        { type: 'readout', label: 'v', expr: 'v', unit: 'м/с', precision: 1 },
        { type: 'readout', label: 'θ', expr: 'theta', unit: '°', precision: 0 }
      ]),
      goal: {
        title: 'Обе копии — в свои двери',
        hint: 'Закон один на двоих. Обе зеркальные копии должны войти в свои порталы на вершинах дуг.',
        when: 'hypot(ball.x - ' + L13_PX + ', ball.y - ' + L13_PY + ') < ' + L13_PR +
              ' && hypot(ball2.x - (' + L13_PX2 + '), ball2.y - ' + L13_PY + ') < ' + L13_PR,
        fail: 't > 6',
        stars: [
          { when: 't*1000 <= 2000', label: 'Быстро (≤2.0 с)' },
          { when: 'v <= 11', label: 'Экономный бросок (v ≤ 11)' }
        ]
      }
    }
  };
  /* Уровень 14 (обучение прицела/коллапса): «Прицел» — бросок под углом к порталу,
     на сцене всегда видна предсказанная траектория (пунктир). Способность «Прицел»
     (в игре) ставит паузу: целься по кривой до запуска. */
  var L14_PX = 8.6, L14_PY = 4.4, L14_PR = 0.8;
  var L14_CX = 5.0, L14_CY = 5.2, L14_CR = 0.7;
  // предсказанная траектория: парабола броска y = tan(θ)·x − g·x² / (2·v²·cos²θ)
  var L14_AIM = 'tan(theta*pi/180)*x - 9.8*x^2 / (2*v^2*cos(theta*pi/180)^2)';
  var aimer14 = {
    id: 'quantum-aim-14',
    title: 'Прицел',
    chapter: 'quantum',
    order: 14,
    unlockStars: 22,
    par_ms: 1600,
    subject: 'physics',
    hint: 'Пунктирная линия — предсказанная траектория Квантика для текущего закона. Способность «Прицел» ставит паузу: целься по кривой, затем коллапсируй (запусти) в портал.',
    spec: {
      specVersion: 1,
      meta: { title: 'Коллапс: прицел', desc: 'Предсказанная траектория параболы броска.' },
      viewport: { xmin: -1, xmax: 11, ymin: -1.2, ymax: 8, grid: true, axes: true, bg: BG },
      params: [
        { name: 'theta', label: 'Угол', min: 20, max: 80, step: 1, value: 55, unit: '°' },
        { name: 'v', label: 'Скорость', min: 6, max: 18, step: 0.5, value: 11, unit: 'м/с' }
      ],
      physics: { enabled: true, gravity: { x: 0, y: -9.8 } },
      objects: [
        { type: 'segment', x1: -1, y1: 0, x2: 11, y2: 0, color: GROUND, width: 2 },
        aimPath(L14_AIM, 0, 10.5)
      ].concat(crystalObjs(L14_CX, L14_CY, L14_CR), portalObjs(L14_PX, L14_PY, L14_PR), [
        hero(0, 0, 'v*cos(theta*pi/180)', 'v*sin(theta*pi/180)'),
        { type: 'readout', label: 'v', expr: 'v', unit: 'м/с', precision: 1 },
        { type: 'readout', label: 'θ', expr: 'theta', unit: '°', precision: 0 }
      ]),
      goal: {
        title: 'Прицелься и попади в портал',
        hint: 'Веди предсказанную кривую в портал, затем запусти. Бонус: задень кристалл на дуге.',
        when: 'hypot(ball.x - ' + L14_PX + ', ball.y - ' + L14_PY + ') < ' + L14_PR,
        fail: 'ball.x > 10.6 || ball.y < -1.0',
        stars: [
          { when: 'hypot(ball.x - ' + L14_CX + ', ball.y - ' + L14_CY + ') < ' + L14_CR, label: 'Собрал кристалл' },
          { when: 't*1000 <= 1600', label: 'Быстро (≤1.6 с)' }
        ]
      }
    }
  };
  /* Уровень 15 (обучение туннелирования): «Квантовый барьер» — Квантик едет по
     прямой к порталу, но на пути СТЕНА (tunnelable-зона). Без заряда стена сплошная
     (задел → проигрыш). Способность «Туннель» (за энергию) делает стену проницаемой:
     fail:'wall.hit && tunnel < 1'. */
  var tunnel15 = {
    id: 'quantum-tunnel-15',
    title: 'Квантовый барьер',
    chapter: 'quantum',
    order: 15,
    unlockStars: 24,
    par_ms: 5200,
    subject: 'physics',
    hint: 'Стена-барьер преграждает путь напрямую, обойти её нельзя. Накопи энергию в комнате повторения и потрать заряд туннелирования — Квантик пройдёт СКВОЗЬ барьер.',
    spec: {
      specVersion: 1,
      meta: { title: 'Туннелирование: барьер', desc: 'Прохождение сквозь барьер за квантовый заряд.' },
      viewport: { xmin: -1, xmax: 11, ymin: -1, ymax: 8, grid: true, axes: true, bg: BG },
      time: { duration: 5, loop: false },
      params: [
        { name: 'a', label: 'Наклон a', min: -0.3, max: 0.5, step: 0.02, value: 0.1 },
        { name: 'b', label: 'Высота b', min: 2.5, max: 4.5, step: 0.1, value: 3.5 }
      ],
      objects: [
        // барьер ровно поперёк пути (вертикальный брус в центре, перекрывает весь коридор по y)
        { type: 'zone', id: 'wall', kind: 'forbidden', shape: 'rect', x: 5, y: 3.5, w: 0.8, h: 7.2,
          color: TUNNEL_WALL, label: 'барьер' },
        // целевой портал справа
        circZone('gate', 'target', 9.5, 3.5, 0.95, 'портал'),
        // бонус-монета сразу за барьером
        circZone('coin', 'collect', 6.5, 3.5, 0.6, 'монета'),
        startMarker(0, 3.5),
        road('a*x + b', 0, 9.5, 5),
        graphHero(),
        { type: 'readout', label: 'a', expr: 'a', precision: 2 },
        { type: 'readout', label: 'b', expr: 'b', precision: 1 }
      ],
      goal: {
        title: 'Пройди сквозь барьер',
        hint: 'Доберись до портала. Барьер задержит Квантика, пока не потрачен заряд туннелирования. Бонус: собери монету за барьером.',
        when: 'gate.hit',
        // проигрыш только если задел стену БЕЗ заряда туннеля (tunnel<1 ⇒ заряд не потрачен)
        fail: 'wall.hit && tunnel < 1',
        stars: [
          { when: 'coin.hit', label: 'Собрал монету' },
          { when: 'gate.hit && abs(b - 3.5) < 0.4', label: 'Ровный путь (b ≈ 3.5)' }
        ]
      }
    }
  };
  /* Уровень 16 (капстоун главы): «Сквозь стену в дверь» — комбо: бегунок-парабола,
     барьер-зона поперёк дуги (нужен туннель) и целевой портал за ним; монета на дуге. */
  var tunnel16 = {
    id: 'quantum-tunnel-16',
    title: 'Сквозь стену',
    chapter: 'quantum',
    order: 16,
    unlockStars: 26,
    par_ms: 6000,
    subject: 'physics',
    hint: 'Дуга-парабола ведёт к высокому порталу, но её пересекает квантовый барьер. Туннелируй сквозь него (за энергию) и подгони дугу так, чтобы попасть в дверь.',
    spec: {
      specVersion: 1,
      meta: { title: 'Туннель сквозь стену', desc: 'Парабола + барьер: туннель в портал.' },
      viewport: { xmin: -1, xmax: 11, ymin: -1, ymax: 9, grid: true, axes: true, bg: BG },
      time: { duration: 6, loop: false },
      params: [
        { name: 'a', label: 'Раскрытие a', min: -0.5, max: -0.15, step: 0.02, value: -0.3 },
        { name: 'k', label: 'Высота вершины k', min: 5, max: 8, step: 0.1, value: 6.5 }
      ],
      objects: [
        // барьер поперёк восходящей дуги (вертикальный брус)
        { type: 'zone', id: 'wall', kind: 'forbidden', shape: 'rect', x: 3.2, y: 4.0, w: 0.7, h: 8.4,
          color: TUNNEL_WALL, label: 'барьер' },
        // монета у самой вершины высокой дуги (k≈7) — совместима со 2-й звездой k≥6.8
        circZone('coin', 'collect', 5, 6.9, 0.85, 'монета'),
        circZone('gate', 'target', 9.3, 4.6, 0.95, 'портал'),
        startMarker(0, 0),
        road('a*(x-5)^2 + k', 0, 9.3, 6),
        graphHero(),
        { type: 'readout', label: 'a', expr: 'a', precision: 2 },
        { type: 'readout', label: 'k', expr: 'k', precision: 1 }
      ],
      goal: {
        title: 'Туннелем в дальний портал',
        hint: 'Туннелируй сквозь барьер и проведи дугу в портал. Бонус: задень монету на вершине.',
        when: 'gate.hit',
        fail: 'wall.hit && tunnel < 1',
        stars: [
          { when: 'coin.hit', label: 'Собрал монету' },
          { when: 'gate.hit && k >= 6.8', label: 'Высокая дуга (k ≥ 6.8)' }
        ]
      }
    }
  };
  var LEVELS = [
    artillery1, arc2, bounce3, pendulum4, orbit5, slingshot6,
-    graphLine7, graphSine8, graphParab9, graphAbs10, graphExp11
+    graphLine7, graphSine8, graphParab9, graphAbs10, graphExp11,
    superpos12, superpos13, aimer14, tunnel15, tunnel16
  ];
  /* Метаданные глав (созвездий) — для заголовков/оформления карты. */
  var CHAPTERS = {
    kinematics: { key: 'kinematics', title: 'Кинематика', subtitle: 'Полёт и гравитация', accent: '#22D3EE' },
    dynamics:   { key: 'dynamics',   title: 'Динамика',   subtitle: 'Силы, пружины, орбиты', accent: '#A78BFA' },
-    functions:  { key: 'functions',  title: 'Функции',    subtitle: 'Едем по кривой y = f(x)', accent: '#67E8F9' }
+    functions:  { key: 'functions',  title: 'Функции',    subtitle: 'Едем по кривой y = f(x)', accent: '#67E8F9' },
    quantum:    { key: 'quantum',    title: 'Квантовые законы', subtitle: 'Суперпозиция · прицел · туннель', accent: '#C4B5FD' },
    // Авторённые учителями уровни (custom_sims cat='game') без явной главы — сюда.
    custom:     { key: 'custom',     title: 'Уровни учителей', subtitle: 'Авторённые уровни сообщества', accent: '#F472B6' }
  };
-  function list() { return LEVELS.slice(); }
+  /* ── Авторённые уровни (Фаза 5): custom_sims с cat='game' ───────────────────
     Реестр становится «асинхронным»: встроенные уровни доступны сразу (offline),
     а опубликованные/свои игровые спеки подмешиваются после ensureCustom().
     Запись уровня из строки custom_sims: id='custom:<dbid>', метаданные — из
     spec.game (chapter/order/par_ms/unlockStars), spec — как есть. */
  var CUSTOM = [];                 // смёрженные записи авторённых уровней
  var _customPromise = null;       // кэш промиса загрузки (грузим один раз)
  /* Строка из LS.customSimsList/Get -> запись реестра уровня (или null). */
  function customToLevel(row) {
    if (!row || !row.spec || typeof row.spec !== 'object') return null;
    var spec = row.spec;
    if (!spec.goal) return null;   // не игровой уровень — пропускаем
    var gm = (spec.game && typeof spec.game === 'object') ? spec.game : {};
    var dbid = row.id;
    return {
      id: 'custom:' + dbid,
      dbid: dbid,
      title: row.title || (spec.meta && spec.meta.title) || 'Уровень',
      chapter: gm.chapter || 'custom',
      order: (typeof gm.order === 'number') ? gm.order : (1000 + Number(dbid)),
      unlockStars: (typeof gm.unlockStars === 'number') ? gm.unlockStars : 0,
      par_ms: (typeof gm.par_ms === 'number') ? gm.par_ms : undefined,
      subject: row.subject || (spec.goal && spec.goal.subject) || undefined,
      hint: (spec.goal && spec.goal.hint) || '',
      spec: spec,
      _custom: true
    };
  }
  /* Загрузить опубликованные + свои игровые custom_sims и смёржить.
     Возвращает Promise (кэшируется). Тихо игнорирует ошибки/отсутствие LS. */
  function ensureCustom() {
    if (_customPromise) return _customPromise;
    var LS = global.LS;
    if (!LS || !LS.customSimsList || !LS.customSimGet) {
      _customPromise = Promise.resolve([]);
      return _customPromise;
    }
    _customPromise = LS.customSimsList().then(function (r) {
      var sims = (r && r.sims) || [];
      // только игровая категория (список не содержит spec — его берём отдельно)
      var games = sims.filter(function (s) { return s && s.cat === 'game'; });
      return Promise.all(games.map(function (s) {
        return LS.customSimGet(s.id).then(function (g) {
          return customToLevel(g && g.sim);
        }).catch(function () { return null; });
      }));
    }).then(function (records) {
      CUSTOM = records.filter(Boolean);
      return CUSTOM.slice();
    }).catch(function () { CUSTOM = []; return []; });
    return _customPromise;
  }
  function list() { return LEVELS.concat(CUSTOM); }
  function get(id) {
-    for (var i = 0; i < LEVELS.length; i++) if (LEVELS[i].id === id) return LEVELS[i];
+    var all = list();
    for (var i = 0; i < all.length; i++) if (all[i].id === id) return all[i];
    return null;
  }
  /* Достать уровень по id асинхронно — для deep-link `custom:<dbid>`, когда он
     может ещё не быть в смёрженном списке (напр. свой draft). Резолвит через
     LS.customSimGet с проверкой доступа на сервере (own|published|admin). */
  function getAsync(id) {
    var found = get(id);
    if (found) return Promise.resolve(found);
    var m = /^custom:(\d+)$/.exec(String(id || ''));
    var LS = global.LS;
    if (!m || !LS || !LS.customSimGet) return Promise.resolve(null);
    return LS.customSimGet(m[1]).then(function (g) {
      var lvl = customToLevel(g && g.sim);
      if (lvl) {
        // подмешать в кэш, чтобы повторное открытие/«Дальше» нашло его синхронно
        if (!CUSTOM.some(function (c) { return c.id === lvl.id; })) CUSTOM.push(lvl);
      }
      return lvl;
    }).catch(function () { return null; });
  }
  function chapter(key) { return CHAPTERS[key] || { key: key, title: key, subtitle: '', accent: '#22D3EE' }; }
  global.QuantikLevels = {
-    list: list, get: get, chapter: chapter,
+    list: list, get: get, getAsync: getAsync, ensureCustom: ensureCustom, chapter: chapter,
-    LEVELS: LEVELS, CHAPTERS: CHAPTERS
+    LEVELS: LEVELS, CHAPTERS: CHAPTERS,
    customToLevel: customToLevel
  };
 })(typeof window !== 'undefined' ? window : this);
@@ -42,8 +42,11 @@
    var s = size || 16;
    var fill = filled ? '#FBBF24' : 'none';
    var stroke = filled ? '#FBBF24' : 'rgba(148,163,184,0.55)';
-    return '<svg class="ic" viewBox="0 0 24 24" width="' + s + '" height="' + s + '" fill="' + fill +
+    // Цвета — через inline style, а НЕ presentation-атрибуты: правило .ic в ls.css
-      '" stroke="' + stroke + '" stroke-width="1.5" stroke-linejoin="round"><path d="' + starPath() + '"/></svg>';
+    // (fill:none; stroke:currentColor) перебивает атрибуты fill/stroke, из-за чего
    // заработанные звёзды узлов не закрашивались. Inline style приоритетнее класса.
    return '<svg class="ic" viewBox="0 0 24 24" width="' + s + '" height="' + s +
      '" style="fill:' + fill + ';stroke:' + stroke + '" stroke-width="1.5" stroke-linejoin="round"><path d="' + starPath() + '"/></svg>';
  }
  function lockSvg(size) {
    var s = size || 18;
@@ -46,11 +46,10 @@
  }
  /* ── Разблокировка ────────────────────────────────────────────────────────
-     Уровень открыт, если СУММА звёзд во ВСЕХ предыдущих уровнях той же главы
+     Уровень открыт, если СУММА звёзд во ВСЕХ уровнях с меньшим ГЛОБАЛЬНЫМ order
-     (по полю order) ≥ level.unlockStars. Первый уровень главы (минимальный order
+     (по всем главам, не только текущей) ≥ level.unlockStars. Уровень с
-     или unlockStars==0) открыт всегда. Глава открывается, если открыт её первый
+     unlockStars==0 (или без него) открыт всегда. Так первый уровень главы
-     уровень — он гейтится суммой звёзд предыдущих глав через unlockStars==0
+     гейтится суммой звёзд всех предыдущих глав через свой порог unlockStars.
     первого уровня (по умолчанию) ИЛИ явным порогом.
     Чистая функция: вход — уровень + карта прогресса + ВЕСЬ список (для подсчёта
     «предыдущих» по order). Возвращает bool. */
@@ -0,0 +1,518 @@
 'use strict';
 /* ════════════════════════════════════════════════════════════════════════
   Квантик — Законы Мира · Квантовые способности + энергия + SR-комната (Фаза 4).
   Всё АДДИТИВНО и через БЕЗОПАСНУЮ модель (без eval/Function, без правок движка):
     - ЭНЕРГИЯ — клиентский ресурс в localStorage (ключ 'quantik-energy'). Чистая
       логика чтения/траты/начисления (window.QuantikEnergy) — тестируется headless.
     - СПОСОБНОСТИ на сцене уровня (window.QuantikAbilities.mountBar):
         «Туннель»  — тратит заряд → inst.setParam('tunnel', 1) (стена-барьер
                       уровня становится проницаемой; fail:'wall.hit && tunnel<1').
         «Прицел»   — ставит/снимает паузу: целься по предсказанной траектории
                       (пунктир-plot уже на сцене) до запуска.
     - SR-КОМНАТА (window.QuantikAbilities.openRestRoom) — мини-сессия повторения
       флешкарт прямо в игре: список колод → due-карты → лицо/оборот → оценка
       (шкала как в flashcards.html: Снова/Трудно/Знаю/Легко) → каждый «Знаю/Легко»
       начисляет энергию. Реюз серверного SR (LS.fcListDecks/fcStudySession/fcReview),
       НЕ iframe страницы флешкарт. Пусто (нет колод / нет due) — дружелюбное окно
       со ссылкой на /flashcards.
   ⛔ Без эмодзи (только inline SVG .ic). Без eval/Function.
   ════════════════════════════════════════════════════════════════════════ */
 (function (global) {
  var doc = global.document;
  /* ── Энергия: чистая логика над localStorage ─────────────────────────────
     Заряд — целое ≥0. Один «заряд туннеля» = TUNNEL_COST. За правильный ответ
     в SR-комнате — REWARD_GOOD (Знаю) / REWARD_EASY (Легко). */
  var ENERGY_KEY = 'quantik-energy';
  var ENERGY_MAX = 99;          // потолок (защита от переполнения хранилища)
  var TUNNEL_COST = 3;          // зарядов на одно туннелирование
  var REWARD_GOOD = 1;          // энергия за «Знаю»
  var REWARD_EASY = 2;          // энергия за «Легко»
  function _clampEnergy(n) {
    n = Math.floor(Number(n));
    if (!isFinite(n) || n < 0) n = 0;
    if (n > ENERGY_MAX) n = ENERGY_MAX;
    return n;
  }
  function getEnergy() {
    try {
      var v = global.localStorage && global.localStorage.getItem(ENERGY_KEY);
      return _clampEnergy(v == null ? 0 : v);
    } catch (_e) { return 0; }
  }
  function setEnergy(n) {
    var v = _clampEnergy(n);
    try { if (global.localStorage) global.localStorage.setItem(ENERGY_KEY, String(v)); } catch (_e) {}
    _notify(v);
    return v;
  }
  function grantEnergy(n) { return setEnergy(getEnergy() + _clampEnergy(n)); }
  function canSpend(n) { return getEnergy() >= _clampEnergy(n); }
  /* Потратить n зарядов. Возвращает true при успехе (хватило), иначе false (без списания). */
  function spendEnergy(n) {
    n = _clampEnergy(n);
    var cur = getEnergy();
    if (cur < n) return false;
    setEnergy(cur - n);
    return true;
  }
  /* Награда за оценку флешкарты (quality по шкале SR): Знаю(4)→GOOD, Легко(5)→EASY,
     остальные (Снова/Трудно) — 0. Чистая функция (для тестов). */
  function rewardForQuality(q) {
    if (q === 5) return REWARD_EASY;
    if (q === 4) return REWARD_GOOD;
    return 0;
  }
  /* подписчики на изменение энергии (HUD обновляется без перезагрузки) */
  var _subs = [];
  function onEnergyChange(cb) { if (typeof cb === 'function') _subs.push(cb); }
  function _notify(v) { for (var i = 0; i < _subs.length; i++) { try { _subs[i](v); } catch (_e) {} } }
  global.QuantikEnergy = {
    getEnergy: getEnergy, setEnergy: setEnergy, grantEnergy: grantEnergy,
    spendEnergy: spendEnergy, canSpend: canSpend, rewardForQuality: rewardForQuality,
    onEnergyChange: onEnergyChange,
    ENERGY_KEY: ENERGY_KEY, TUNNEL_COST: TUNNEL_COST,
    REWARD_GOOD: REWARD_GOOD, REWARD_EASY: REWARD_EASY, ENERGY_MAX: ENERGY_MAX
  };
  /* ════════════════════════════════════════════════════════════════════════
     DOM-хелперы (только если есть document — модуль грузится и в headless vm,
     где document может быть стабом без полноценного DOM).
     ════════════════════════════════════════════════════════════════════════ */
  function el(tag, cls, html) {
    var n = doc.createElement(tag);
    if (cls) n.className = cls;
    if (html != null) n.innerHTML = html;
    return n;
  }
  function escapeText(s) {
    return String(s == null ? '' : s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
  }
  /* ── inline SVG иконки (без эмодзи) ── */
  function boltIcon() {
    return '<svg class="ic" viewBox="0 0 24 24" fill="currentColor" stroke="none">' +
      '<path d="M13 2 4 14h6l-1 8 9-12h-6z"/></svg>';
  }
  function tunnelIcon() {
    return '<svg class="ic" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" ' +
      'stroke-linecap="round" stroke-linejoin="round"><path d="M4 20V11a8 8 0 0 1 16 0v9"/>' +
      '<path d="M9 20v-6a3 3 0 0 1 6 0v6"/></svg>';
  }
  function aimIcon() {
    return '<svg class="ic" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" ' +
      'stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="8"/>' +
      '<line x1="12" y1="2" x2="12" y2="6"/><line x1="12" y1="18" x2="12" y2="22"/>' +
      '<line x1="2" y1="12" x2="6" y2="12"/><line x1="18" y1="12" x2="22" y2="12"/>' +
      '<circle cx="12" cy="12" r="1.6" fill="currentColor"/></svg>';
  }
  function cardsIcon() {
    return '<svg class="ic" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" ' +
      'stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="5" width="13" height="15" rx="2"/>' +
      '<path d="M8 5V4a2 2 0 0 1 2-2h7a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-1"/></svg>';
  }
  /* ── tunnel-флаг уровня: спека ссылается на param 'tunnel' в fail? ──────────
     Если ни goal.fail, ни stars, ни goal.when не упоминают 'tunnel', способность
     «Туннель» бессмысленна для уровня → кнопка скрыта. */
  function levelHasTunnel(level) {
    var g = level && level.spec && level.spec.goal;
    if (!g) return false;
    var blob = String(g.fail || '') + ' ' + String(g.when || '');
    if (Array.isArray(g.stars)) for (var i = 0; i < g.stars.length; i++) blob += ' ' + String(g.stars[i] && g.stars[i].when || '');
    return /\btunnel\b/.test(blob);
  }
  /* ── aim-флаг уровня: на сцене есть объект-предсказание (id 'aim' или plot
     с lineStyle 'dashed')? Тогда способность «Прицел» осмысленна. */
  function levelHasAim(level) {
    var objs = level && level.spec && level.spec.objects;
    if (!Array.isArray(objs)) return false;
    for (var i = 0; i < objs.length; i++) {
      var o = objs[i];
      if (o && o.type === 'plot' && (o.id === 'aim' || o.lineStyle === 'dashed')) return true;
    }
    return false;
  }
  /* ════════════════════════════════════════════════════════════════════════
     Панель способностей + HUD энергии на сцене уровня.
       mountBar({ host, inst, level, onOpenRest }) -> { el, destroy, refresh }
     host — контейнер сцены (qg-stage). Кнопки появляются только если уместны
     для уровня. tunnel сбрасывается в 0 при каждом mount (новый уровень/попытка).
     ════════════════════════════════════════════════════════════════════════ */
  function mountBar(opts) {
    opts = opts || {};
    var host = opts.host, inst = opts.inst, level = opts.level;
    if (!host || !inst) return null;
    var onOpenRest = typeof opts.onOpenRest === 'function' ? opts.onOpenRest : function () {};
    var hasTunnel = levelHasTunnel(level);
    var hasAim = levelHasAim(level);
    var tunnelUsed = false;     // потрачен ли заряд в этой попытке
    // tunnel стартует выключенным каждую попытку (стена сплошная)
    try { inst.setParam('tunnel', 0); } catch (_e) {}
    var bar = el('div', 'qa-bar');
    // ── HUD энергии ──
    var meter = el('div', 'qa-energy', boltIcon() + '<span class="qa-energy-n">' + getEnergy() + '</span>');
    meter.title = 'Квантовая энергия — копится в комнате повторения';
    bar.appendChild(meter);
    // ── Кнопка «Комната повторения» (всегда — заработать энергию) ──
    var btnRest = el('button', 'qa-btn qa-rest', cardsIcon() + '<span>Повторение</span>');
    btnRest.type = 'button';
    btnRest.title = 'Повтори флешкарты — заработай квантовую энергию';
    btnRest.addEventListener('click', function () { onOpenRest(); });
    bar.appendChild(btnRest);
    // ── Способность «Туннель» ──
    var btnTunnel = null;
    if (hasTunnel) {
      btnTunnel = el('button', 'qa-btn qa-ability qa-tunnel',
        tunnelIcon() + '<span>Туннель</span><span class="qa-cost">' + boltIcon() + TUNNEL_COST + '</span>');
      btnTunnel.type = 'button';
      btnTunnel.addEventListener('click', function () {
        if (tunnelUsed) return;
        if (!canSpend(TUNNEL_COST)) { _flashHint(host, 'Не хватает энергии — повтори флешкарты'); refresh(); return; }
        if (!spendEnergy(TUNNEL_COST)) { refresh(); return; }
        tunnelUsed = true;
        try { inst.setParam('tunnel', 1); } catch (_e) {}
        _flashHint(host, 'Туннелирование активно — барьер проницаем');
        refresh();
      });
      bar.appendChild(btnTunnel);
    }
    // ── Способность «Прицел» (пауза-тоггл) ──
    var btnAim = null;
    if (hasAim) {
      btnAim = el('button', 'qa-btn qa-ability qa-aim', aimIcon() + '<span>Прицел</span>');
      btnAim.type = 'button';
      btnAim.title = 'Поставить паузу и прицелиться по предсказанной траектории';
      btnAim.addEventListener('click', function () {
        try {
          if (inst.isRunning()) { inst.pause(); }
          else { inst.play(); }
        } catch (_e) {}
        refresh();
      });
      bar.appendChild(btnAim);
    }
    function refresh() {
      var e = getEnergy();
      var n = meter.querySelector('.qa-energy-n');
      if (n) n.textContent = String(e);
      if (btnTunnel) {
        var dis = tunnelUsed || !canSpend(TUNNEL_COST);
        btnTunnel.disabled = dis;
        btnTunnel.classList.toggle('qa-on', tunnelUsed);
        btnTunnel.title = tunnelUsed ? 'Туннель уже активен в этой попытке'
          : (canSpend(TUNNEL_COST) ? 'Пройти сквозь барьер (−' + TUNNEL_COST + ' энергии)'
            : 'Нужно ' + TUNNEL_COST + ' энергии — повтори флешкарты');
      }
      if (btnAim) {
        var running = false; try { running = inst.isRunning(); } catch (_e) {}
        btnAim.classList.toggle('qa-on', !running);
        var lbl = btnAim.querySelector('span');
        if (lbl) lbl.textContent = running ? 'Прицел' : 'Цельтесь';
      }
    }
    // следить за изменением энергии (после SR-комнаты)
    var unsub = function () {};
    var sub = function (v) { refresh(); };
    onEnergyChange(sub);
    unsub = function () {
      var i = _subs.indexOf(sub);
      if (i >= 0) _subs.splice(i, 1);
    };
    host.appendChild(bar);
    refresh();
    return {
      el: bar,
      refresh: refresh,
      // сбросить tunnel-состояние (новая попытка того же уровня)
      resetAbilities: function () {
        tunnelUsed = false;
        try { inst.setParam('tunnel', 0); } catch (_e) {}
        refresh();
      },
      destroy: function () {
        unsub();
        if (bar.parentNode) bar.parentNode.removeChild(bar);
      }
    };
  }
  /* всплывающая подсказка над сценой (без эмодзи) */
  function _flashHint(host, text) {
    var t = el('div', 'qa-toast', escapeText(text));
    host.appendChild(t);
    requestAnimationFrame(function () { t.classList.add('show'); });
    setTimeout(function () {
      t.classList.remove('show');
      setTimeout(function () { if (t.parentNode) t.parentNode.removeChild(t); }, 320);
    }, 1900);
  }
  /* ════════════════════════════════════════════════════════════════════════
     SR-комната — модальная мини-сессия повторения флешкарт.
       openRestRoom({ host, onClose }) — асинхронно тянет колоды и due-карты.
     ════════════════════════════════════════════════════════════════════════ */
  function openRestRoom(opts) {
    opts = opts || {};
    var host = opts.host || doc.body;
    var onClose = typeof opts.onClose === 'function' ? opts.onClose : function () {};
    var LS = global.LS;
    var overlay = el('div', 'qa-overlay');
    var modal = el('div', 'qa-modal');
    overlay.appendChild(modal);
    host.appendChild(overlay);
    var earned = 0;   // энергия, начисленная за сессию
    function close() {
      if (overlay.parentNode) overlay.parentNode.removeChild(overlay);
      onClose(earned);
    }
    overlay.addEventListener('click', function (ev) { if (ev.target === overlay) close(); });
    function header(title) {
      var h = el('div', 'qa-modal-head');
      h.appendChild(el('div', 'qa-modal-title', cardsIcon() + '<span>' + escapeText(title) + '</span>'));
      var meter = el('div', 'qa-modal-energy', boltIcon() + '<span class="qa-modal-energy-n">' + getEnergy() + '</span>');
      h.appendChild(meter);
      var x = el('button', 'qa-modal-x', '&times;');
      x.type = 'button'; x.setAttribute('aria-label', 'Закрыть');
      x.addEventListener('click', close);
      h.appendChild(x);
      return h;
    }
    function setEnergyChip() {
      var n = modal.querySelector('.qa-modal-energy-n');
      if (n) n.textContent = String(getEnergy());
    }
    function renderMessage(title, msg, withFlashcardsLink) {
      modal.innerHTML = '';
      modal.appendChild(header('Комната повторения'));
      var body = el('div', 'qa-modal-body');
      body.appendChild(el('div', 'qa-empty-title', escapeText(title)));
      body.appendChild(el('div', 'qa-empty-msg', escapeText(msg)));
      var actions = el('div', 'qa-modal-actions');
      if (withFlashcardsLink) {
        var open = el('a', 'btn-primary qa-modal-btn', 'Открыть флешкарты');
        open.href = '/flashcards';
        actions.appendChild(open);
      }
      var done = el('button', 'btn-ghost qa-modal-btn', 'Закрыть');
      done.type = 'button';
      done.addEventListener('click', close);
      actions.appendChild(done);
      body.appendChild(actions);
      modal.appendChild(body);
    }
    function renderLoading() {
      modal.innerHTML = '';
      modal.appendChild(header('Комната повторения'));
      var body = el('div', 'qa-modal-body');
      body.appendChild(el('div', 'qa-loading', 'Загрузка колод…'));
      modal.appendChild(body);
    }
    if (!LS || !LS.fcListDecks || !LS.fcStudySession || !LS.fcReview) {
      renderMessage('Повторение недоступно', 'Не удалось подключиться к флешкартам. Попробуй позже.', false);
      return { el: overlay, close: close };
    }
    renderLoading();
    LS.fcListDecks().then(function (r) {
      var decks = (r && r.decks) || [];
      if (!decks.length) {
        renderMessage('Нет колод', 'Создай колоду флешкарт, чтобы повторять и зарабатывать энергию.', true);
        return;
      }
      // авто-выбор колоды с наибольшим числом due-карт
      var withDue = decks.filter(function (d) { return (d.due_count || 0) > 0; });
      if (!withDue.length) {
        renderMessage('Всё повторено', 'Сейчас нет карточек к повторению. Возвращайся позже — энергия копится повторением.', true);
        return;
      }
      withDue.sort(function (a, b) { return (b.due_count || 0) - (a.due_count || 0); });
      // если несколько колод с due — дать выбрать; иначе сразу учить
      if (withDue.length === 1) startStudy(withDue[0]);
      else renderDeckPicker(withDue);
    }).catch(function () {
      renderMessage('Ошибка', 'Не удалось загрузить колоды. Проверь соединение.', false);
    });
    function renderDeckPicker(decks) {
      modal.innerHTML = '';
      modal.appendChild(header('Выбери колоду'));
      var body = el('div', 'qa-modal-body');
      var list = el('div', 'qa-deck-list');
      decks.forEach(function (d) {
        var b = el('button', 'qa-deck', '');
        b.type = 'button';
        b.style.setProperty('--dk', d.color || '#9B5DE5');
        b.innerHTML = '<span class="qa-deck-dot"></span>' +
          '<span class="qa-deck-title">' + escapeText(d.title || 'Колода') + '</span>' +
          '<span class="qa-deck-due">' + (d.due_count || 0) + ' к повтору</span>';
        b.addEventListener('click', function () { startStudy(d); });
        list.appendChild(b);
      });
      body.appendChild(list);
      modal.appendChild(body);
    }
    /* ── Сессия изучения одной колоды ── */
    function startStudy(deck) {
      renderLoading();
      LS.fcStudySession(deck.id).then(function (r) {
        var cards = (r && r.cards) || [];
        if (!cards.length) {
          renderMessage('Всё повторено', 'В этой колоде нет карточек к повторению. Возвращайся позже.', false);
          return;
        }
        runSession(deck, cards.slice());
      }).catch(function () {
        renderMessage('Ошибка', 'Не удалось загрузить карточки колоды.', false);
      });
    }
    var RQ_GAP = 3;   // через сколько карт вернуть недоученную (как FC_RQ_GAP в flashcards.html)
    function runSession(deck, queue) {
      var idx = 0, done = 0, flipped = false;
      var seenCount = 0;
      function finish() {
        renderMessage('Готово!', 'Повторено ' + seenCount + ' карточек. Заработано энергии: ' + earned + '.', false);
      }
      function show() {
        if (idx >= queue.length) { finish(); return; }
        flipped = false;
        var card = queue[idx];
        modal.innerHTML = '';
        modal.appendChild(header(escapeText(deck.title || 'Повторение')));
        var body = el('div', 'qa-modal-body qa-study');
        // прогресс
        var total = done + (queue.length - idx);
        var prog = el('div', 'qa-prog');
        var fill = el('div', 'qa-prog-fill');
        fill.style.width = (total ? (done / total * 100) : 0) + '%';
        prog.appendChild(fill);
        body.appendChild(prog);
        body.appendChild(el('div', 'qa-prog-count', Math.min(done + 1, total) + ' / ' + total));
        // карточка
        var cardEl = el('div', 'qa-card');
        var front = el('div', 'qa-card-side qa-card-front');
        front.innerHTML = _cardHtml(card.front, card.front_image);
        cardEl.appendChild(front);
        var back = el('div', 'qa-card-side qa-card-back');
        back.innerHTML = _cardHtml(card.back, card.back_image);
        back.style.display = 'none';
        cardEl.appendChild(back);
        body.appendChild(cardEl);
        // кнопка «показать ответ» / оценки
        var flipBtn = el('button', 'btn-primary qa-flip', 'Показать ответ');
        flipBtn.type = 'button';
        body.appendChild(flipBtn);
        var grades = el('div', 'qa-grades');
        grades.style.display = 'none';
        // шкала как в flashcards.html: Снова(0) Трудно(3) Знаю(4) Легко(5)
        [
          { q: 0, l: 'Снова', cls: 'qa-g-again' },
          { q: 3, l: 'Трудно', cls: 'qa-g-hard' },
          { q: 4, l: 'Знаю', cls: 'qa-g-good' },
          { q: 5, l: 'Легко', cls: 'qa-g-easy' }
        ].forEach(function (g) {
          var gb = el('button', 'qa-grade ' + g.cls, g.l);
          gb.type = 'button';
          gb.addEventListener('click', function () { answer(card, g.q); });
          grades.appendChild(gb);
        });
        body.appendChild(grades);
        flipBtn.addEventListener('click', function () {
          if (flipped) return;
          flipped = true;
          back.style.display = '';
          flipBtn.style.display = 'none';
          grades.style.display = '';
        });
        modal.appendChild(body);
      }
      function answer(card, quality) {
        // награда сразу (оптимистично) — энергия за «Знаю/Легко»
        var rw = rewardForQuality(quality);
        if (rw > 0) { grantEnergy(rw); earned += rw; setEnergyChip(); }
        seenCount++;
        // отправляем отзыв; re-queue недоученных в пределах сессии
        var requeue = (quality < 3);   // фолбэк-эвристика, уточняется ответом
        LS.fcReview(card.id, quality).then(function (resp) {
          requeue = resp ? !resp.graduated : (quality < 3);
          advance(card, requeue);
        }).catch(function () {
          advance(card, requeue);
        });
      }
      function advance(card, requeue) {
        queue.splice(idx, 1);
        if (requeue) {
          var pos = Math.min(idx + RQ_GAP, queue.length);
          queue.splice(pos, 0, card);
        } else {
          done++;
        }
        if (idx >= queue.length) finish();
        else show();
      }
      show();
    }
    return { el: overlay, close: close };
  }
  /* безопасный рендер стороны карточки (текст escape, картинка — только свой /uploads) */
  function _cardHtml(text, image) {
    var html = '';
    if (image && /^\/uploads\/flashcards\/[A-Za-z0-9._-]+$/.test(image)) {
      html += '<img class="qa-card-img" src="' + image + '" alt=""/>';
    }
    if (text) html += '<div class="qa-card-text">' + escapeText(text) + '</div>';
    return html || '<div class="qa-card-text qa-card-empty">—</div>';
  }
  global.QuantikAbilities = {
    mountBar: mountBar,
    openRestRoom: openRestRoom,
    levelHasTunnel: levelHasTunnel,
    levelHasAim: levelHasAim
  };
 })(typeof window !== 'undefined' ? window : this);
@@ -46,30 +46,54 @@
  }
  /* Тинтуем героя уровня (объект с id 'ball') цветом скина — БЕЗ исполнения,
-     просто переписываем цветовые поля спеки-копии перед монтированием. */
+     просто переписываем цветовые поля спеки-копии перед монтированием.
     Фаза 4: вторую копию суперпозиции (id 'ball2') тоже тинтуем, но осветлённым
     «фантомным» оттенком (полупрозрачность задаётся самой спекой). */
  function tintHeroSpec(spec, skinKey) {
    var color = skinColor(skinKey);
    var phantom = lighten(color, 0.42);
    // глубокая копия (спека — данные, без функций) чтобы не мутировать реестр
    var copy = JSON.parse(JSON.stringify(spec));
    if (Array.isArray(copy.objects)) {
      for (var i = 0; i < copy.objects.length; i++) {
        var o = copy.objects[i];
-        if (o && o.id === 'ball') {
+        if (!o) continue;
        if (o.id === 'ball') {
          o.color = color;
          if (o.glow) o.glowColor = color;
          if (o.trail) o.trailColor = color;
        } else if (o.id === 'ball2') {
          o.color = phantom;
          if (o.glow) o.glowColor = phantom;
          if (o.trail) o.trailColor = phantom;
        }
      }
    }
    return copy;
  }
  /* Осветлить hex-цвет к белому на долю t (0..1). Для «фантома» суперпозиции.
     Принимает #RGB/#RRGGBB; прочее возвращает как есть. */
  function lighten(hex, t) {
    if (typeof hex !== 'string') return hex;
    var m = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.exec(hex.trim());
    if (!m) return hex;
    var h = m[1];
    if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
    var r = parseInt(h.slice(0, 2), 16), g = parseInt(h.slice(2, 4), 16), b = parseInt(h.slice(4, 6), 16);
    r = Math.round(r + (255 - r) * t); g = Math.round(g + (255 - g) * t); b = Math.round(b + (255 - b) * t);
    function hx(n) { var s = n.toString(16); return s.length === 1 ? '0' + s : s; }
    return '#' + hx(r) + hx(g) + hx(b);
  }
  /* ── Inline SVG звезды ── */
  function starSvg(filled) {
    var fill = filled ? '#FBBF24' : 'none';
    var stroke = filled ? '#FBBF24' : '#64748B';
-    return '<svg class="ic qg-star-svg" viewBox="0 0 24 24" width="34" height="34" fill="' + fill +
+    // Цвета через inline style: .ic в ls.css (fill:none; stroke:currentColor) иначе
-      '" stroke="' + stroke + '" stroke-width="1.6" stroke-linejoin="round">' +
+    // перебивает атрибуты fill/stroke и заработанные звёзды не закрашиваются.
    return '<svg class="ic qg-star-svg" viewBox="0 0 24 24" width="34" height="34" style="fill:' + fill +
      ';stroke:' + stroke + '" stroke-width="1.6" stroke-linejoin="round">' +
      '<polygon points="12 2 15.1 8.6 22 9.3 17 14.1 18.2 21 12 17.6 5.8 21 7 14.1 2 9.3 8.9 8.6"/></svg>';
  }
@@ -164,6 +188,17 @@
    return String(s == null ? '' : s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
  }
  /* ── Открыть SR-комнату (повторение флешкарт → энергия) ────────────────────
     Делегирует в QuantikAbilities.openRestRoom; после закрытия обновляет HUD
     панели способностей (энергия могла измениться). */
  function openRest(host, abilities) {
    if (!global.QuantikAbilities || !global.QuantikAbilities.openRestRoom) return;
    global.QuantikAbilities.openRestRoom({
      host: host,
      onClose: function () { if (abilities) try { abilities.refresh(); } catch (_e) {} }
    });
  }
  /* ── Старт уровня ───────────────────────────────────────────────────────
     opts: { host, level, skin?, onNext?(level), onMap?(), hasNext?, resolveNext? }
     resolveNext?() -> Promise<{ hasNext, next }>: пересчитать следующий уровень
@@ -180,6 +215,27 @@
    var spec = tintHeroSpec(level.spec, skin);
    var inst = global.SimEngine.mount(host, spec);
    // ── Панель квантовых способностей + HUD энергии (Фаза 4) ──
    // Аддитивно: монтируется только если доступен модуль; кнопки сами решают,
    // уместны ли они для уровня (tunnel/aim-флаги). SR-комната открывается отсюда.
    var abilities = null;
    if (global.QuantikAbilities && global.QuantikAbilities.mountBar) {
      abilities = global.QuantikAbilities.mountBar({
        host: host,
        inst: inst,
        level: level,
        onOpenRest: function () { openRest(host, abilities); }
      });
      // Убираем панель при destroy инстанса (оборачиваем существующий destroy).
      if (abilities) {
        var _origDestroy = inst.destroy.bind(inst);
        inst.destroy = function () {
          try { abilities.destroy(); } catch (_e) {}
          return _origDestroy();
        };
      }
    }
    var overlayRef = null;
    function clearOverlay() {
      if (overlayRef && overlayRef.overlay && overlayRef.overlay.parentNode) {
@@ -203,6 +259,7 @@
      overlayRef.btnAgain.addEventListener('click', function () {
        clearOverlay();
        try { inst.reset(); } catch (_e) {}
        if (abilities) try { abilities.resetAbilities(); } catch (_e) {}
      });
      overlayRef.btnNext.addEventListener('click', function () {
        clearOverlay();
@@ -5,6 +5,10 @@
 * dashboard.html используют window.PetSprite.render(...) — без дублей.
 */
 (function () {
  // Счётчик для УНИКАЛЬНЫХ id градиентов/клипов спрайта. Иначе два питомца с
  // одинаковыми level/mood/colorKey дают совпадающие id, и url(#id) заливки тела
  // резолвится в чужой (возможно display:none) градиент → тело без заливки.
  let _petUidSeq = 0;
  const PET_PALETTES = {
  purple:'#9B5DE5', cyan:'#06D6E0', gold:'#F9C74F',
  red:'#F94144',    green:'#38D95A', blue:'#4A90D9',
@@ -24,7 +28,7 @@
  const col   = PET_PALETTES[colorKey] || '#9B5DE5';
  const dark  = shadeColor(col, -45);
  const light = shadeColor(col,  52);
-  const uid   = `pg${level}${mood[0]}${colorKey[0]}`;
+  const uid   = `pg${(++_petUidSeq).toString(36)}`;
  const bodyPath = 'M55,22 C70,22 86,37 87,56 C89,75 78,94 55,97 C32,94 21,75 23,56 C24,37 40,22 55,22 Z';
  const eyeY = 52, eyeX1 = 40, eyeX2 = 70;
@@ -74,7 +74,15 @@
      params: [],
      objects: [],
      plots: [],          // храним plot-объекты отдельно для удобства UI, при сборке мерджим в objects
-      physics: { enabled: false, gx: 0, gy: -9.8, friction: 0, restitution: 0.9, walls: [], springs: [] }
+      physics: { enabled: false, gx: 0, gy: -9.8, friction: 0, restitution: 0.9, walls: [], springs: [] },
      // P5-Квантик: игровой слой (goal + игровые метаданные). enabled=false → goal/game
      // не попадают в спеку (обычная симуляция ведёт себя ровно как раньше).
      game: {
        enabled: false,
        when: '', title: '', hint: '', hold: '', fail: '',
        stars: [],                       // [{ when, label }], макс 3
        chapter: '', order: '', par_ms: ''
      }
    };
  }
@@ -91,7 +99,7 @@
    this._remountTimer = null;
    this._selObjId = null;                 // выбранный для drag-on-preview объект
    this._placing = false;                 // режим «поставить объект кликом»
-    this._open = { meta: true, params: true, objects: true, plots: true };
+    this._open = { meta: true, params: true, objects: true, plots: true, game: false };
    this._lastSpec = null;
    // P5: прямое манипулирование + история
    this._snap = false;                    // привязка к сетке при drag
@@ -226,6 +234,8 @@
      walls: (Array.isArray(ph.walls) ? ph.walls : []).map(function (w) { return Object.assign({ _uid: uid('w') }, w); }),
      springs: (Array.isArray(ph.springs) ? ph.springs : []).map(function (s) { return Object.assign({ _uid: uid('s') }, s); })
    };
    // game/goal (P5-Квантик): раскладываем spec.goal + spec.game обратно в st.game.
    st.game = loadGame(spec.goal, spec.game);
    this.st = st;
    // свежая загрузка (открытие симуляции / шаблон) — история начинается заново
    this._undo.length = 0; this._redo.length = 0; this._fieldSnapTaken = false;
@@ -272,6 +282,15 @@
      };
      spec.physics = ph;
    }
    // game/goal (P5-Квантик): материализуем игровой слой, если он включён.
    // goal{when,title,hint,hold,fail,stars[]} и game{chapter,order,par_ms}.
    if (st.game && st.game.enabled) {
      var goal = buildGoal(st.game);
      if (goal) spec.goal = goal;
      var game = buildGameMeta(st.game);
      if (game) spec.game = game;
    }
    return spec;
  };
@@ -321,6 +340,71 @@
    return s;
  }
  /* ── Игровой слой (P5-Квантик): goal/game ⇄ UI-состояние st.game ───────────
     st.game = { enabled, when, title, hint, hold, fail, stars:[{when,label}],
                 chapter, order, par_ms }. Хранит «как введено» (строки/числа) —
     материализация в spec.goal/spec.game на сборке, разбор обратно на загрузке. */
  /* spec.goal + spec.game -> st.game (для loadFromSim). Включаем игровой режим,
     если в спеке присутствует goal ИЛИ game. */
  function loadGame(goal, game) {
    var g = {
      enabled: false,
      when: '', title: '', hint: '', hold: '', fail: '',
      stars: [], chapter: '', order: '', par_ms: ''
    };
    if (goal && typeof goal === 'object') {
      g.enabled = true;
      g.when = goal.when == null ? '' : String(goal.when);
      g.title = goal.title == null ? '' : String(goal.title);
      g.hint = goal.hint == null ? '' : String(goal.hint);
      g.fail = goal.fail == null ? '' : String(goal.fail);
      g.hold = (goal.hold == null || goal.hold === '') ? '' : goal.hold;
      g.stars = (Array.isArray(goal.stars) ? goal.stars : []).map(function (s) {
        s = s || {};
        return {
          _uid: uid('star'),
          when: s.when == null ? '' : String(s.when),
          label: s.label == null ? '' : String(s.label)
        };
      });
    }
    if (game && typeof game === 'object') {
      g.enabled = true;
      g.chapter = game.chapter == null ? '' : String(game.chapter);
      g.order = (game.order == null || game.order === '') ? '' : game.order;
      g.par_ms = (game.par_ms == null || game.par_ms === '') ? '' : game.par_ms;
    }
    return g;
  }
  /* st.game -> spec.goal (или null, если нет ни одного содержательного поля). */
  function buildGoal(gm) {
    var out = {};
    if (trimStr(gm.when)) out.when = trimStr(gm.when);
    if (trimStr(gm.title)) out.title = trimStr(gm.title);
    if (trimStr(gm.hint)) out.hint = trimStr(gm.hint);
    if (trimStr(gm.fail)) out.fail = trimStr(gm.fail);
    if (gm.hold !== '' && gm.hold != null && isFinite(parseFloat(gm.hold))) out.hold = parseFloat(gm.hold);
    var stars = (Array.isArray(gm.stars) ? gm.stars : []).map(function (s) {
      var os = {};
      if (trimStr(s.when)) os.when = trimStr(s.when);
      if (trimStr(s.label)) os.label = trimStr(s.label);
      return os;
    }).filter(function (s) { return s.when || s.label; }).slice(0, 3);
    if (stars.length) out.stars = stars;
    return Object.keys(out).length ? out : null;
  }
  /* st.game -> spec.game (метаданные уровня; null, если все пусты). */
  function buildGameMeta(gm) {
    var out = {};
    if (trimStr(gm.chapter)) out.chapter = trimStr(gm.chapter);
    if (gm.order !== '' && gm.order != null && isFinite(parseFloat(gm.order))) out.order = parseFloat(gm.order);
    if (gm.par_ms !== '' && gm.par_ms != null && isFinite(parseFloat(gm.par_ms))) out.par_ms = parseFloat(gm.par_ms);
    return Object.keys(out).length ? out : null;
  }
  /* ════════════════════════ ЖИВОЕ ПРЕВЬЮ ════════════════════════ */
  Builder.prototype.scheduleRemount = function (immediate) {
@@ -609,6 +693,41 @@
    if (action === 'snap') { this.toggleSnap(); return; }
  };
  /* «Играть»: открыть текущую (в работе) спеку в игровом режиме для теста уровня.
     Монтируем тот же SimEngine в модалке — слой цели (HUD/победа/звёзды) активируется
     САМ наличием блока goal (Фаза 0 движка), как и в /quantik. Без сохранения/сети —
     тестируем прямо черновик. Если goal не задан, подсказываем включить игровой слой. */
  Builder.prototype.playGame = function () {
    var self = this;
    var spec = this.buildSpec();
    if (!spec.goal || !spec.goal.when) {
      global.LS.toast('Задайте цель (поле «победа») и включите игровой уровень', 'warn', 2600);
      return;
    }
    if (!global.SimEngine) { global.LS.toast('Движок не загружен', 'error'); return; }
    // Модалка с хост-узлом сцены; SimEngine монтируется после открытия. Инстанс
    // уничтожается в onClose — он срабатывает на ЛЮБОЕ закрытие (X / оверлей / Escape /
    // кнопка «Закрыть»), поэтому отдельный destroy в onClick кнопки не нужен.
    var host = global.document.createElement('div');
    host.style.cssText = 'position:relative;width:100%;height:min(70vh,560px);background:#0D0D1A;border-radius:10px;overflow:hidden';
    var inst = null;
    var m = global.LS.modal({
      title: 'Тест уровня', size: 'lg', content: '',
      onClose: function () { if (inst) { try { inst.destroy(); } catch (e) {} inst = null; } },
      actions: [
        { label: 'Сброс', onClick: function () { if (inst && inst.reset) { try { inst.reset(); } catch (e) {} } } },
        { label: 'Закрыть', primary: true, onClick: function () { m.close(); } }
      ]
    });
    m.body.appendChild(host);
    try {
      inst = global.SimEngine.mount(host, spec);
      if (inst && inst.play) inst.play();
    } catch (e) {
      host.innerHTML = '<div style="padding:30px;color:#ef4444">Ошибка запуска: ' + esc(e.message || e) + '</div>';
    }
  };
  /* Переключить привязку к сетке (drag будет округлять к шагу сетки). */
  Builder.prototype.toggleSnap = function () {
    this._snap = !this._snap;
@@ -764,6 +883,18 @@
      if (r < 0 || r > 1) errs.push('Упругость (restitution) должна быть в диапазоне 0..1.');
    }
    // game/goal (P5-Квантик): проверяем выражения цели/проигрыша/звёзд
    if (st.game && st.game.enabled) {
      checkExpr(typeof st.game.when === 'string' ? st.game.when : '', 'Цель: условие победы (when)');
      checkExpr(typeof st.game.fail === 'string' ? st.game.fail : '', 'Цель: условие проигрыша (fail)');
      if (!trimStr(st.game.when)) errs.push('Игровой уровень: укажите условие победы (when).');
      var starList = Array.isArray(st.game.stars) ? st.game.stars : [];
      if (starList.length > 3) errs.push('Максимум 3 звезды.');
      starList.forEach(function (s, i) {
        checkExpr(typeof s.when === 'string' ? s.when : '', 'Звезда #' + (i + 1) + ', условие');
      });
    }
    // размер JSON
    try {
      var bytes = new global.Blob([JSON.stringify(this.buildSpec())]).size;
@@ -833,7 +964,8 @@
      this.sectionMeta() +
      this.sectionParams() +
      this.sectionObjects() +
-      this.sectionPlotsPhysics();
+      this.sectionPlotsPhysics() +
      this.sectionGame();
    this.wirePanels();
  };
@@ -1134,6 +1266,72 @@
           section('physics', 'Физика', physBody, !!ph.enabled);
  };
  /* ── Игровой уровень (P5-Квантик) ─────────────────────────────────────────
     Панель «Цель» собирает блок goal (when/title/hint/hold/fail) + список звёзд
     (макс 3) + игровые метаданные (chapter/order/par_ms). Тумблер «Это игровой
     уровень» включает слой; выключенный — goal/game НЕ попадают в спеку.
     Выражения (when/fail/звёзды) проверяются inline через SimExpr.compile. */
  Builder.prototype.sectionGame = function () {
    var gm = this.st.game || {};
    var on = !!gm.enabled;
    // строка-выражение цели/проигрыша с inline-ошибкой
    function exprRow(key, label, val, ph) {
      var err = exprError(val);
      return '<div class="sbu-of' + (err ? ' has-err' : '') + '">' +
        '<label class="sbu-of-lbl">' + esc(label) +
          '<button class="sbu-fx" data-gfx="' + key + '" title="Палитра функций/параметров">fx</button>' +
        '</label>' +
        '<input class="sbu-in sbu-in-expr" data-gf="' + key + '" value="' + esc(val == null ? '' : val) + '" placeholder="' + esc(ph || 'условие (выражение)') + '" />' +
        (err ? '<span class="sbu-of-err">' + esc(err) + '</span>' : '') +
      '</div>';
    }
    var stars = Array.isArray(gm.stars) ? gm.stars : [];
    var starRows = stars.map(function (s, i) {
      var err = exprError(s.when);
      return '<div class="sbu-star" data-si="' + i + '">' +
        '<div class="sbu-star-hdr">' +
          '<span class="sbu-obj-type">Звезда ' + (i + 1) + '</span>' +
          '<span style="flex:1"></span>' +
          '<button class="sbu-icon-btn sbu-del" data-stardel="' + i + '" title="Удалить звезду">' + ICON.trash + '</button>' +
        '</div>' +
        '<div class="sbu-of' + (err ? ' has-err' : '') + '">' +
          '<label class="sbu-of-lbl">условие' +
            '<button class="sbu-fx" data-sfx="' + i + '" title="Палитра">fx</button>' +
          '</label>' +
          '<input class="sbu-in sbu-in-expr" data-sf="when" value="' + esc(s.when == null ? '' : s.when) + '" placeholder="напр. coin.hit" />' +
          (err ? '<span class="sbu-of-err">' + esc(err) + '</span>' : '') +
        '</div>' +
        miniField('подпись', '<input class="sbu-in" data-sf="label" value="' + esc(s.label == null ? '' : s.label) + '" placeholder="Собрал кристалл" />') +
      '</div>';
    }).join('');
    var inner =
      '<label class="sbu-of-check sbu-phys-toggle"><input type="checkbox" data-game="enabled"' + (on ? ' checked' : '') + '/> Это игровой уровень (Квантик)</label>' +
      '<div class="sbu-game-fields"' + (on ? '' : ' style="opacity:.45;pointer-events:none"') + '>' +
        '<div class="sbu-sub">Цель</div>' +
        exprRow('when', 'победа (when)', gm.when, 'напр. gate.hit или hypot(ball.x-8,ball.y-1)<0.8') +
        exprRow('fail', 'проигрыш (fail) — опц.', gm.fail, 'напр. ball.y < -1 || t > 8') +
        '<div class="sbu-row2">' +
          field('Заголовок цели', '<input class="sbu-in" data-gf="title" value="' + esc(gm.title || '') + '" placeholder="Попади в портал" />') +
          miniField('удержать, с (hold)', '<input class="sbu-in" type="number" step="0.1" min="0" data-gf="hold" value="' + esc(gm.hold == null ? '' : gm.hold) + '" placeholder="0" />') +
        '</div>' +
        field('Подсказка', '<textarea class="sbu-in" data-gf="hint" rows="2" placeholder="Краткая подсказка игроку">' + esc(gm.hint || '') + '</textarea>') +
        '<div class="sbu-sub">Звёзды (макс 3)</div>' +
        '<div class="sbu-stars-list">' + (starRows || '<div class="sbu-empty-sm">Нет звёзд-бонусов. Победа = 1-я звезда автоматически.</div>') + '</div>' +
        (stars.length < 3 ? '<button class="sbu-add sbu-add-sm" data-add="star">' + ICON.plus + ' Звезда</button>' : '') +
        '<div class="sbu-divider"></div>' +
        '<div class="sbu-sub">Метаданные уровня</div>' +
        '<div class="sbu-row4">' +
          miniField('глава', '<input class="sbu-in" data-gf="chapter" value="' + esc(gm.chapter || '') + '" placeholder="kinematics" />') +
          miniField('порядок', '<input class="sbu-in" type="number" data-gf="order" value="' + esc(gm.order == null ? '' : gm.order) + '" placeholder="1" />') +
          miniField('норматив, мс', '<input class="sbu-in" type="number" data-gf="par_ms" value="' + esc(gm.par_ms == null ? '' : gm.par_ms) + '" placeholder="1500" />') +
          '<span></span>' +
        '</div>' +
        '<button class="sbu-add sbu-add-sm" data-a2="play-game">' + ICON.play + ' Играть (тест уровня)</button>' +
      '</div>';
    return section('game', 'Игровой уровень (цель/звёзды)', inner, this._open.game);
  };
  /* ════════════════════════ ПРИВЯЗКА СОБЫТИЙ ПАНЕЛЕЙ ════════════════════════ */
  Builder.prototype.wirePanels = function () {
@@ -1468,6 +1666,61 @@
      });
    });
    // ── Игровой слой (P5-Квантик) ──
    var gameOn = p.querySelector('[data-game="enabled"]');
    if (gameOn) gameOn.addEventListener('change', function () {
      self.pushHistory();
      self.st.game.enabled = gameOn.checked;
      self.renderPanels(); self.scheduleRemount(false);
    });
    // goal/game поля (when/fail/title/hint/hold/chapter/order/par_ms)
    p.querySelectorAll('[data-gf]').forEach(function (el) {
      el.addEventListener('input', function () {
        self.snapField();
        var k = el.getAttribute('data-gf');
        self.st.game[k] = el.value;
        self.updateFieldFeedback(el, null);   // inline-ошибка выражения (when/fail)
        self.scheduleRemount(false);
      });
    });
    // звёзды: поля when/label
    p.querySelectorAll('.sbu-star').forEach(function (row) {
      var i = parseInt(row.getAttribute('data-si'), 10);
      row.querySelectorAll('[data-sf]').forEach(function (el) {
        el.addEventListener('input', function () {
          self.snapField();
          var k = el.getAttribute('data-sf');
          if (self.st.game.stars[i]) self.st.game.stars[i][k] = el.value;
          self.updateFieldFeedback(el, null);
          self.scheduleRemount(false);
        });
      });
    });
    p.querySelectorAll('[data-stardel]').forEach(function (b) {
      b.addEventListener('click', function () {
        self.pushHistory();
        self.st.game.stars.splice(parseInt(b.getAttribute('data-stardel'), 10), 1);
        self.renderPanels(); self.scheduleRemount(false);
      });
    });
    // fx-палитра для goal-выражений и условий звёзд
    p.querySelectorAll('[data-gfx]').forEach(function (b) {
      b.addEventListener('click', function () {
        var key = b.getAttribute('data-gfx');
        self.openPalette(p.querySelector('[data-gf="' + key + '"]'));
      });
    });
    p.querySelectorAll('[data-sfx]').forEach(function (b) {
      b.addEventListener('click', function () {
        var row = b.closest('.sbu-star');
        self.openPalette(row && row.querySelector('[data-sf="when"]'));
      });
    });
    // «Играть (тест уровня)» внутри панели
    p.querySelectorAll('[data-a2="play-game"]').forEach(function (b) {
      b.addEventListener('click', function () { self.playGame(); });
    });
    // add buttons
    p.querySelectorAll('[data-add]').forEach(function (b) {
      b.addEventListener('click', function () { self.onAdd(b.getAttribute('data-add')); });
@@ -1533,6 +1786,11 @@
      if (this.st.physics.springs.length >= LIMITS.springs) { global.LS.toast('Достигнут лимит пружин', 'warn'); return; }
      this.pushHistory();
      this.st.physics.springs.push({ _uid: uid('s'), a: '', b: '', k: 40, length: 2, damping: 0.5 });
    } else if (what === 'star') {
      this.st.game.stars = Array.isArray(this.st.game.stars) ? this.st.game.stars : [];
      if (this.st.game.stars.length >= 3) { global.LS.toast('Максимум 3 звезды', 'warn'); return; }
      this.pushHistory();
      this.st.game.stars.push({ _uid: uid('star'), when: '', label: '' });
    }
    this.renderPanels();
    this.scheduleRemount(false);
@@ -220,12 +220,133 @@
    .qg-star-svg { filter: drop-shadow(0 2px 6px rgba(251,191,36,0.4)); }
    .qg-star-on { animation: qgStarPop .45s cubic-bezier(.22,1.3,.4,1) backwards; animation-delay: calc(.12s * var(--si, 0) + .15s); }
    @keyframes qgStarPop { 0% { transform: scale(0) rotate(-30deg); opacity: 0; } 70% { transform: scale(1.25) rotate(6deg); } 100% { transform: scale(1) rotate(0); opacity: 1; } }
    /* Доступность: уважаем prefers-reduced-motion. Делаем анимации мгновенными
       (а не выключаем) — иначе forwards-анимация появления узлов (.qm-in/qmNodeIn)
       не применит конечное состояние и узлы останутся скрытыми. Циклы (пульс/мерцание/
       покачивание) при этом фактически останавливаются (1 итерация мгновенно). */
    @media (prefers-reduced-motion: reduce) {
      *, *::before, *::after {
        animation-duration: .01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: .01ms !important;
        scroll-behavior: auto !important;
      }
    }
    .qg-stats { display: flex; justify-content: center; gap: 22px; margin-bottom: 20px; }
    .qg-stat { display: flex; flex-direction: column; gap: 3px; }
    .qg-stat-lbl { font-size: .68rem; font-weight: 600; text-transform: uppercase; letter-spacing: .04em; color: #8B9AAE; }
    .qg-stat-val { font-family: 'Unbounded', sans-serif; font-weight: 700; font-size: 1.05rem; color: #EAF0F8; font-variant-numeric: tabular-nums; }
    .qg-actions { display: flex; justify-content: center; gap: 10px; }
    .qg-btn { min-width: 118px; }
    /* ════════════════════ Квантовые способности (Фаза 4) ════════════════════ */
    /* Панель способностей + HUD энергии — оверлеем поверх сцены уровня. */
    .qa-bar {
      position: absolute; right: 12px; bottom: 12px; z-index: 12;
      display: flex; align-items: center; gap: 8px; flex-wrap: wrap; justify-content: flex-end;
      pointer-events: auto; max-width: calc(100% - 24px);
    }
    .qa-energy {
      display: inline-flex; align-items: center; gap: 5px;
      background: rgba(17,19,42,0.86); border: 1px solid rgba(251,191,36,0.4);
      border-radius: 99px; padding: 6px 12px 6px 10px; color: #FBBF24;
      font-family: 'Unbounded', sans-serif; font-weight: 700; font-size: .9rem; font-variant-numeric: tabular-nums;
      box-shadow: 0 6px 18px rgba(0,0,0,0.4);
    }
    .qa-energy .ic { width: 16px; height: 16px; color: #FBBF24; }
    .qa-btn {
      display: inline-flex; align-items: center; gap: 6px; font: inherit; font-size: .82rem; font-weight: 600;
      color: #E2E8F0; background: rgba(17,19,42,0.86); border: 1px solid rgba(148,163,184,0.28);
      border-radius: 99px; padding: 7px 13px; cursor: pointer; transition: .16s;
      box-shadow: 0 6px 18px rgba(0,0,0,0.4);
    }
    .qa-btn .ic { width: 16px; height: 16px; }
    .qa-btn:hover:not(:disabled) { border-color: rgba(196,181,253,0.6); color: #fff; background: rgba(30,33,66,0.94); }
    .qa-btn:disabled { opacity: .42; cursor: not-allowed; }
    .qa-rest { color: #67E8F9; border-color: rgba(34,211,238,0.32); }
    .qa-rest:hover:not(:disabled) { border-color: rgba(34,211,238,0.6); }
    .qa-tunnel { color: #F0ABFC; border-color: rgba(244,114,182,0.34); }
    .qa-aim    { color: #7DD3FC; border-color: rgba(56,189,248,0.34); }
    .qa-cost { display: inline-flex; align-items: center; gap: 2px; font-size: .74rem; color: #FBBF24; font-weight: 800; }
    .qa-cost .ic { width: 12px; height: 12px; color: #FBBF24; }
    .qa-ability.qa-on {
      color: #fff; border-color: rgba(196,181,253,0.85);
      box-shadow: 0 0 0 2px rgba(196,181,253,0.35), 0 6px 18px rgba(167,139,250,0.4);
    }
    /* всплывающая подсказка способности */
    .qa-toast {
      position: absolute; left: 50%; bottom: 70px; transform: translateX(-50%) translateY(8px); z-index: 14;
      background: rgba(13,13,26,0.94); border: 1px solid rgba(196,181,253,0.5); color: #E8EDF5;
      padding: 9px 16px; border-radius: 12px; font-size: .85rem; font-weight: 600;
      box-shadow: 0 12px 34px rgba(0,0,0,0.5); opacity: 0; transition: opacity .28s, transform .28s; pointer-events: none;
      max-width: 84%; text-align: center;
    }
    .qa-toast.show { opacity: 1; transform: translateX(-50%) translateY(0); }
    /* ── SR-комната (модалка повторения) ── */
    .qa-overlay {
      position: fixed; inset: 0; z-index: 60;
      display: flex; align-items: center; justify-content: center;
      background: rgba(7,7,18,0.78); backdrop-filter: blur(6px); padding: 16px;
    }
    .qa-modal {
      background: linear-gradient(180deg, #15173099, #0F1024EE), #14152C;
      border: 1px solid rgba(148,163,184,0.2); border-radius: 18px;
      width: min(460px, 96vw); max-height: 92vh; overflow: hidden;
      display: flex; flex-direction: column; box-shadow: 0 24px 70px rgba(0,0,0,0.6);
      animation: qg-pop .24s cubic-bezier(.22,1.1,.4,1);
    }
    .qa-modal-head {
      display: flex; align-items: center; gap: 10px; padding: 14px 16px;
      border-bottom: 1px solid rgba(148,163,184,0.16); flex-shrink: 0;
    }
    .qa-modal-title { display: inline-flex; align-items: center; gap: 8px; font-family: 'Unbounded', sans-serif; font-weight: 700; font-size: 1rem; color: #EAF0F8; flex: 1; min-width: 0; }
    .qa-modal-title .ic { width: 18px; height: 18px; color: #67E8F9; flex-shrink: 0; }
    .qa-modal-title span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
    .qa-modal-energy { display: inline-flex; align-items: center; gap: 4px; color: #FBBF24; font-weight: 800; font-variant-numeric: tabular-nums; }
    .qa-modal-energy .ic { width: 15px; height: 15px; color: #FBBF24; }
    .qa-modal-x { background: none; border: none; color: #94A3B8; font-size: 1.5rem; line-height: 1; cursor: pointer; padding: 0 4px; }
    .qa-modal-x:hover { color: #fff; }
    .qa-modal-body { padding: 18px 18px 20px; overflow-y: auto; }
    .qa-loading { text-align: center; color: #94A3B8; padding: 30px 0; }
    .qa-empty-title { font-family: 'Unbounded', sans-serif; font-weight: 700; font-size: 1.1rem; color: #EAF0F8; text-align: center; margin-bottom: 8px; }
    .qa-empty-msg { color: #A8B4C6; text-align: center; line-height: 1.5; margin-bottom: 18px; }
    .qa-modal-actions { display: flex; justify-content: center; gap: 10px; flex-wrap: wrap; }
    .qa-modal-btn { min-width: 130px; text-align: center; text-decoration: none; }
    .qa-deck-list { display: flex; flex-direction: column; gap: 8px; }
    .qa-deck {
      display: flex; align-items: center; gap: 10px; width: 100%; text-align: left;
      background: rgba(30,33,58,0.6); border: 1px solid rgba(148,163,184,0.18); border-radius: 12px;
      padding: 11px 13px; cursor: pointer; font: inherit; transition: .15s;
    }
    .qa-deck:hover { border-color: var(--dk, #9B5DE5); background: rgba(40,44,78,0.7); }
    .qa-deck-dot { width: 12px; height: 12px; border-radius: 50%; background: var(--dk, #9B5DE5); flex-shrink: 0; }
    .qa-deck-title { color: #E2E8F0; font-weight: 600; flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
    .qa-deck-due { color: #67E8F9; font-size: .76rem; font-weight: 700; flex-shrink: 0; }
    /* сессия повторения */
    .qa-prog { height: 6px; border-radius: 99px; background: rgba(148,163,184,0.2); overflow: hidden; margin-bottom: 6px; }
    .qa-prog-fill { height: 100%; background: linear-gradient(90deg, #22D3EE, #A78BFA); border-radius: 99px; transition: width .3s; }
    .qa-prog-count { text-align: right; font-size: .72rem; color: #8B9AAE; margin-bottom: 12px; font-variant-numeric: tabular-nums; }
    .qa-card {
      min-height: 130px; background: rgba(20,22,44,0.72); border: 1px solid rgba(148,163,184,0.18);
      border-radius: 14px; padding: 20px; margin-bottom: 14px; display: flex; flex-direction: column; gap: 12px;
    }
    .qa-card-side { display: flex; flex-direction: column; align-items: center; gap: 10px; }
    .qa-card-back { border-top: 1px dashed rgba(148,163,184,0.3); padding-top: 12px; }
    .qa-card-text { color: #E8EDF5; font-size: 1.02rem; line-height: 1.45; text-align: center; word-break: break-word; }
    .qa-card-empty { color: #64748B; }
    .qa-card-img { max-width: 100%; max-height: 160px; border-radius: 10px; }
    .qa-flip { width: 100%; }
    .qa-grades { display: grid; grid-template-columns: repeat(4, 1fr); gap: 6px; }
    .qa-grade { font: inherit; font-size: .82rem; font-weight: 700; color: #fff; border: none; border-radius: 10px; padding: 10px 4px; cursor: pointer; transition: filter .14s; }
    .qa-grade:hover { filter: brightness(1.12); }
    .qa-g-again { background: #DC2626; }
    .qa-g-hard  { background: #D97706; }
    .qa-g-good  { background: #2563EB; }
    .qa-g-easy  { background: #16A34A; }
  </style>
 </head>
 <body>
@@ -271,10 +392,11 @@
 <!-- KaTeX для подписей сцены -->
 <script src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js"></script>
-<!-- уровни (данные) + логика прогресса + карта + игра -->
+<!-- уровни (данные) + логика прогресса + карта + способности + игра -->
 <script src="/js/game/levels.js"></script>
 <script src="/js/game/progress-logic.js"></script>
 <script src="/js/game/map.js"></script>
 <script src="/js/game/quantik-abilities.js"></script>
 <script src="/js/game/quantik-game.js"></script>
 <script>
 (function () {
@@ -411,17 +533,37 @@
  backBtn.addEventListener('click', showMap);
  // Подмешать авторённые уровни (custom_sims cat='game') до рендера карты (Ф5).
  function ensureCustomLevels() {
    if (window.QuantikLevels.ensureCustom) {
      return window.QuantikLevels.ensureCustom().catch(function () {});
    }
    return Promise.resolve();
  }
  // Старт: если ?level=<id> в URL и уровень доступен — открыть его, иначе карта.
-  loadProgress().then(function () {
+  // Сначала грузим прогресс И авторённые уровни (параллельно), затем deep-link.
  Promise.all([loadProgress(), ensureCustomLevels()]).then(function () {
    map.render(progressMap);
    var params = new URLSearchParams(location.search);
    var wantId = params.get('level');
    if (wantId) {
-      var lvl = window.QuantikLevels.get(wantId);
+      // custom:<id> может быть свой draft (нет в списке) — резолвим асинхронно с
-      if (lvl && window.QuantikProgress.isUnlocked(lvl, progressMap, window.QuantikLevels.list())) {
+      // проверкой доступа на сервере (own|published|admin → иначе 404/403 → карта).
-        openLevel(lvl);
+      var resolve = window.QuantikLevels.getAsync
-        return;
+        ? window.QuantikLevels.getAsync(wantId)
-      }
+        : Promise.resolve(window.QuantikLevels.get(wantId));
      resolve.then(function (lvl) {
        // Авторённый уровень (deep-link) — открываем без гейта unlockStars
        // (учитель/получатель ссылки заходит прямо в него). Встроенный — как раньше.
        var isCustom = /^custom:/.test(wantId);
        if (lvl && (isCustom || window.QuantikProgress.isUnlocked(lvl, progressMap, window.QuantikLevels.list()))) {
          openLevel(lvl);
        } else {
          showMapNoReload();
        }
      });
      return;
    }
    showMapNoReload();
  });
@@ -133,6 +133,12 @@
    .sbu-phys-fields { display: flex; flex-direction: column; gap: 8px; }
    .sbu-wall { display: flex; flex-direction: column; gap: 6px; }
    /* ── игровой уровень (P5-Квантик): цель + звёзды ── */
    .sbu-game-fields { display: flex; flex-direction: column; gap: 8px; }
    .sbu-stars-list { display: flex; flex-direction: column; gap: 8px; }
    .sbu-star { border: 1px solid var(--border); border-radius: 10px; padding: 9px; background: #fafbfd; display: flex; flex-direction: column; gap: 7px; }
    .sbu-star-hdr { display: flex; align-items: center; gap: 5px; }
    /* ── палитра ── */
    .sbu-pal { display: flex; flex-direction: column; gap: 12px; max-height: 60vh; overflow-y: auto; }
    .sbu-pal-title { font-size: .72rem; font-weight: 700; color: var(--text-3); margin-bottom: 5px; }
@@ -1046,7 +1046,7 @@ window.LS = {
  assistantContext, assistantSeen, assistantDismiss, assistantSettings, assistantAsk, assistantFlashcards, assistantFeedback, assistantMemory, assistantMemoryClear, imageGen, imageGenStatus,
  adminGetAssistant, adminSaveAssistant, adminTestAssistant, adminReindexTextbooks,
  adminSaveProvider, adminDeleteProvider, adminSetActiveProvider, adminAssistantModels,
-  fcListDecks, fcCreateDeck, fcAddCard,
+  fcListDecks, fcCreateDeck, fcAddCard, fcStudySession, fcReview,
  escapeHtml, esc,
  parseDate, fmtRelTime, safeHref,
  initPage,
@@ -1297,6 +1297,8 @@ async function adminAssistantModels(params) { const q = new URLSearchParams(para
 async function fcListDecks()         { return req('GET',  '/flashcards/decks'); }
 async function fcCreateDeck(d)       { return req('POST', '/flashcards/decks', d); }
 async function fcAddCard(deckId, d)  { return req('POST', `/flashcards/decks/${deckId}/cards`, d); }
 async function fcStudySession(deckId){ return req('GET',  `/flashcards/decks/${deckId}/study`); }
 async function fcReview(cardId, quality) { return req('POST', `/flashcards/cards/${cardId}/review`, { quality }); }
 async function deleteFile(id)                        { return req('DELETE', `/files/${id}`); }
 async function getFileAccess(id)                     { return req('GET',    `/files/${id}/access`); }
 async function assignFile(id, data)                  { return req('POST',   `/files/${id}/assign`, data); }
@@ -50,6 +50,43 @@
  `quantik.html` (per-level бейдж темы). Новые тесты: custom-sims.test.js +2 (приём zone+runner, отказ
  unknown type) — 26/26. Headless vm-смоук (per-level solvability + logic 29/29) зелёный и удалён.
  `npm test` 261 / 253 pass / 8 baseline fail (без новых); lint:routes 0; все `node --check` OK.
 - **Phase 4 реализован** (pending review): фирменные квантовые способности + SR-связка, ВСЁ через
  безопасную модель (движок `_sim_engine.js` НЕ тронут). Новый `frontend/js/game/quantik-abilities.js`:
  `window.QuantikEnergy` (клиентский ресурс энергии, localStorage `quantik-energy`, 0..99;
  grant/spend/canSpend/rewardForQuality; TUNNEL_COST=3, GOOD=1/EASY=2) + `window.QuantikAbilities`
  (`mountBar` — HUD энергии + кнопки «Повторение/Туннель/Прицел» оверлеем на сцене; `openRestRoom` —
  мини-сессия повторения флешкарт в модалке, реюз `LS.fcListDecks/fcStudySession/fcReview`, НЕ iframe).
  **Туннель** = тратит энергию → `inst.setParam('tunnel',1)`; барьер = `forbidden`-зона `wall`,
  `fail:'wall.hit && tunnel<1'` (tunnel — не слайдер, отсутствует в env → 0 → стена сплошная).
  **Прицел** = пауза-тоггл над пунктир-plot предсказанной траектории. **Суперпозиция** = чистый
  контент: 2 тела `ball`+`ball2`, `goal.when` с обоими. Глава `quantum` (L12–L16) + `CHAPTERS.quantum`
  в `levels.js`; карта рисует автоматически (map.js не тронут). `js/api.js` +2 врапера
  (`fcStudySession`, `fcReview`). `quantik.html` +script-тег +CSS `.qa-*`. **Backend НЕ тронут.**
  Все `node --check` OK (вкл. инлайн quantik.html); headless vm-смоук (РЕАЛЬНЫЕ движки):
  энергия + суперпозиция-оба-тела + tunnel-flips-fail + per-level solvability sweep (5/5 выигрываемы,
  full-star достижим, L15/L16 без tunnel = 0 win) + регресс 11 существующих уровней — 48/48, удалён.
  Контент-фикс: монета L16 (5,6)r0.7 → (5,6.9)r0.85 (была несовместима со 2-й звездой k≥6.8).
  `npm test` 261 / 253 pass / 8 baseline fail (без новых); lint:routes 0.
 - **Phase 5 реализован** (pending review): авторинг игровых уровней в sim-builder + раздача классу.
  ⚠️ **ПАРАЛЛЕЛЬНАЯ СЕССИЯ активна** на ветке (правит sim-builder + admin «games»), поэтому все правки
  sim-builder.js/.html — строго АДДИТИВНЫЕ (новые методы/панель/CSS-блок, существующие строки почти не
  тронуты). sim-builder: панель «Игровой уровень (цель/звёзды)» (`sectionGame` + wiring + `playGame` +
  helpers `loadGame`/`buildGoal`/`buildGameMeta`) — тумблер «Это игровой уровень» включает слой goal
  (`when/title/hint/hold/fail`) + до 3 звёзд (`when`+`label`) + метаданные (`chapter/order/par_ms`);
  выражения проверяются inline через `SimExpr.compile`. `blankState`/`loadFromSim`/`buildSpec`/`validate`
  расширены аддитивно (по 1 врезке каждый). Кнопка «Играть» монтирует SimEngine в модалке (HUD/победа
  активируются сами наличием `goal` — Ф0). Round-trip goal/game без потерь.
  Игра: `QuantikLevels` стал асинхронным — `ensureCustom()` грузит `custom_sims` cat='game' (свои+
  published) и мёржит как записи `custom:<dbid>`; `getAsync(id)` резолвит deep-link (own draft через
  `LS.customSimGet`). Новая глава `custom` в `CHAPTERS`. quantik.html: `Promise.all([loadProgress,
  ensureCustom])` до карты + deep-link `?level=custom:<id>` (без гейта unlockStars). Backend:
  `share()` для cat='game' шлёт `game_level_shared` со ссылкой `/quantik?level=custom:<id>` (иначе
  `/lab?sim=…`), ответ +`link`. `CATS` уже содержал 'game' (Ф0/Ф3); goal/game уже в validateSpec.
  Изменены: `frontend/js/sim-builder.js`, `frontend/sim-builder.html`, `frontend/js/game/levels.js`,
  `frontend/quantik.html`, `backend/src/controllers/customSimController.js`. Новый тест:
  `tests/quantik-authoring.test.js` (6/6). Headless round-trip-смоук (vm + реальные _sim_expr+sim-builder
  +levels) 7/7 — удалён. Все `node --check` OK (вкл. инлайн обоих HTML). `npm test` 267 / 259 pass /
  8 baseline fail (без новых); lint:routes 0.
 ## Key Architecture Decisions
 - **«Атом» = блок `goal` в спеке** (булево SimExpr). Любой уровень = спека SimForge + `goal`.
@@ -3,7 +3,7 @@
 **Branch:** `feature/quantik-game`
 **Base branch:** `feature/sim-builder` (движок P1–P3 и фазы sim-builder ещё не в master)
 **Created:** 2026-06-13
-**Status:** 🟡 In Progress
+**Status:** ✅ Complete (merged to feature/sim-builder, 2026-06-14)
 **Strategy:** Incremental
 **Mode:** Automated
 **Execution:** Orchestrator
@@ -62,9 +62,9 @@
 - [x] Phase 1: Оболочка игры + 1 физ-уровень + прогресс [domain: fullstack] → [subplan](./phase-1-shell-first-level.md)
 - [x] Phase 2: Карта-созвездие + мир физ-уровней + XP/скины [domain: fullstack] → [subplan](./phase-2-map-world-xp.md)
 - [x] Phase 3: Граф-уровни (движение по f(x)) + зоны-препятствия [domain: fullstack] → [subplan](./phase-3-graph-levels.md)
- [ ] Phase 4: Квантовые способности + SR-комнаты [domain: fullstack] → [subplan](./phase-4-quantum-abilities-sr.md)
+- [x] Phase 4: Квантовые способности + SR-комнаты [domain: fullstack] → [subplan](./phase-4-quantum-abilities-sr.md)
- [ ] Phase 5: Авторинг уровней в sim-builder + раздача классу [domain: fullstack] → [subplan](./phase-5-authoring-sharing.md)
+- [x] Phase 5: Авторинг уровней в sim-builder + раздача классу [domain: fullstack] → [subplan](./phase-5-authoring-sharing.md)
- [ ] Phase 6: Класс-лидерборд / живая гонка (classroom SSE) [domain: fullstack] → [subplan](./phase-6-leaderboard-live.md)
+- ~~Phase 6: Класс-лидерборд / живая гонка (classroom SSE)~~ — **REMOVED** (см. Amendment 1) → [subplan](./phase-6-leaderboard-live.md)
 ## Phase Progress Log
@@ -74,18 +74,34 @@
 | Phase 1: Оболочка + 1 уровень + прогресс | fullstack | ✅ Done | ✅ | ✅ | ✅ |
 | Phase 2: Карта + мир + XP/скины | fullstack | ✅ Done | ✅ (1 🟡 fixed) | ✅ | ✅ |
 | Phase 3: Граф-уровни + зоны | fullstack | ✅ Done | ✅ | ✅ | ✅ |
-| Phase 4: Квантовые способности + SR | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
+| Phase 4: Квантовые способности + SR | fullstack | ✅ Done | ✅ | ✅ | ✅ |
-| Phase 5: Авторинг + раздача | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
+| Phase 5: Авторинг + раздача | fullstack | ✅ Done | ✅ | ✅ | ✅ |
-| Phase 6: Лидерборд / живая гонка | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
+| ~~Phase 6: Лидерборд / живая гонка~~ | fullstack | ❌ Removed (Amendment 1) | — | — | — |
 ## MVP boundary
 После **Phase 2** игра играбельна и отгружаема: один полный мир физ-уровней с картой,
 прогрессом, XP и скинами. Фазы 3–6 — расширение (новые типы уровней, способности,
 авторинг, мультиплеер).
 ## Amendment Log
 ### Amendment 1 — 2026-06-14
 **Type:** Removed phase
 **What changed:** Phase 6 (Класс-лидерборд / живая гонка через classroom SSE) убрана из объёма по решению пользователя.
 **Why:** Пользователь решил не реализовывать соревновательный слой; переходим к полировке и финальному ревью после Ф5.
 **Impact on existing phases:** Нет. Фазы 0–5 самодостаточны и отгружаемы. `game_progress.level_id` (TEXT) уже готов под будущий лидерборд, если фичу вернут. Subplan `phase-6-leaderboard-live.md` сохранён как архив с пометкой REMOVED.
 ## Final Review
- [ ] Comprehensive code review (final-reviewer)
+- [x] Comprehensive code review (final-reviewer) — ✅ READY TO MERGE, 0 блокеров (2026-06-14)
- [ ] Security review (новые API: прогресс/лидерборд, user-input)
+- [x] Security review (новые API/ввод) — ✅ SECURE, 0 critical (2026-06-14)
- [ ] `npm test` без новых регрессий (поверх baseline)
+- [x] Polish-фиксы по ревью применены: game-блок санитизируется (был латентный XSS), prefers-reduced-motion guard, фикс комментария isUnlocked. Тесты 45/45 затронутых, lint 0.
- [ ] `npm run lint:routes` baseline 0
+- [x] `npm test` без новых регрессий (8 = baseline: 3 auth + 5 jsdom)
- [ ] Merged to `feature/sim-builder`
+- [x] `npm run lint:routes` baseline 0
 - [x] Merged to `feature/sim-builder` — merge commit `dabb370` (--no-ff), 2026-06-14. Post-merge: тесты = baseline, lint:routes 0.
 ### Deferred / Backlog (не блокеры — из финального ревью)
 - `QuantikLevels.ensureCustom` — N+1 `customSimGet` на загрузку /quantik; при росте числа авторённых уровней заменить на bulk-эндпоинт «список game-спек».
 - Уровни 3/5/6 (отскок/орбита/манёвр): `fail` — только таймаут, «честная» механика не форсится. Точечно ужесточить `fail`-предикаты (контент-тюнинг).
 - `graph-exp-11` капстоун узковат (~36–42/625) — при жалобах на сложность чуть расширить gate.
 - Три похожих `starSvg`/`_starIcon` в разных модулях — консолидация не стоит связывания движка с игрой (оставлено).
 - Клиентские очки прогресса фальсифицируемы (ожидаемо для single-player). ⚠️ Если когда-нибудь вернут Ф6-лидерборд — валидировать на сервере (replay/подписанные токены).
@@ -1,6 +1,6 @@
 # Phase 4: Квантовые способности + SR-комнаты
-**Status:** ⬜ Not Started
+**Status:** ✅ Done (reviewed — PASS, committed)
 **Parent plan:** [PLAN.md](./PLAN.md)
 **Domain:** fullstack
@@ -10,19 +10,21 @@
 (проход сквозь тонкую стену за «энергию», которую даёт быстрое SR-повторение).
 ## Tasks
- [ ] Task 1: Суперпозиция: уровень с двумя телами-копиями Квантика; общий «закон» (params) рулит
+- [x] Task 1: Суперпозиция: уровни L12/L13 с двумя телами `ball`+`ball2`, общий закон (theta,v)
-      обеими; цель — обе достигают порталов/условий (`goal.when` ссылается на оба `<id>.x/.y`).
+      рулит обеими зеркально; `goal.when` ссылается на `ball.*` И `ball2.*` (победа — только обе).
-      Реюз существующей мульти-body физики. Визуал — две glow-точки (полупрозрачные «фантомы»).
+      Реюз мульти-body физики. ball2 — полупрозрачный «фантом» (tintHeroSpec в quantik-game.js).
- [ ] Task 2: Коллапс/пауза-прицел: на паузе показать предсказанную траекторию (`plot trace`/
+- [x] Task 2: Коллапс/пауза-прицел: уровень L14 несёт пунктир-`plot` (id 'aim') с предсказанной
-      пунктир) текущего закона до запуска — «прицеливание». Реюз предпросмотра старта (P1/P2).
+      параболой текущего закона; способность «Прицел» = пауза-тоггл (`inst.pause/play`) для прицела.
- [ ] Task 3: Туннелирование: «энергетический заряд» расходуется, чтобы пройти сквозь помеченную
+- [x] Task 3: Туннелирование: барьер = `forbidden`-зона `wall`; `fail:'wall.hit && tunnel<1'`.
-      `tunnelable:true` стену (стена временно проницаема). Энергия в HUD.
+      Способность «Туннель» тратит TUNNEL_COST энергии → `inst.setParam('tunnel',1)` (стена
- [ ] Task 4: SR-комната: перед/в уровне — мини-сессия повторения флешкарт (реюз Tier-1 SR API,
+      проницаема). `tunnel` — НЕ слайдер (только способность); отсутствует в env → 0 → стена сплошная.
-      мигр.074). Правильные ответы дают «энергию туннелирования». Открыть существующий движок
+- [x] Task 4: SR-комната: `QuantikAbilities.openRestRoom` — мини-сессия повторения в модалке
-      повторения в модалке/панели игры; начислять заряды по результату.
+      (НЕ iframe). `LS.fcListDecks → fcStudySession → fcReview`; «Знаю/Легко» начисляют энергию.
- [ ] Task 5: Контент: 2–3 уровня под каждую способность (обучающий + применение).
+      Пусто (нет колод/нет due) → дружелюбное окно + ссылка `/flashcards`.
- [ ] Task 6: Тесты: суперпозиция (оба тела в `goal`), расход/начисление энергии (чистая логика),
+- [x] Task 5: Контент — глава `quantum` (5 уровней): L12/L13 суперпозиция, L14 прицел, L15/L16 туннель.
-      проницаемость стены при заряде; смоук.
+- [x] Task 6: Тесты (headless vm + РЕАЛЬНЫЕ движки): суперпозиция (оба тела), энергия (grant/spend/
      reward чистая логика), tunnel flips fail, per-level solvability sweep (5/5 выигрываемы,
      full-star достижим), регресс существующих 11 уровней без throw. 48/48; harness удалён.
 ## Files to Modify/Create
 - `frontend/js/labs/_sim_engine.js` — поле `tunnelable` у стены + расход энергии (аддитивно, документировать).
@@ -42,7 +44,45 @@
 - SR-движок повторения уже существует — переиспользовать, не дублировать расписание.
 ## Review Checklist
- [ ] Все задачи; аддитивность; без эмодзи/eval; тесты зелёные; lint baseline 0
+- [x] Все задачи; аддитивность; без эмодзи/eval; тесты зелёные; lint baseline 0
 ## Handoff to Next Phase
-<!-- Заполняет агент-имплементер. -->
+
 ### Что добавлено (файлы)
 - **Новый** `frontend/js/game/quantik-abilities.js` (`window.QuantikEnergy` + `window.QuantikAbilities`).
 - `frontend/js/game/levels.js` — глава `quantum` (L12–L16) + `CHAPTERS.quantum`.
 - `frontend/js/game/quantik-game.js` — `tintHeroSpec` тинтует `ball2` (фантом); `start()` монтирует
  `QuantikAbilities.mountBar` (оборачивает `inst.destroy` для снятия панели); `openRest()` + сброс
  `abilities.resetAbilities()` на «Ещё раз».
 - `frontend/quantik.html` — `<script src="/js/game/quantik-abilities.js">` (после map.js, до game.js)
  + CSS `.qa-*` (панель/HUD/тост/SR-модалка/карточка/оценки).
 - `js/api.js` — `fcStudySession(deckId)` (GET `/flashcards/decks/:id/study`) и
  `fcReview(cardId, quality)` (POST `/flashcards/cards/:id/review` body `{quality}`).
 - ⛔ Движок `_sim_engine.js` НЕ тронут — туннель/прицел/суперпозиция выражены через безопасную
  модель спеки (зона+undefined-param / pause-toggle / два тела). Engine touch = 0.
 ### Энергия (клиентский ресурс)
 - localStorage ключ **`quantik-energy`** (целое 0..`ENERGY_MAX`=99). `window.QuantikEnergy`:
  `getEnergy/setEnergy/grantEnergy/spendEnergy/canSpend/rewardForQuality/onEnergyChange`.
  `TUNNEL_COST=3`, `REWARD_GOOD=1` (q=4 «Знаю»), `REWARD_EASY=2` (q=5 «Легко»).
 - Туннель тратит энергию ОДИН раз за попытку (`tunnelUsed`); «Ещё раз»/новый mount сбрасывают
  `tunnel→0` (стена снова сплошная).
 ### Контракты для Phase 5 (авторинг)
 - **Способность «Туннель»** активируется, если `goal.fail/when/stars` упоминают слово `tunnel`
  (`QuantikAbilities.levelHasTunnel`). Авторский UI должен уметь добавить `forbidden`-зону `wall`
  и `fail:'wall.hit && tunnel<1'`. `tunnel` — служебный param (не слайдер).
 - **Способность «Прицел»** появляется, если на сцене есть `plot` с `id:'aim'` ИЛИ `lineStyle:'dashed'`
  (`levelHasAim`). Авторский UI может предложить «предсказанную траекторию» как пунктир-plot.
 - **Суперпозиция** = чистый контент: второе тело `id:'ball2'` (point/circle с `body`), `goal.when`
  с обоими `ball.*`+`ball2.*`. `tintHeroSpec` уже тинтует `ball`/`ball2`; авторские id вне этих
  двух тинтоваться скином не будут (Phase 5 при желании расширит).
 - **Глава = метаданные**: `quantum` появилась на карте без правок map.js (`groupByChapter` +
  `Levels.chapter`). Новая глава = новый `chapter`-ключ + `CHAPTERS`-запись (контракт Phase 2).
 ### Solvability (проверено на реальном движке, harness удалён)
 - L12 Раздвоение: 52 win-комбо (есть выигрышная v почти для любой θ), full-star напр. θ70/v10.
 - L13 Две двери: full-star θ45/v11. L14 Прицел: full-star θ60/v12 (2/2 звезды).
 - L15 барьер: с tunnel=1 — 4 win, full-star a0/b3.7; БЕЗ tunnel — 0 win (гейт работает).
 - L16 капстоун: с tunnel=1 — full-star a-0.25/k7.2 (монета сдвинута на (5,6.9) r0.85 — была (5,6)
  r0.7, конфликтовала со 2-й звездой k≥6.8); БЕЗ tunnel — 0 win.
@@ -1,6 +1,6 @@
 # Phase 5: Авторинг уровней в sim-builder + раздача классу
-**Status:** ⬜ Not Started
+**Status:** ✅ Done (reviewed — PASS, committed)
 **Parent plan:** [PLAN.md](./PLAN.md)
 **Domain:** fullstack
@@ -13,18 +13,18 @@
 быть смержен. При необходимости влить base в `feature/quantik-game` и разрешить конфликты.
 ## Tasks
- [ ] Task 1: Режим «Игровой уровень» в `sim-builder.js`/`.html`: панель цели (`goal.when`,
+- [x] Task 1: Режим «Игровой уровень» в `sim-builder.js`/`.html`: панель цели (`goal.when`,
      `title`, `hint`, `hold`, `fail`), список звёзд (add/del: `when`+`label`), глава/порядок/`par_ms`.
      Inline-проверка выражений через `SimExpr.compile().error` (как остальные поля билдера).
- [ ] Task 2: `buildSpec()` материализует блок `goal`/`game`; `loadFromSim()` раскладывает обратно
+- [x] Task 2: `buildSpec()` материализует блок `goal`/`game`; `loadFromSim()` раскладывает обратно
      (round-trip), как сделано с plot-range в Ф4 билдера.
- [ ] Task 3: Кнопка «Играть» в билдере — открыть текущую спеку в игровом режиме (тест уровня автором).
+- [x] Task 3: Кнопка «Играть» в билдере — открыть текущую спеку в игровом режиме (тест уровня автором).
- [ ] Task 4: Каталог уровней: игра грузит `custom_sims` c `cat='game'` (свои+published) — реюз
+- [x] Task 4: Каталог уровней: игра грузит `custom_sims` c `cat='game'` (свои+published) — реюз
      `LS.customSimsList`/`Get`. Категория `game` в списке `CATS` (customSimController) + фильтр.
- [ ] Task 5: Раздача классу: реюз паттерна Ф6 sim-builder (авто-публикация + `pushNotif` ученикам,
+- [x] Task 5: Раздача классу: реюз паттерна Ф6 sim-builder (авто-публикация + `pushNotif` ученикам,
      ссылка `/quantik?level=custom:<id>`); привязка к программе через `lab_sim_links` (`sim_id='custom:<id>'`).
- [ ] Task 6: Deep-link `/quantik?level=custom:<id>` (паттерн Ф5/Ф7 sim-builder, доступ own|published|admin).
+- [x] Task 6: Deep-link `/quantik?level=custom:<id>` (паттерн Ф5/Ф7 sim-builder, доступ own|published|admin).
- [ ] Task 7: Тесты: round-trip goal в билдере (headless как Ф4 sim-builder); доступ к чужому
+- [x] Task 7: Тесты: round-trip goal в билдере (headless как Ф4 sim-builder); доступ к чужому
      draft запрещён; published-уровень виден; раздача шлёт уведомление.
 ## Files to Modify/Create
@@ -43,7 +43,42 @@
 - Санитизация goal-полей — уже на сервере (Ф0). Клиентская валидация зеркалит её (как в Ф4 билдера).
 ## Review Checklist
- [ ] Все задачи; аддитивность билдера; ownership/доступ корректны; без эмодзи/eval; тесты зелёные
+- [x] Все задачи; аддитивность билдера; ownership/доступ корректны; без эмодзи/eval; тесты зелёные
 ## Handoff to Next Phase
-<!-- Заполняет агент-имплементер. -->
+
 ### Как авторённый уровень попадает в реестр игры
 - Хранилище: `custom_sims` с `cat='game'`. Спека = обычная SimForge-спека + блок
  `goal{when,title,hint,hold,fail,stars[]}` + блок `game{chapter,order,par_ms,unlockStars?}`.
 - `window.QuantikLevels` стал «асинхронным»: встроенные `LEVELS` доступны сразу (offline),
  а опубликованные/свои игровые спеки подмешиваются через **`QuantikLevels.ensureCustom()`**
  (Promise, кэш): `LS.customSimsList()` → фильтр `cat==='game'` → `LS.customSimGet(id)` каждой →
  `customToLevel(row)` → запись реестра. `list()` = `LEVELS.concat(CUSTOM)`; `get(id)` ищет в обоих.
 - **Форма записи авторённого уровня** (`customToLevel`): `{ id:'custom:<dbid>', dbid, title,
  chapter:(game.chapter||'custom'), order:(game.order||1000+dbid), unlockStars:(game.unlockStars||0),
  par_ms, subject, hint:(goal.hint), spec, _custom:true }`. Запись БЕЗ `goal` отбрасывается (не уровень).
 - Новая глава-созвездие **`custom`** в `CHAPTERS` (levels.js) — авторённые уровни без явной главы
  группируются в неё; map.js рисует автоматически (по метаданным, не тронут). Если автор задал
  `game.chapter='kinematics'` и т.п. — уровень встанет в соответствующее созвездие.
 ### Deep-link контракт
 - `/quantik?level=custom:<dbid>` → `QuantikLevels.getAsync('custom:<dbid>')`: если уже в кэше —
  синхронно; иначе `LS.customSimGet(dbid)` (сервер: доступ own|published|admin → иначе 404/403 → карта).
  Авторённый уровень по deep-link открывается БЕЗ гейта `unlockStars` (получатель ссылки заходит прямо).
  Встроенный `?level=<id>` — как раньше (через `isUnlocked`).
 - Прогресс игрока по авторённым уровням пишется так же: `LS.gameProgressSubmit('custom:<dbid>', ...)`
  (`game_progress.level_id` — TEXT ≤120, двоеточие проходит; бэкенд НЕ менялся).
 ### Share-flow
 - Реюз контроллера `customSimController.share` (Ф6). Для `cat==='game'` ссылка/тип уведомления
  переключены: link `/quantik?level=custom:<id>`, тип `game_level_shared` (обычная sim — `/lab?sim=…`,
  `sim_shared`). Авто-публикация + durable `pushNotif` ученикам класса. Ответ теперь содержит `link`.
 - Раздача игрового уровня из билдера — той же кнопкой «Раздать» (`openShareModal` → `LS.customSimShare`),
  отдельный UI не нужен. Курикулумная привязка — `lab_sim_links` `sim_id='custom:<id>'` (Ф6, не трогалось).
 ### Для Phase 6 (лидерборд / живая гонка)
 - Лидерборд может агрегировать `game_progress` по `level_id` (включая `custom:<dbid>`). Уровень-метаданные
  (title/chapter) для custom доступны через `QuantikLevels.getAsync` или прямой `LS.customSimGet`.
 - Живая гонка (мост `sim_state`) — он на base-ветке sim-builder Ф7; авторённый игровой уровень уже
  монтируется тем же `SimEngine`, что и встроенные, поэтому мост применим без изменений в этой фазе.
 - Авторинг-панель пишет `goal`/`game` только при `st.game.enabled` — обычные симуляции не затронуты.
@@ -1,6 +1,9 @@
 # Phase 6: Класс-лидерборд / живая гонка (classroom SSE)
-**Status:** ⬜ Not Started
+> **REMOVED (Amendment 1, 2026-06-14)** — фаза не реализуется по решению пользователя.
 > Архивный subplan. `game_progress.level_id` (TEXT) уже готов под лидерборд, если фичу вернут.
 **Status:** ❌ Removed
 **Parent plan:** [PLAN.md](./PLAN.md)
 **Domain:** fullstack
Author	SHA1	Message	Date
Maxim Dolgolyov	082a1ed010	@ docs(quantik-game): план завершён — фича смержена в feature/sim-builder Статус ✅ Complete; финальный чек-лист отмечен (merge `dabb370`). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 17:31:52 +03:00
Maxim Dolgolyov	dabb3706fe	@ merge: Квантик — Законы Мира (образовательная 2D-игра, фазы 0–5) Игра-головоломка на движке SimForge: слой goal (условие победы = безопасное SimExpr) + HUD; страница /quantik с картой-созвездием, 16 уровней в 4 главах (физика/графики/квантовые способности), прогресс (game_progress), XP/скины, нарратор-Квантик; граф-уровни (plot.runner + zone), квантовые способности (суперпозиция/коллапс/туннель) + SR-комната флешкарт; авторинг уровней в sim-builder + раздача классу + deep-link. Движок/бэкенд расширены аддитивно. Финальное ревью: READY TO MERGE (0 блокеров). Security: SECURE (0 critical). Фаза 6 (лидерборд) не реализована (решение пользователя). Тесты — baseline, lint:routes 0. @	2026-06-14 17:29:27 +03:00
Maxim Dolgolyov	69df2f8190	@ chore(quantik-game): полировка по финальному ревью + security-review Финальное ревью: READY TO MERGE (0 блокеров). Security: SECURE (0 critical). Применены дешёвые фиксы из ревью: - validateSpec: блок game{} санитизируется ПОИМЁННО (chapter/subject → sanitizeText, order/par_ms/unlockStars → проверка типа, неизвестные ключи отбрасываются) — закрыт латентный хранимый XSS (раньше clean.game=spec.game). - quantik.html: @media (prefers-reduced-motion) делает анимации мгновенными (не выключает — иначе forwards-появление узлов оставило бы их скрытыми). - progress-logic.js: фикс комментария isUnlocked (сумма звёзд по ВСЕМ уровням с меньшим глобальным order, а не «той же главы»). План: Ф6 (лидерборд/гонка) удалена (Amendment 1, решение пользователя); финальные гейты отмечены; deferred-бэклог зафиксирован. Затронутые тесты 45/45; lint:routes 0. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 17:00:13 +03:00
Maxim Dolgolyov	c780b6fd96	@ feat(quantik-game): фаза 5 — авторинг игровых уровней в sim-builder + раздача Учитель собирает игровой уровень без кода: новая (аддитивная, сворачиваемая) панель в sim-builder задаёт блок goal (when/title/hint/hold/fail) + до 3 звёзд + game-мету (chapter/order/par_ms); выражения проверяются inline через SimExpr.compile (без eval). buildSpec/loadFromSim — round-trip без потерь (goal/game пишутся только при включённом слое; обычная sim не меняется). Кнопка «Играть» монтирует черновик в SimEngine-модалке (HUD цели из Ф0). QuantikLevels стал async: подмешивает custom_sims cat=game (свои+ published) в реестр (custom:<dbid>), offline-safe, строки без goal отбрасываются; deep-link /quantik?level=custom:<id> с серверной проверкой доступа (own\|published → иначе 403/404), мимо геймплейного гейта unlockStars. Раздача классу — реюз share Ф6 (game-aware ссылка + durable pushNotif). Правки sim-builder строго аддитивны (параллельная сессия). npm test 259/8 baseline; quantik-authoring 6/6; lint:routes 0. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 16:09:10 +03:00
Maxim Dolgolyov	8db8171b97	@ fix(pet-sprite): уникальные id градиентов спрайта — фикс «пропадающего» тела uid градиента питомца строился детерминированно (pg+level+mood+colorKey), поэтому два питомца с одинаковыми параметрами на одной странице получали совпадающие id. url(#id) заливки тела резолвился в чужой градиент (часто в display:none-вьюхе) → тело без заливки, видны только контур/усики/аура. Проявлялось «случайно» — только при совпадении параметров (нарратор на карте vs на экране победы в /quantik). Теперь uid — глобальный счётчик (pg1, pg2, …), коллизий нет. Чинит и /pet, и /dashboard, и игру. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 10:59:17 +03:00
Maxim Dolgolyov	6e33be3de1	@ fix(quantik-game): отображать заработанные звёзды на узлах карты и экране победы Правило .ic в ls.css (fill:none; stroke:currentColor) перебивало presentation-атрибуты fill/stroke в starSvg → заработанные звёзды рисовались как пустые (CSS-свойства приоритетнее presentation-атрибутов). Цвета звёзд теперь задаются inline style (приоритетнее класса) и в map.js, и в quantik-game.js. Заодно звезда главы становится сплошной золотой. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 10:43:18 +03:00
Maxim Dolgolyov	0b1925fd3b	@ feat(quantik-game): фаза 4 — квантовые способности + SR-комнаты Глава-созвездие quantum (L12–L16) и фирменные механики — всё через безопасную модель спеки, движок и бэкенд НЕ тронуты (engine touch = 0): - Суперпозиция: два тела ball+ball2, goal.when требует ОБА (зеркальный закон). Туннелирование: forbidden-зона wall + fail wall.hit && tunnel<1; способность тратит энергию → setParam(tunnel,1). Коллапс/прицел: пунктир- plot предсказанной траектории на паузе. - Энергия — клиентский ресурс (localStorage quantik-energy, QuantikEnergy). - SR-комната: мини-сессия повторения флешкарт в модалке (НЕ iframe), LS.fcStudySession/fcReview; «Знаю/Легко» дают энергию; текст карт экранируется, картинки — по regex-вайтлисту. Все 5 уровней проверены на реальном движке (2★ достижимы; суперпозиция требует оба тела; туннель-гейт блокирует без заряда). npm test 253/8 baseline; lint:routes 0; цепочка разблокировки проходима. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> @	2026-06-14 10:29:35 +03:00