@nitra/cursor 1.8.197 → 1.8.199

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.199] - 2026-05-07
+
+### Added
+
+- `auto-rules.mjs`: автоматична міграція застарілих rule-id у `.n-cursor.json` через карту `RULE_MIGRATIONS`. Перший зареєстрований запис — `image` → `image-compress` + `image-avif` (split з 1.8.197). Застосовується і до `rules`, і до `disable-rules`, з дедуплікацією. CLI `n-cursor.js` логує `📦 Авто-міграція .n-cursor.json: image → image-compress, image-avif` перед нормалізацією, потім записує оновлений конфіг (як і раніше — лише якщо вміст реально змінився).
+- `tests/auto-rules.test.mjs`: тести `migrateRuleIds` (порядок, дедуплікація, no-op для актуальних id), `detectLegacyRuleIds`, `mergeConfigWithAutoDetected` з legacy `image` у `rules`/`disable-rules`/конфлікті з `image-compress`.
+
+### Changed
+
+- `n-cursor.js`: розширено імпорт з `auto-rules.mjs` (`detectLegacyRuleIds`, `RULE_MIGRATIONS`); виокремлено хелпер `logRuleMigrationsIfAny` (читає сирий конфіг, виводить пояснення, не мутує — мутацію виконує `migrateRuleIds` усередині `mergeConfigWithAutoDetected`). Завдяки цьому `npx @nitra/cursor` сам перебиває `image` на пару наступників — користувачу не треба руками правити `.n-cursor.json`.
+
+## [1.8.198] - 2026-05-07
+
+### Changed
+
+- `image-compress` (mdc v1.0 → v1.1): мінімум `@nitra/minify-image` піднято з **3.2.0** до **3.3.1**. У `3.3.1` upstream CLI порівнює sha1 raster-сорсу зі збереженим у `.n-minify-image.tsv` і автоматично перегенеровує `<source>.avif` при зміні контенту оригіналу — раніше stale `.avif` лишався поки розробник не видаляв його вручну. Додано пояснювальний абзац у правило.
+- `image-avif` (mdc v1.0 → v1.1): крок 1 (`npx @nitra/minify-image --src=. --write --avif`) явно требує ≥ 3.3.1 і документує, що sha1-перевірка для регенерації застарілого AVIF тепер живе у CLI; `@nitra/cursor` цю логіку **не дублює**.
+
 ## [1.8.197] - 2026-05-07
 
 ### Changed

package/bin/n-cursor.js

@@ -56,7 +56,13 @@ import { cwd } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
 import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
-import { detectAutoRulesAndSkills, mergeConfigWithAutoDetected, normalizeIdList } from '../scripts/auto-rules.mjs'
+import {
+  detectAutoRulesAndSkills,
+  detectLegacyRuleIds,
+  mergeConfigWithAutoDetected,
+  normalizeIdList,
+  RULE_MIGRATIONS
+} from '../scripts/auto-rules.mjs'
 import { runStopHookCli } from '../scripts/claude-stop-hook.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { runLintGaCli } from '../scripts/lint-ga.mjs'
@@ -301,6 +307,7 @@ async function readConfig(paths = {}) {
   } catch {
     throw new Error(`Невірний JSON у файлі ${CONFIG_FILE}`)
   }
