itube-specs 0.0.1003 → 0.0.1005

package/SITE_UPDATES.md

@@ -0,0 +1,46 @@
+# Что сделать в сайтах после обновления слоя
+
+Только то, что каждый сайт должен сделать у себя после `npm run spec`: объявить новую сущность, поправить
+свою логику, удалить файлы, переехавшие в слой. Описание изменений слоя — в истории git, не здесь.
+
+Сайт после `npm run spec` видит записи между своей прошлой и новой версией:
+`node node_modules/itube-specs/scripts/site-updates.mjs`.
+
+Пишет тот, кто меняет слой, в том же коммите. Новые записи — сверху, в секцию `## Unreleased` (одна на все
+коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
+кому именно (всем / сайтам с N), что будет, если не сделать.
+
+## 0.0.1005 — 2026-10-06
+
+- **Всем:** подключить этот файл к сайту, иначе пункты отсюда сайт не увидит.
+  - `package.json`, скрипт `spec`: дописать в конец
+    `&& (test ! -f node_modules/itube-specs/scripts/site-updates.mjs || node node_modules/itube-specs/scripts/site-updates.mjs)`.
+    Тогда `npm run spec` после установки печатает новые пункты и дописывает их в `SITE_TODO.md` в корне сайта —
+    файл остаётся, даже если `spec` запускал человек в своём терминале.
+  - `CLAUDE.md` сайта: правило «есть `SITE_TODO.md` — выполни пункты (или спроси пользователя, если нужен его
+    выбор), удали файл, коммит; меняешь слой сам — запись в `SITE_UPDATES.md` пишешь ты, см. `CLAUDE.md` слоя
+    § Site updates».
+  - Чтобы агент видел `SITE_TODO.md` без напоминаний — хук Claude Code `UserPromptSubmit`, который выводит этот
+    файл, если он есть (по желанию, настраивается у себя в `~/.claude/settings.json`).
+  - Пропустили прошлые версии — `node node_modules/itube-specs/scripts/site-updates.mjs <версия-до-обновления>`.
+
+## 0.0.1001 — 2026-10-06
+
+- **Всем:** удалить свои `public/img/model-placeholder-{portrait,square}.{webp,avif}` и
+  `model-placeholder-female-*`, если есть. Заглушки моделей теперь в слое
+  (`public/img/model-placeholder/<niche>-<theme>-<shape>`), старые пути слой больше не запрашивает.
+  Свой вариант картинки — файлом с тем же новым путём в `public/` сайта.
+
+## 0.0.1000 — 2026-10-06
+
+- **Сайтам с несколькими нишами, у которых ниша в URL не равна её коду** (`/gays` вместо `/gay`): одна
+  константа слагов → `nicheSlugs` в `app.config.ts` и `slugs` в `addNicheAliases` (`NEW_SITE_CHECKLIST.md` §3a).
+  Остальным — ничего.
+
+## 0.0.999 — 2026-10-06
+
+- **Всем:** флага нет в `config/feature-flags.config.ts` — фича выключена, дефолтов у слоя нет. Перечислить
+  все флаги явно по карте в `NEW_SITE_CHECKLIST.md` §4. Заглушки без бекенда (`FeatureFollowEnabled`,
+  `FeatureHistoryEnabled`, `FeatureFavoritesEnabled`, `FeatureWatchLaterEnabled`, `FeatureLiveEnabled`) — на
+  боевом сайте включать только осознанно; при выключенном флаге их страницы отдают 404.
+- **Всем:** `FeatureMomentsEnabled` и `SponsoredEnabled` слой не читает — можно убрать.

package/config/niches.ts

@@ -78,7 +78,7 @@ function isUnderRoot(path: string, roots: readonly string[]): boolean {
 }
 
 /**
- * Клонирует контентные разделы под нишевые префиксы — алиасом той же записи роута:
+ * Клонирует Контентные разделы под нишевые префиксы — алиасом той же записи роута:
  * `/videos/:slug` начинает отвечать и на `/gay/videos/:slug`. Алиасы статичные, по одному на нишу:
  * у алиаса vue-router требует те же параметры, что у оригинала, поэтому параметр `:niche` сюда нельзя.
  * Сайту с одной нишей ничего не добавляет. Мутирует переданный список — так устроен хук `pages:extend`.

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.1003",
+  "version": "0.0.1005",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {
     "prepublishOnly": "npm install && npx nuxi prepare",
     "patch": "npm version patch",
+    "version": "node scripts/site-updates-release.mjs && git add SITE_UPDATES.md",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix",
     "lint:css": "stylelint \"**/*.{scss,vue}\" --max-warnings=0 --allow-empty-input",
@@ -80,6 +81,8 @@
     "i18n/locales/",
     "scripts/i18n-check.mjs",
     "scripts/i18n-sheet.mjs",
+    "scripts/site-updates.mjs",
+    "SITE_UPDATES.md",
     "nuxt.config.ts",
     "DOCS/"
   ],

