itube-specs 0.0.1004 → 0.0.1007

package/SITE_UPDATES.md

@@ -10,6 +10,20 @@
 коммиты до бампа); `npm run patch` сам проставит ей номер версии. Формат пункта: что сделать и где,
 кому именно (всем / сайтам с N), что будет, если не сделать.
 
+## 0.0.1007 — 2026-10-06
+
+- **Сайтам, где `npm run dev` подключает локальный слой (`LAYER_PATH` в `.env`):** заменить скрипт `predev` в
+  `package.json` на
+
+  ```json
+  "predev": "env-cmd -f .env sh node_modules/itube-specs/scripts/link-layer.sh",
+  ```
+
+  Скрипт из слоя делает то же, что старый `predev` (симлинк на `LAYER_PATH` + `nuxi prepare`), и перед этим
+  подтягивает локальный слой до `origin/develop` — только fast-forward: свои коммиты, ветка не develop или нет
+  сети — слой не трогается, dev всё равно стартует. Без `LAYER_PATH` — ничего не делает. Не заменить — dev
+  работает с локальным слоем без чужих свежих правок, пока не подтянешь руками.
+
 ## 0.0.1001 — 2026-10-06
 
 - **Всем:** удалить свои `public/img/model-placeholder-{portrait,square}.{webp,avif}` и

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,7 +1,7 @@
 {
   "name": "itube-specs",
   "type": "module",
-  "version": "0.0.1004",
+  "version": "0.0.1007",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {
@@ -82,6 +82,7 @@
     "scripts/i18n-check.mjs",
     "scripts/i18n-sheet.mjs",
     "scripts/site-updates.mjs",
+    "scripts/link-layer.sh",
     "SITE_UPDATES.md",
     "nuxt.config.ts",
     "DOCS/"

package/scripts/link-layer.sh

@@ -0,0 +1,15 @@
+#!/bin/sh
+# predev сайта: подтянуть локальный слой (LAYER_PATH из .env сайта) до origin/develop и подключить его
+# симлинком вместо пакета из npm — правки слоя видны в dev сразу. Только fast-forward: свои коммиты, ветка не
+# develop, нет сети — слой не трогается, dev всё равно стартует. Нет LAYER_PATH (CI, чужая машина) — no-op.
+
+[ -n "$LAYER_PATH" ] && [ -d "$LAYER_PATH" ] || exit 0
+
+branch=$(git -C "$LAYER_PATH" rev-parse --abbrev-ref HEAD 2>/dev/null)
+if [ "$branch" != "develop" ]; then
+  echo "link-layer: слой на ветке «$branch», не develop — не подтягиваю"
+elif ! git -C "$LAYER_PATH" pull --ff-only -q origin develop; then
+  echo "link-layer: слой не подтянут (свои коммиты, мешающие правки или нет сети) — работаю с локальным как есть"
+fi
+
+rm -rf node_modules/itube-specs && ln -sfn "$LAYER_PATH" node_modules/itube-specs && (cd "$LAYER_PATH" && npx nuxi prepare) || true

package/scripts/site-updates.mjs

@@ -1,11 +1,14 @@
 // Для сайта, после `npm run spec`: печатает записи SITE_UPDATES.md слоя, вышедшие после версии,
-// которая стояла в закоммиченном package.json сайта. Запуск из корня сайта.
+// которая стояла в закоммиченном package.json сайта, и дописывает их в SITE_TODO.md сайта.
+// Запуск из корня сайта.
 // Явно: `node node_modules/itube-specs/scripts/site-updates.mjs <старая-версия>`.
 
 import { execSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
+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) => {
@@ -41,6 +44,14 @@ if (!pending.length) {
   process.exit(0);
 }
 
-console.log(`\nsite-updates: ${from || '?'} → ${installed}. Что сделать в этом сайте (от старых к новым):\n`);
-console.log(pending.reverse().map(section => section.trim()).join('\n\n'));
+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('');