itube-specs 0.0.1004 → 0.0.1005

package/SITE_UPDATES.md

@@ -10,6 +10,20 @@
 коммиты до бампа); `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}` и

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.1005",
   "main": "./nuxt.config.ts",
   "types": "./types/index.d.ts",
   "scripts": {

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('');