package/scripts/site-updates.mjs

@@ -0,0 +1,57 @@
+// Для сайта, после `npm run spec`: печатает записи SITE_UPDATES.md слоя, вышедшие после версии,
+// которая стояла в закоммиченном package.json сайта, и дописывает их в SITE_TODO.md сайта.
+// Запуск из корня сайта.
+// Явно: `node node_modules/itube-specs/scripts/site-updates.mjs <старая-версия>`.
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+
+const FILE = 'node_modules/itube-specs/SITE_UPDATES.md';
+const TODO_FILE = 'SITE_TODO.md';
+const TODO_HEADER = '# Пункты слоя, которые этот сайт ещё не выполнил\n\nИз `itube-specs/SITE_UPDATES.md`. Выполнил всё — удали файл.';
+
+const toParts = version => version.replace(/^[^\d]*/, '').split('.').map(Number);
+const isNewer = (a, b) => {
+  const [x, y] = [toParts(a), toParts(b)];
+  for (let i = 0; i < 3; i++) if ((x[i] || 0) !== (y[i] || 0)) return (x[i] || 0) > (y[i] || 0);
+  return false;
+};
+
+function previousVersion() {
+  if (process.argv[2]) return process.argv[2];
+  try {
+    const pkg = JSON.parse(execSync('git show HEAD:package.json', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+    return pkg.dependencies?.['itube-specs'] || pkg.devDependencies?.['itube-specs'] || '';
+  }
+  catch {
+    return '';
+  }
+}
+
+if (!existsSync(FILE)) process.exit(0);
+
+const from = previousVersion();
+const installed = JSON.parse(readFileSync('node_modules/itube-specs/package.json', 'utf8')).version;
+
+const sections = readFileSync(FILE, 'utf8').split(/^(?=## )/m).filter(part => part.startsWith('## '));
+const pending = sections.filter((section) => {
+  const version = section.match(/^## (\d+\.\d+\.\d+)/)?.[1];
+  return version && (!from || isNewer(version, from)) && !isNewer(version, installed);
+});
+
+if (!pending.length) {
+  console.log(`site-updates: ${from || '?'} → ${installed}, действий для сайта нет.`);
+  process.exit(0);
+}
+
+const items = pending.reverse().map(section => section.trim());
+
+// Файл в корне сайта — пункты не теряются, кто бы ни запускал spec; хук агента подхватывает его
+// в контекст, выполненное агент удаляет вместе с файлом.
+const existing = existsSync(TODO_FILE) ? readFileSync(TODO_FILE, 'utf8') : `${TODO_HEADER}\n`;
+const fresh = items.filter(item => !existing.includes(item.split('\n')[0]));
+if (fresh.length) writeFileSync(TODO_FILE, `${existing.trimEnd()}\n\n${fresh.join('\n\n')}\n`);
+
+console.log(`\nsite-updates: ${from || '?'} → ${installed}. Что сделать в этом сайте (от старых к новым), записано в ${TODO_FILE}:\n`);
+console.log(items.join('\n\n'));
+console.log('');