+  logRuleMigrationsIfAny(config)
   const normalized = await normalizeConfigWithAutoRules(config)
   if (JSON.stringify(normalized) !== JSON.stringify(config)) {
     await writeFile(configPath, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8')
@@ -309,6 +316,31 @@ async function readConfig(paths = {}) {
   return normalized
 }
 
+/**
+ * Якщо у `rules` чи `disable-rules` є застарілі rule-id з `RULE_MIGRATIONS`,
+ * виводить пояснювальний лог про автоматичну заміну (саму заміну виконує
+ * `migrateRuleIds` у `mergeConfigWithAutoDetected` — тут лише користувацька комунікація).
+ * @param {Record<string, unknown>} parsedConfig сирий обʼєкт `.n-cursor.json` після `JSON.parse`
+ * @returns {void}
+ */
+function logRuleMigrationsIfAny(parsedConfig) {
+  /** @type {Set<string>} */
+  const seen = new Set()
+  for (const key of /** @type {const} */ (['rules', 'disable-rules'])) {
+    const list = parsedConfig[key]
+    if (!Array.isArray(list)) continue
+    const legacy = detectLegacyRuleIds(normalizeIdList(list))
+    for (const id of legacy) seen.add(id)
+  }
+  if (seen.size === 0) return
+  console.log(`📦 Авто-міграція ${CONFIG_FILE}:`)
+  for (const id of seen) {
+    const replacement = RULE_MIGRATIONS[id].join(', ')
+    console.log(`   • ${id} → ${replacement}`)
+  }
+  console.log('')
+}
+
 /**
  * Витягує чисте ім'я файлу правила (без шляху, але зберігає .mdc)
  * "npm/mdc/text.mdc" → "text.mdc"

package/mdc/image-avif.mdc

@@ -1,12 +1,12 @@
 ---
 description: AVIF-двійники для raster-зображень з ув'язуванням у .vue/.html
 alwaysApply: true
-version: '1.0'
+version: '1.1'
 ---
 
 AVIF-двійники (`<name>.<ext>.avif`) генерує **виключно** `npx @nitra/cursor check image-avif` — у `lint-image` прапорець `--avif` заборонений (це валідує правило `image-compress`). Перевірка робить три кроки в порядку:
 
-1. Запускає `npx @nitra/minify-image --src=. --write --avif` — генерує `<name>.<ext>.avif` поряд з кожним PNG/JPEG/GIF.
+1. Запускає `npx @nitra/minify-image --src=. --write --avif` (≥ **3.3.1**) — генерує `<name>.<ext>.avif` поряд з кожним PNG/JPEG/GIF. **Перегенерація при оновленні оригіналу:** з 3.3.1 CLI порівнює sha1 кожного raster-сорсу зі збереженим у `.n-minify-image.tsv` і автоматично перезаписує `<source>.avif`, якщо оригінал відредагували після останнього прогону. `@nitra/cursor` цю логіку не дублює — sha1-кеш живе всередині `@nitra/minify-image`.
 2. Сканує `.vue` (а також `.html`) файли в кожному workspace-пакеті (root + workspaces) і автоматично переписує raster-посилання на AVIF-двійник у двох формах:
    - **Імпорт-пов'язані** — `import x from '...png|jpg|jpeg|gif'` (далі `:src="x"` у шаблоні);
    - **Прямі статичні** — `<img src="...png" />` у `<template>` (Vite перетворює такий шлях на asset-імпорт на етапі збірки, тож вимога та сама).

package/mdc/image-compress.mdc

@@ -1,10 +1,12 @@
 ---
 description: Оптимізація raster/SVG через @nitra/minify-image у локальному lint
 alwaysApply: true
-version: '1.0'
+version: '1.1'
 ---
 
-CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image) (≥ **3.2.0**) запускається через `npx` (як `markdownlint-cli2` у text.mdc) і **не** додається в `dependencies` / `devDependencies`. Канонічний `lint-image` — авто-оптимізація з прапорцем `--write`: стискає raster/SVG на місці. **AVIF-генерація (`--avif`) у `lint-image` заборонена** — її виконує окреме правило `image-avif` (`npx @nitra/cursor check image-avif`), яке заодно прибирає AVIF-сироти. Split-cache робить повторні прогони дешевими — і локально, і після `git clone`.
+CLI [`@nitra/minify-image`](https://www.npmjs.com/package/@nitra/minify-image) (≥ **3.3.1**) запускається через `npx` (як `markdownlint-cli2` у text.mdc) і **не** додається в `dependencies` / `devDependencies`. Канонічний `lint-image` — авто-оптимізація з прапорцем `--write`: стискає raster/SVG на місці. **AVIF-генерація (`--avif`) у `lint-image` заборонена** — її виконує окреме правило `image-avif` (`npx @nitra/cursor check image-avif`), яке заодно прибирає AVIF-сироти. Split-cache робить повторні прогони дешевими — і локально, і після `git clone`.
+
+Мінімум `3.3.1` важливий для правила `image-avif`: починаючи з цієї версії, CLI порівнює sha1 raster-сорсу зі збереженим у `.n-minify-image.tsv` і **перегенеровує `<source>.avif`** при будь-якій зміні контенту оригіналу (раніше stale `.avif` лишався, поки розробник не видаляв його вручну).
 
 Перевірка лише локальна — у CI `lint-image` не запускаємо (sharp/svgo тягнуть бінарні залежності, цінність на ubuntu-runner-ах нижча за час прогону). Окремий workflow `lint-image.yml` створювати не треба.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.197",
+  "version": "1.8.199",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/auto-rules.mjs

@@ -49,6 +49,45 @@ export const AUTO_RULE_ORDER = Object.freeze([
 /** Порядок автододавання skills відповідно до `auto-rules.md`. */
 export const AUTO_SKILL_ORDER = Object.freeze(['abie-kustomize', 'fix', 'lint'])
 
+/**
+ * Карта міграції застарілих rule-id у `.n-cursor.json` на актуальні.
+ * Застосовується автоматично при читанні конфігу (як для `rules`, так і для `disable-rules`).
+ * Приклад: `image` → `image-compress` + `image-avif` (правило розщеплене у 1.8.197).
+ */
+export const RULE_MIGRATIONS = Object.freeze(
+  /** @type {Record<string, readonly string[]>} */ ({
+    image: Object.freeze(['image-compress', 'image-avif'])
+  })
+)
+
+/**
+ * Розгортає застарілі rule-id у списку згідно з `RULE_MIGRATIONS`. Зберігає порядок,
+ * дедуплікує. Чистий хелпер: не мутує вхід, не логує.
+ * @param {string[]} ids нормалізований список id (як з `normalizeIdList`)
+ * @returns {string[]} список з legacy-id, заміненими на нові; решта без змін
+ */
+export function migrateRuleIds(ids) {
+  /** @type {string[]} */
+  const out = []
+  for (const id of ids) {
+    const replacement = Object.hasOwn(RULE_MIGRATIONS, id) ? RULE_MIGRATIONS[id] : [id]
+    for (const newId of replacement) {
+      if (!out.includes(newId)) out.push(newId)
+    }
+  }
+  return out
+}
+
+/**
+ * Повертає лише ті legacy rule-id зі списку, для яких є запис у `RULE_MIGRATIONS`.
+ * Використовується для людинозрозумілого логування міграції при синхронізації CLI.
+ * @param {string[]} ids нормалізований список id
+ * @returns {string[]} legacy id, які потребуватимуть заміни у `migrateRuleIds`
+ */
+export function detectLegacyRuleIds(ids) {
+  return ids.filter(id => Object.hasOwn(RULE_MIGRATIONS, id))
+}
+
 /**
  * Граф залежностей між правилами (`auto-rules.md` синтаксис `rule - [other]`).
  * Ключ варто автододати, коли всі правила-залежності вже додані до конфігу — щоб
@@ -649,9 +688,9 @@ export async function detectAutoRulesAndSkills({
  * @returns {{ rules: string[], skills: string[] } & Record<string, unknown>} новий нормалізований конфіг
  */
 export function mergeConfigWithAutoDetected({ config, detectedRules, detectedSkills }) {
-  const existingRules = normalizeIdList(config.rules)
+  const existingRules = migrateRuleIds(normalizeIdList(config.rules))
   const existingSkills = normalizeIdList(config.skills)
-  const disableRules = normalizeIdList(config['disable-rules'])
+  const disableRules = migrateRuleIds(normalizeIdList(config['disable-rules']))
   const disableSkills = normalizeIdList(config['disable-skills'])
 
   const rules = [...existingRules]