@nitra/cursor 1.8.193 → 1.8.198

package/CHANGELOG.md

@@ -4,6 +4,41 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [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
+
+- `image` правило розщеплене на два самостійні: **`image-compress`** (валідація `lint-image` / `.gitignore` / залежностей — стиснення raster/SVG через `@nitra/minify-image`) і **`image-avif`** (генерація AVIF-двійників, переписування raster-посилань у `.vue`/`.html` на `.avif`, прибирання AVIF-сиріт). Це дозволяє тримати компресію всюди, а AVIF — лише там, де його підтримка гарантована (адмінки), вимикаючи його для публічних сайтів через `disable-rules: ["image-avif"]` у `.n-cursor.json` чи опт-аут на рівні пакета (`"@nitra/minify-image": { "disable-avif": true }` у `package.json` сайту).
+- `auto-rules.md` / `auto-rules.mjs`: автодетект `image-compress - [bun]` (всюди, де є `package.json`), `image-avif - [vue, image-compress]` (лише для проєктів з `.vue`-файлами і вже активним `image-compress`).
+- Видалено `npm/scripts/check-image.mjs` і `npm/mdc/image.mdc` — їх замінили `check-image-compress.mjs` + `check-image-avif.mjs` і `image-compress.mdc` + `image-avif.mdc`.
+- Канонічний `lint-image` залишається без `--avif` (його перевіряє `image-compress`); `npx @nitra/cursor check image-avif` тепер є самостійною командою для AVIF-pipeline.
+
+### Added
+
+- `tests/auto-rules.test.mjs`: тест на `disable-rules: ["image-compress"]` → `image-avif` теж не додається (транзитивна залежність).
+
+## [1.8.194] - 2026-05-07
+
+### Fixed
+
+- `check-image.mjs`: резолвер `resolveImagePath` був інлайн-наївний (`/path` → `<cwd>/<path>`, голий шлях → `null`), що в реальних Quasar/Vite-проєктах давало 0 rewrite-ів і помилковий ріст `failedRefs`. Замінено на `resolveImageCandidates`, який повертає **впорядкований список кандидатів**:
+  - `./x.png` / `../x.png` → відносно файла-джерела;
+  - `/x.png` → `<packageRoot>/public/x.png`, потім `<packageRoot>/x.png`, потім `<cwd>/x.png` (legacy fallback);
+  - голий шлях з принаймні одним `/` (`assets/img.png`, `start-page-ua/logo.png`) → відносно файла-джерела + `<packageRoot>/public/<path>` (Quasar-конвенція);
+  - bare без `/` → alias resolver невідомий, посилання тихо пропускаємо (без fail).
+- `check-image.mjs`: `cleanupOrphanAvifs` тепер пропускає `.avif` у каталогах артефактів збірки (`build`, `android`, `ios`, `.output`, `.nuxt`, `.cache`) — раніше cleanup міг затирати продукт `bun run build` чи Capacitor sync.
+
+### Added
+
+- `tests/check-image.test.mjs`: 4 нових кейси — Quasar-style `src="/api-page/1.png"` через `<pkg>/public/`; `<img src="assets/images/x.png">` у `.html` через relative-to-source; `src="start-page-ua/logo.png"` у `.vue` через `<pkg>/public/`; cleanup не чіпає AVIF у `build/`/`android/`/`ios/`/`.output/`/`.nuxt/`/`.cache/`.
+
 ## [1.8.193] - 2026-05-07
 
 ### Fixed

package/bin/auto-rules.md

@@ -22,7 +22,9 @@ graphql - якщо хоч в одному js або vue файлі присут
 
 hasura - якщо в директорії присутній config.yaml, який містить рядок `metadata_directory: metadata`
 
-image - [vue]
+image-compress - [bun]
+
+image-avif - [vue, image-compress]
 
 js-lint - якщо присутній хоч один js файл
 

package/mdc/image-avif.mdc

@@ -0,0 +1,55 @@
+---
+description: AVIF-двійники для raster-зображень з ув'язуванням у .vue/.html
+alwaysApply: true
+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` (≥ **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-імпорт на етапі збірки, тож вимога та сама).
+3. Видаляє AVIF-сироти: ходить по всіх `<...>.avif` у репозиторії; якщо на двійник не лишилось жодного посилання у `.vue`/`.html` — файл видаляється. **AVIF на диску лишається лише там, де заміна реально відбулась** — тому невикористані оригінали не накопичують `.avif`-«хвости».
+
+```vue title="App.vue (після check image-avif)"
+<script setup>
+import welcomeImage from './assets/welcome.png.avif'
+</script>
+
+<template>
+  <img :src="welcomeImage" alt="Welcome" />
+</template>
+```
+
+Реактивне `:src="..."` (з JS-виразом — змінною, тернарником, викликом тощо) **не сканується** — значення обчислюється у рантаймі й шлях туди потрапляє через імпорт або інший резолвинг, який ловить імпорт-перевірка вище. SVG не торкаємо (vector → AVIF безглуздо). Атрибути `data-src=`, `obj.src=` у `<script>` тощо також пропускаються.
+
+Якщо raster-посилання у `.vue`/`.html` не вдалось переписати (наприклад, оригіналу немає на диску, тож і `.avif` не згенерувався) — `check image-avif` падає з помилкою на конкретний файл.
+
+AVIF-двійники **зберігаємо в git** — це готові артефакти для віддачі браузеру (без них ефект від AVIF втрачається на чистому checkout-і).
+
+## Коли НЕ вмикати правило
+
+AVIF ще не підтримується **усіма** браузерами: для публічного сайту, де серед користувачів можуть бути старі/нестандартні браузери, конвертація raster → AVIF як основного джерела ризикована. Для адмінок (де користувачі — співробітники з сучасними браузерами) AVIF безпечний.
+
+У монорепо з адмінкою + публічним сайтом стандартна стратегія така: правило `image-avif` присутнє у `.n-cursor.json`, але для пакета-сайту вмикається опт-аут (нижче).
+
+## Опт-аут для конкретного пакета
+
+У workspace-пакеті, де AVIF-імпорти небажані (наприклад, мобільний бандл або публічний сайт без гарантованої AVIF-підтримки), додай у `package.json` цього пакета:
+
+```json title="apps/site/package.json"
+{
+  "@nitra/minify-image": {
+    "disable-avif": true
+  }
+}
+```
+
+Тоді перевірка пропускає `.vue` файли цього пакета і не видаляє наявні `.avif` всередині як «сироти». У root-`package.json` опт-аут діє лише для файлів кореня (вкладені workspaces перевіряються незалежно — вмикай прапор у кожному пакеті, де треба).
+
+`image-compress` (раніший крок: lint-image, кеш, заборонені залежності) при цьому продовжує працювати — стиснення raster-зображень виконується незалежно від AVIF.
+
+## Перевірка
+
+`npx @nitra/cursor check image-avif` (запуск AVIF-генерації + авто-заміна raster-посилань на `.avif` у `.vue`/`.html` кожного workspace-пакета + прибирання AVIF-сиріт; пакети з `"@nitra/minify-image": { "disable-avif": true }` пропускаються).

package/mdc/image-compress.mdc

@@ -0,0 +1,58 @@
+---
+description: Оптимізація raster/SVG через @nitra/minify-image у локальному lint
+alwaysApply: true
+version: '1.1'
+---
+
+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.json`
+
+```json title="package.json"
+{
+  "scripts": {
+    "lint": "bun run lint-js && bun run lint-text && bun run lint-ga && bun run lint-image && oxfmt .",
+    "lint-image": "npx @nitra/minify-image --src=. --write"
+  }
+}
+```
+
+Якщо в `package.json` уже є агрегований `lint`, додай у його ланцюжок `bun run lint-image` (як `bun run lint-text`, `bun run lint-js`, `bun run lint-ga`). Так розробник, що локально гонить `bun run lint`, перед фіксацією одразу бачить, чи зросли зображення.
+
+## Split-cache
+
+Починаючи з `@nitra/minify-image` **3.2.0** кеш розбитий на два файли з різною семантикою:
+
+### `.n-minify-image.tsv` — source of truth у git
+
+У корені сканованого каталогу. Формат: `<rel-path>\t<sha1-hex>\t<originalSize>\t<size>`.
+
+Slow-path і джерело даних для `Project lifetime savings`. **Має бути в git** — після `git clone` чи `git checkout` (mtime скидається на час checkout-у) CLI читає файл, рахує SHA-1 і порівнює зі збереженим у TSV хешем; на match локальний mtime-кеш зігрівається без reprocess. Рядки відсортовані алфавітно, hash і size змінюються лише при реальній зміні контенту — diff чистий.
+
+### `node_modules/.cache/@nitra/minify-image/mtime.tsv` — локальний fast-path
+
+Формат: `<rel-path>\t<mtime>\t<size>`. При збігу `(size, mtime)` CLI пропускає файл без читання — константа per-file.
+
+Лежить під `node_modules/`, тож **авто-gitignored** за конвенцією JS-tooling-у (так кешуються ESLint, Babel, webpack, Turbo). Окремий рядок у `.gitignore` не потрібен. `rm -rf node_modules` зносить — наступний запуск відновлює його через slow-path проти `.n-minify-image.tsv`, без reprocess.
+
+### Міграція з versions < 3.2
+
+Старий єдиний `.minify-image-cache.tsv` (4 колонки `path\tmtime\toriginalSize\tsize`, зазвичай у `.gitignore`) автоматично читається при першому запуску для seed-у `originalSize` у `.n-minify-image.tsv` (lifetime savings не скидається). Після цього старий файл видаляють вручну:
+
+```bash
+git rm --cached .minify-image-cache.tsv 2>/dev/null || true
+rm -f .minify-image-cache.tsv
+# прибери відповідний рядок з .gitignore, якщо був
+```
+
+## Заборонені залежності
+
+`@nitra/minify-image` не повинен зʼявлятися ні в `dependencies`, ні в `devDependencies` кореневого `package.json` — CLI запускається лише через `npx` (так само, як `markdownlint-cli2` у text.mdc). Якщо потрібен явний пін — закладай діапазон версій npm у самому виклику (`npx @nitra/minify-image@^3 --src=. --write`).
+
+## Перевірка
+
+`npx @nitra/cursor check image-compress` (охоплює `lint-image` з обовʼязковими `--src=.`, `--write` і **забороненим** `--avif`; агрегований `lint`; заборону `@nitra/minify-image` у залежностях; `.n-minify-image.tsv` НЕ в `.gitignore` — має бути в git; відсутність застарілого `.minify-image-cache.tsv` у корені).

package/package.json

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

package/scripts/auto-rules.mjs

@@ -31,7 +31,8 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'ga',
   'graphql',
   'hasura',
-  'image',
+  'image-avif',
+  'image-compress',
   'js-lint',
   'js-mssql',
   'js-bun-db',
@@ -56,7 +57,8 @@ export const AUTO_SKILL_ORDER = Object.freeze(['abie-kustomize', 'fix', 'lint'])
 export const AUTO_RULE_DEPENDENCIES = Object.freeze(
   /** @type {Record<string, readonly string[]>} */ ({
     changelog: Object.freeze(['bun']),
-    image: Object.freeze(['vue'])
+    'image-avif': Object.freeze(['vue', 'image-compress']),
+    'image-compress': Object.freeze(['bun'])
   })
 )
 

package/scripts/{check-image.mjs → check-image-avif.mjs}

@@ -1,24 +1,8 @@
 /**
- * Перевіряє відповідність репозиторію правилу image.mdc для оптимізації зображень
- * через `@nitra/minify-image` ≥ 3.2.0 (локально — у CI лінт зображень не запускається).
+ * Перевіряє відповідність репозиторію правилу `image-avif.mdc`: AVIF-генерацію та
+ * ув'язування `.avif`-двійників з посиланнями у `.vue`/`.html`.
  *
- * Очікування:
- * - у кореневому `package.json` є скрипт `lint-image`, який викликає `npx @nitra/minify-image`
- *   з обовʼязковими `--src=.` і `--write`. Прапорець `--avif` у `lint-image` заборонений —
- *   AVIF-генерацію виконує `check image` (інакше `bun run lint` плодив би `.avif` для
- *   зображень, що ніде не вживаються);
- * - якщо в `package.json` є агрегований скрипт `lint`, він викликає `bun run lint-image`
- *   (симетрично до `lint-text`, `lint-js`, `lint-ga`);
- * - `@nitra/minify-image` не оголошений у `dependencies`/`devDependencies` —
- *   CLI запускається лише через `npx` (як `markdownlint-cli2` у `text.mdc`);
- * - `.n-minify-image.tsv` (committed source of truth з sha1/originalSize/size) НЕ
- *   в `.gitignore` — він має бути в git. Локальний mtime-кеш у
- *   `node_modules/.cache/@nitra/minify-image/mtime.tsv` авто-gitignored через `node_modules/`,
- *   окремої перевірки не вимагає;
- * - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня — інакше
- *   проєкт лишається у напівпереміщеному стані.
- *
- * Дії під час `check image` (на додачу до валідацій):
+ * Дії під час `check image-avif`:
  * 1. `npx @nitra/minify-image --src=. --write --avif` — генерує AVIF-двійники.
  * 2. У кожному workspace-пакеті переписує raster-посилання у `.vue`/`.html` на `.avif`
  *    (де AVIF-двійник реально існує на диску). Pakety з `"@nitra/minify-image": {
@@ -28,7 +12,12 @@
  *    там, де заміна вдалася»).
  *
  * Якщо raster-посилання у `.vue`/`.html` не вдалось переписати (наприклад, оригіналу
- * нема на диску → `.avif` теж не згенерувався) — фейл на конкретний файл, як раніше.
+ * нема на диску → `.avif` теж не згенерувався) — фейл на конкретний файл.
+ *
+ * Правило самостійне від `image-compress`: AVIF можна вмикати лише в адмінках (де AVIF
+ * підтримується сучасними браузерами) і не вмикати в публічних сайтах. Перевірка скрипта
+ * `lint-image` (заборона `--avif` у ньому) залишається у `image-compress` — тут вона не
+ * дублюється.
  */
 import { existsSync } from 'node:fs'
 import { readFile, unlink, writeFile } from 'node:fs/promises'
@@ -41,18 +30,20 @@ import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
-/** Імʼя CLI-пакета: рядок у `lint-image` і заборонений у залежностях. */
+/** Імʼя CLI-пакета, який генерує AVIF. */
 const MINIFY_PACKAGE_NAME = '@nitra/minify-image'
 
-/** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
-const HASH_CACHE_FILENAME = '.n-minify-image.tsv'
-
-/** Імʼя застарілого 4-колонкового кешу (`@nitra/minify-image` < 3.2). Має бути видалений після міграції. */
-const LEGACY_CACHE_FILENAME = '.minify-image-cache.tsv'
-
 /** Поле в `package.json` для конфігу @nitra/minify-image (наприклад, `disable-avif`). */
 const PKG_CONFIG_FIELD = '@nitra/minify-image'
 
+/**
+ * Імена каталогів, які `cleanupOrphanAvifs` не зачіпає, бо це артефакти збірки/нативні
+ * платформи — `.avif` всередині — це продукт попереднього `bun run build`/Capacitor sync,
+ * а не кандидати на видалення. `walkDir` уже скіпає `node_modules`, `.git`, `dist`,
+ * `coverage`, `.turbo`, `.next` — додатково для cleanup ігноруємо ще ці.
+ */
+const CLEANUP_EXTRA_IGNORE_DIR_NAMES = new Set(['build', 'android', 'ios', '.output', '.nuxt', '.cache'])
+
 /**
  * Регексп для імпортів raster-зображень у `.vue` файлах.
  * Захоплює `import name from '...ext'` (як default, так і type-only форми не потрібні —
@@ -78,147 +69,6 @@ const VUE_RASTER_STATIC_SRC_RE = /(?<![:\-_.])\bsrc\s*=\s*['"]([^'"\s]+\.(?:png|
  */
 const VUE_AVIF_REF_RE = /['"]([^'"\s]+\.(?:png|jpe?g|gif)\.avif)['"]/giu
 
-/**
- * Перевіряє скрипт `lint-image` у `package.json`.
- *
- * Має містити виклик `npx @nitra/minify-image` з обовʼязковими прапорцями `--src=.`
- * і `--write` (авто-оптимізація на місці). Прапорець `--avif` у `lint-image`
- * заборонений — AVIF-генерацію виконує `check image`, інакше `bun run lint` плодить
- * `.avif` для зображень, що ніде не вживаються.
- * @param {string|undefined} lintImage значення `scripts['lint-image']`
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkLintImageScript(lintImage, pass, fail) {
-  const canonical = `npx ${MINIFY_PACKAGE_NAME} --src=. --write`
-  if (typeof lintImage !== 'string' || !lintImage.trim()) {
-    fail(`package.json: додай скрипт "lint-image" з \`${canonical}\` (image.mdc)`)
-    return
-  }
-  if (!lintImage.includes(`npx ${MINIFY_PACKAGE_NAME}`)) {
-    fail(`package.json: lint-image має викликати \`npx ${MINIFY_PACKAGE_NAME}\` (image.mdc)`)
-    return
-  }
-  /** @type {{ flag: string, variants: string[], hint: string }[]} */
-  const requiredFlags = [
-    { flag: '--src=.', variants: ['--src=.', '--src .'], hint: '`--src=.`' },
-    { flag: '--write', variants: ['--write'], hint: '`--write` (авто-оптимізація на місці)' }
-  ]
-  const missing = requiredFlags.filter(f => !f.variants.some(v => lintImage.includes(v)))
-  if (missing.length > 0) {
-    fail(
-      `package.json: lint-image має містити ${missing.map(f => f.hint).join(', ')} — канонічний виклик: \`${canonical}\` (image.mdc)`
-    )
-    return
-  }
-  if (lintImage.includes('--avif')) {
-    fail(
-      `package.json: прибери \`--avif\` з lint-image — AVIF-генерацію виконує \`npx @nitra/cursor check image\` (image.mdc). Канонічний виклик: \`${canonical}\``
-    )
-    return
-  }
-  pass(`package.json: lint-image викликає \`${canonical}\``)
-}
-
-/**
- * Перевіряє, що агрегований `lint` (якщо є) кличе `bun run lint-image` —
- * симетрично до `lint-text`, `lint-js`, `lint-ga`.
- * @param {string|undefined} lintAggregate значення `scripts.lint`
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkLintAggregateIncludesImage(lintAggregate, pass, fail) {
-  if (typeof lintAggregate !== 'string' || !lintAggregate.trim()) {
-    return
-  }
-  if (lintAggregate.includes('bun run lint-image')) {
-    pass('package.json: агрегований `lint` викликає `bun run lint-image`')
-  } else {
-    fail('package.json: у `lint` додай `bun run lint-image` (image.mdc, симетрично до lint-text / lint-js / lint-ga)')
-  }
-}
-
-/**
- * Забороняє `@nitra/minify-image` у `dependencies` чи `devDependencies` —
- * CLI завжди запускається через `npx` (як `markdownlint-cli2` у `text.mdc`).
- * @param {{ dependencies?: Record<string, unknown>, devDependencies?: Record<string, unknown> }} pkg розібраний package.json
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {void}
- */
-function checkMinifyImageNotInDeps(pkg, pass, fail) {
-  const inDeps = Boolean(pkg.dependencies && MINIFY_PACKAGE_NAME in pkg.dependencies)
-  const inDevDeps = Boolean(pkg.devDependencies && MINIFY_PACKAGE_NAME in pkg.devDependencies)
-  if (inDeps || inDevDeps) {
-    fail(
-      `package.json: ${MINIFY_PACKAGE_NAME} не додавай у dependencies/devDependencies — лише через \`npx\` (image.mdc)`
-    )
-  } else {
-    pass(`package.json: ${MINIFY_PACKAGE_NAME} не оголошено в dependencies/devDependencies`)
-  }
-}
-
-/**
- * Зчитує всі змістовні рядки `.gitignore` (без коментарів і порожніх). Якщо файла нема — `null`.
- * @returns {Promise<string[] | null>} список trim-нутих рядків або `null`
- */
-async function readGitignoreLines() {
-  if (!existsSync('.gitignore')) return null
-  const raw = await readFile('.gitignore', 'utf8')
-  return raw
-    .split('\n')
-    .map(l => l.trim())
-    .filter(l => l.length > 0 && !l.startsWith('#'))
-}
-
-/**
- * Перевіряє, що `.n-minify-image.tsv` НЕ в `.gitignore` — він має бути в git
- * (split-cache 3.2.0: source of truth для slow-path і lifetime savings).
- *
- * Сам факт існування файла НЕ вимагається — на свіжому проєкті без обробки
- * зображень його ще нема, це нормально.
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<void>}
- */
-async function checkHashCacheNotIgnored(pass, fail) {
-  const lines = await readGitignoreLines()
-  if (lines && lines.includes(HASH_CACHE_FILENAME)) {
-    fail(
-      `.gitignore: прибери рядок \`${HASH_CACHE_FILENAME}\` — це закомічений source of truth split-cache 3.2.0 (image.mdc)`
-    )
-  } else {
-    pass(`${HASH_CACHE_FILENAME} не в .gitignore (має бути в git)`)
-  }
-}
-
-/**
- * Перевіряє, що застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений
- * з кореня. Якщо лежить — користувач не завершив міграцію на split-cache, що
- * залишає файл як орфана у git-історії.
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<void>}
- */
-async function checkLegacyCacheRemoved(pass, fail) {
-  if (existsSync(LEGACY_CACHE_FILENAME)) {
-    fail(
-      `${LEGACY_CACHE_FILENAME} застарілий (split-cache 3.2.0) — видали: ` +
-        `\`git rm --cached ${LEGACY_CACHE_FILENAME} 2>/dev/null || true && rm -f ${LEGACY_CACHE_FILENAME}\` ` +
-        '(також прибери відповідний рядок з .gitignore, якщо є)'
-    )
-    return
-  }
-  const lines = await readGitignoreLines()
-  if (lines && lines.includes(LEGACY_CACHE_FILENAME)) {
-    fail(`.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`)
-    return
-  }
-  pass(`${LEGACY_CACHE_FILENAME} відсутній (міграція на split-cache завершена)`)
-}
-
 /**
  * Чи у `package.json` пакета вимкнено avif-перевірку Vue-імпортів.
  * Очікувана форма: `"@nitra/minify-image": { "disable-avif": true }`.
@@ -233,32 +83,62 @@ function packageHasAvifDisabled(pkg) {
 }
 
 /**
- * Резолвить шлях зображення з імпорта/атрибуту відносно файла, що його містить, до абсолютного
- * шляху файла на диску. Шляхи, що не починаються з `.` чи `/`, не резолвимо (alias-resolver
- * Vite/тощо невідомий тут — залишаємо такі посилання як є).
- * @param {string} importPath шлях у `import x from '...'` або `src="..."`
- * @param {string} sourceAbsPath абсолютний шлях файла з посиланням
- * @returns {string|null} абсолютний шлях зображення або `null`, якщо резолвити не можемо
+ * Будує впорядкований список кандидатів-абсолютних шляхів, по яких треба перевіряти
+ * наявність зображення для даного посилання у `.vue`/`.html`. Caller перевіряє кожен
+ * кандидат на існування `<candidate>.avif` (для rewrite) або `<candidate>` (для збору
+ * вже-вживаного `.avif`) і обирає перший, що існує.
+ *
+ * Підтримувані форми:
+ * - `./x.png`, `../x.png` — відносно файла-джерела (ES-import / asset-relative).
+ * - `/x.png` — у Vite/Quasar-конвенції це `<packageRoot>/public/x.png`. Спочатку пробуємо
+ *   `public/`, потім сам корінь пакета (на випадок mono-репо без `public/`), нарешті
+ *   `<cwd>/x.png` як legacy fallback (щоб не зламати проєкти з кореневими ассетами).
+ * - голий шлях з принаймні одним `/` (`assets/img.png`, `start-page-ua/logo.png`) — у
+ *   HTML/Vue браузер резолвить його відносно документа, тому повертаємо relative-to-source
+ *   та `<packageRoot>/public/<path>` як другий кандидат (Quasar-проєкти кладуть public-assets
+ *   саме туди).
+ * - bare без `/` (`foo`) — ймовірно alias resolver (Vite/Webpack), резолвити не вміємо,
+ *   повертаємо порожній список → caller просто пропускає посилання, не звітує fail.
+ * @param {string} importPath шлях з `import x from '...'` або `src="..."`
+ * @param {string} sourceAbsPath абсолютний шлях файла-джерела
+ * @param {string|null} packageRootAbs абсолютний корінь workspace-пакета, у якому лежить
+ * `sourceAbsPath` (для резолвера `/path` як `<root>/public<path>`); `null`, якщо невідомо
+ * @returns {string[]} впорядкований список абсолютних шляхів-кандидатів
  */
-function resolveImagePath(importPath, sourceAbsPath) {
+function resolveImageCandidates(importPath, sourceAbsPath, packageRootAbs) {
   if (importPath.startsWith('.')) {
-    return join(sourceAbsPath, '..', importPath)
+    return [join(sourceAbsPath, '..', importPath)]
   }
   if (importPath.startsWith('/')) {
-    return join(process.cwd(), importPath)
+    /** @type {string[]} */
+    const candidates = []
+    if (packageRootAbs) {
+      candidates.push(join(packageRootAbs, 'public', importPath))
+      candidates.push(join(packageRootAbs, importPath))
+    }
+    candidates.push(join(process.cwd(), importPath))
+    return candidates
+  }
+  if (importPath.includes('/')) {
+    /** @type {string[]} */
+    const candidates = [join(sourceAbsPath, '..', importPath)]
+    if (packageRootAbs) {
+      candidates.push(join(packageRootAbs, 'public', importPath))
+    }
+    return candidates
   }
-  return null
+  return []
 }
 
 /**
- * Аґреговані лічильники по проходу `check image`:
+ * Аґреговані лічильники по проходу `check image-avif`:
  *   - `rewrittenRefs` — скільки конкретних посилань (по одному на match) переписано на `.avif`;
  *   - `rewrittenFiles` — у скількох `.vue`/`.html` файлах хоч одне посилання змінилося;
  *   - `failedRefs` — скільки конкретних посилань не вдалося переписати (`.avif` не існував).
  * @typedef {object} RewriteStats
- * @property {number} rewrittenRefs
- * @property {number} rewrittenFiles
- * @property {number} failedRefs
+ * @property {number} rewrittenRefs скільки конкретних посилань переписано на `.avif`
+ * @property {number} rewrittenFiles у скількох `.vue`/`.html` файлах хоч одне посилання змінилося
+ * @property {number} failedRefs скільки конкретних посилань не вдалося переписати (`.avif` не існував)
  */
 
 /**
@@ -309,12 +189,18 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
      */
     const processMatches = (regex, renderFailure) => {
       updated = updated.replaceAll(regex, (full, importPath) => {
+        const candidates = resolveImageCandidates(importPath, absPath, absRoot)
+        if (candidates.length === 0) {
+          // Bare alias (наприклад, '@/assets/x.png' без `/` — впізнаваний alias у Vite/WP);
+          // резолвера тут нема, тому посилання не чіпаємо і не звітуємо як fail.
+          return full
+        }
         const newImportPath = `${importPath}.avif`
         const replaced = full.replace(importPath, newImportPath)
-        const imageAbs = resolveImagePath(importPath, absPath)
-        if (imageAbs && existsSync(`${imageAbs}.avif`)) {
+        const found = candidates.find(c => existsSync(`${c}.avif`))
+        if (found) {
           stats.rewrittenRefs++
-          usedAvifAbs.add(`${imageAbs}.avif`)
+          usedAvifAbs.add(`${found}.avif`)
           return replaced
         }
         stats.failedRefs++
@@ -327,7 +213,7 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
       VUE_RASTER_IMPORT_RE,
       importPath =>
         `[${label}] ${rel}: import з '${importPath}' має посилатись на AVIF-двійник '${importPath}.avif' ` +
-        `(\`npx @nitra/cursor check image\` створює його поряд, якщо оригінал є на диску). Вимкнути локально: "@nitra/minify-image": { "disable-avif": true } у package.json пакета`
+        `(\`npx @nitra/cursor check image-avif\` створює його поряд, якщо оригінал є на диску). Вимкнути локально: "@nitra/minify-image": { "disable-avif": true } у package.json пакета`
     )
     processMatches(
       VUE_RASTER_STATIC_SRC_RE,
@@ -338,8 +224,10 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
 
     for (const match of updated.matchAll(VUE_AVIF_REF_RE)) {
       const avifPath = match[1]
-      const avifAbs = resolveImagePath(avifPath, absPath)
-      if (avifAbs) usedAvifAbs.add(avifAbs)
+      const candidates = resolveImageCandidates(avifPath, absPath, absRoot)
+      for (const cand of candidates) {
+        if (existsSync(cand)) usedAvifAbs.add(cand)
+      }
     }
 
     if (updated !== original) {
@@ -352,7 +240,7 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePa
 /**
  * Сканує всі workspace-пакети: для кожного перевіряє opt-out і за потреби викликає
  * перевірку Vue-imports. Перевірка пропускається, якщо в репозиторії немає workspaces
- * або немає `.vue`-файлів — тоді `image` правило не для цього проєкту.
+ * або немає `.vue`-файлів — тоді `image-avif` правило не для цього проєкту.
  *
  * Повертає список абсолютних коренів пакетів, у яких ввімкнено opt-out (`disable-avif: true`).
  * Це окремий результат, бо AVIF всередині такого пакета НЕ можна вважати «сиротою» лише
@@ -445,7 +333,7 @@ function runAvifGeneration() {
  *
  * AVIF файли всередині opt-out пакетів (`disable-avif: true`) пропускаються — ми не
  * сканували їх шаблони, тож не маємо права вважати їх AVIF сиротами. Це гарантує
- * ідемпотентність повторного `check image` для пакетів, що навмисно вимкнули правило
+ * ідемпотентність повторного `check image-avif` для пакетів, що навмисно вимкнули правило
  * (наприклад, мобільний бандл, де AVIF підтримка не гарантована).
  * @param {Set<string>} usedAvifAbs абсолютні шляхи `.avif`, що мають живі посилання
  * @param {string[]} optedOutAbs абсолютні шляхи коренів пакетів з опт-аутом —
@@ -462,6 +350,8 @@ async function cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths) {
       if (!absPath.endsWith('.avif')) return
       if (usedAvifAbs.has(absPath)) return
       if (optedOutAbs.some(root => absPath === root || absPath.startsWith(`${root}/`))) return
+      const segments = absPath.split('/')
+      if (segments.some(seg => CLEANUP_EXTRA_IGNORE_DIR_NAMES.has(seg))) return
       orphans.push(absPath)
     },
     ignorePaths
@@ -473,42 +363,14 @@ async function cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths) {
 }
 
 /**
- * Перевіряє кореневий `package.json`: скрипти, заборонені залежності, агрегований `lint`.
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- * @returns {Promise<boolean>} `true`, якщо `package.json` знайдено й оброблено; `false` — нема
- */
-async function checkPackageJsonImage(pass, fail) {
-  if (!existsSync('package.json')) {
-    fail('package.json не знайдено в корені — додай (image.mdc)')
-    return false
-  }
-  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-  const scripts = /** @type {Record<string, unknown>} */ (pkg.scripts || {})
-  checkLintImageScript(typeof scripts['lint-image'] === 'string' ? scripts['lint-image'] : undefined, pass, fail)
-  checkLintAggregateIncludesImage(typeof scripts.lint === 'string' ? scripts.lint : undefined, pass, fail)
-  checkMinifyImageNotInDeps(pkg, pass, fail)
-  return true
-}
-
-/**
- * Перевіряє відповідність проєкту правилам `image.mdc` (split-cache 3.2.0):
- * `lint-image` через `npx @nitra/minify-image --src=. --write` (без `--avif`!), агрегований `lint`,
- * `.n-minify-image.tsv` НЕ в `.gitignore` (committed source of truth), застарілий
- * `.minify-image-cache.tsv` видалений. Окремо виконуються дії: запуск AVIF-генерації,
- * авто-заміна raster-посилань у `.vue`/`.html`, видалення AVIF-сиріт. CI-workflow
- * для image не вимагається — лінт зображень виконується лише локально.
+ * Виконує AVIF-етап: запуск AVIF-генерації, авто-заміна raster-посилань у `.vue`/`.html`,
+ * видалення AVIF-сиріт. Не валідує `package.json`/`lint-image` — це вже у `image-compress`.
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
-  const pkgFound = await checkPackageJsonImage(pass, fail)
-  if (pkgFound) {
-    await checkHashCacheNotIgnored(pass, fail)
-    await checkLegacyCacheRemoved(pass, fail)
-  }
   const ignorePaths = await loadCursorIgnorePaths(process.cwd())
 
   if (await hasAnyRasterImage(ignorePaths)) {
@@ -523,7 +385,7 @@ export async function check() {
   const orphansDeleted = await cleanupOrphanAvifs(usedAvifAbs, optedOutAbs, ignorePaths)
 
   pass(
-    `image: rewrote ${stats.rewrittenRefs} reference${stats.rewrittenRefs === 1 ? '' : 's'} in ${stats.rewrittenFiles} file${stats.rewrittenFiles === 1 ? '' : 's'}; ` +
+    `image-avif: rewrote ${stats.rewrittenRefs} reference${stats.rewrittenRefs === 1 ? '' : 's'} in ${stats.rewrittenFiles} file${stats.rewrittenFiles === 1 ? '' : 's'}; ` +
       `deleted ${orphansDeleted} orphan AVIF${orphansDeleted === 1 ? '' : 's'}; ` +
       `failed to rewrite ${stats.failedRefs} reference${stats.failedRefs === 1 ? '' : 's'}`
   )

package/scripts/check-image-compress.mjs

@@ -0,0 +1,216 @@
+/**
+ * Перевіряє відповідність репозиторію правилу `image-compress.mdc`: канонічний скрипт
+ * `lint-image` для оптимізації raster/SVG через `@nitra/minify-image` ≥ 3.2.0 (локально).
+ *
+ * Очікування:
+ * - у кореневому `package.json` є скрипт `lint-image`, який викликає `npx @nitra/minify-image`
+ *   з обовʼязковими `--src=.` і `--write`. Прапорець `--avif` у `lint-image` заборонений —
+ *   AVIF-генерацію виконує окреме правило `image-avif` (інакше `bun run lint` плодив би `.avif`
+ *   для зображень, що ніде не вживаються);
+ * - якщо в `package.json` є агрегований скрипт `lint`, він викликає `bun run lint-image`
+ *   (симетрично до `lint-text`, `lint-js`, `lint-ga`);
+ * - `@nitra/minify-image` не оголошений у `dependencies`/`devDependencies` —
+ *   CLI запускається лише через `npx` (як `markdownlint-cli2` у `text.mdc`);
+ * - `.n-minify-image.tsv` (committed source of truth з sha1/originalSize/size) НЕ
+ *   в `.gitignore` — він має бути в git. Локальний mtime-кеш у
+ *   `node_modules/.cache/@nitra/minify-image/mtime.tsv` авто-gitignored через `node_modules/`,
+ *   окремої перевірки не вимагає;
+ * - застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений з кореня — інакше
+ *   проєкт лишається у напівпереміщеному стані.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+
+import { createCheckReporter } from './utils/check-reporter.mjs'
+
+/** Імʼя CLI-пакета: рядок у `lint-image` і заборонений у залежностях. */
+const MINIFY_PACKAGE_NAME = '@nitra/minify-image'
+
+/** Імʼя committed-кешу (sha1 + originalSize + size) у `@nitra/minify-image` ≥ 3.2.0. */
+const HASH_CACHE_FILENAME = '.n-minify-image.tsv'
+
+/** Імʼя застарілого 4-колонкового кешу (`@nitra/minify-image` < 3.2). Має бути видалений після міграції. */
+const LEGACY_CACHE_FILENAME = '.minify-image-cache.tsv'
+
+/**
+ * Перевіряє скрипт `lint-image` у `package.json`.
+ *
+ * Має містити виклик `npx @nitra/minify-image` з обовʼязковими прапорцями `--src=.`
+ * і `--write` (авто-оптимізація на місці). Прапорець `--avif` у `lint-image`
+ * заборонений — AVIF-генерацію виконує `check image-avif`, інакше `bun run lint` плодить
+ * `.avif` для зображень, що ніде не вживаються.
+ * @param {string|undefined} lintImage значення `scripts['lint-image']`
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {void}
+ */
+function checkLintImageScript(lintImage, pass, fail) {
+  const canonical = `npx ${MINIFY_PACKAGE_NAME} --src=. --write`
+  if (typeof lintImage !== 'string' || !lintImage.trim()) {
+    fail(`package.json: додай скрипт "lint-image" з \`${canonical}\` (image-compress.mdc)`)
+    return
+  }
+  if (!lintImage.includes(`npx ${MINIFY_PACKAGE_NAME}`)) {
+    fail(`package.json: lint-image має викликати \`npx ${MINIFY_PACKAGE_NAME}\` (image-compress.mdc)`)
+    return
+  }
+  /** @type {{ flag: string, variants: string[], hint: string }[]} */
+  const requiredFlags = [
+    { flag: '--src=.', variants: ['--src=.', '--src .'], hint: '`--src=.`' },
+    { flag: '--write', variants: ['--write'], hint: '`--write` (авто-оптимізація на місці)' }
+  ]
+  const missing = requiredFlags.filter(f => !f.variants.some(v => lintImage.includes(v)))
+  if (missing.length > 0) {
+    fail(
+      `package.json: lint-image має містити ${missing.map(f => f.hint).join(', ')} — канонічний виклик: \`${canonical}\` (image-compress.mdc)`
+    )
+    return
+  }
+  if (lintImage.includes('--avif')) {
+    fail(
+      `package.json: прибери \`--avif\` з lint-image — AVIF-генерацію виконує \`npx @nitra/cursor check image-avif\` (image-compress.mdc). Канонічний виклик: \`${canonical}\``
+    )
+    return
+  }
+  pass(`package.json: lint-image викликає \`${canonical}\``)
+}
+
+/**
+ * Перевіряє, що агрегований `lint` (якщо є) кличе `bun run lint-image` —
+ * симетрично до `lint-text`, `lint-js`, `lint-ga`.
+ * @param {string|undefined} lintAggregate значення `scripts.lint`
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {void}
+ */
+function checkLintAggregateIncludesImage(lintAggregate, pass, fail) {
+  if (typeof lintAggregate !== 'string' || !lintAggregate.trim()) {
+    return
+  }
+  if (lintAggregate.includes('bun run lint-image')) {
+    pass('package.json: агрегований `lint` викликає `bun run lint-image`')
+  } else {
+    fail(
+      'package.json: у `lint` додай `bun run lint-image` (image-compress.mdc, симетрично до lint-text / lint-js / lint-ga)'
+    )
+  }
+}
+
+/**
+ * Забороняє `@nitra/minify-image` у `dependencies` чи `devDependencies` —
+ * CLI завжди запускається через `npx` (як `markdownlint-cli2` у `text.mdc`).
+ * @param {{ dependencies?: Record<string, unknown>, devDependencies?: Record<string, unknown> }} pkg розібраний package.json
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {void}
+ */
+function checkMinifyImageNotInDeps(pkg, pass, fail) {
+  const inDeps = Boolean(pkg.dependencies && MINIFY_PACKAGE_NAME in pkg.dependencies)
+  const inDevDeps = Boolean(pkg.devDependencies && MINIFY_PACKAGE_NAME in pkg.devDependencies)
+  if (inDeps || inDevDeps) {
+    fail(
+      `package.json: ${MINIFY_PACKAGE_NAME} не додавай у dependencies/devDependencies — лише через \`npx\` (image-compress.mdc)`
+    )
+  } else {
+    pass(`package.json: ${MINIFY_PACKAGE_NAME} не оголошено в dependencies/devDependencies`)
+  }
+}
+
+/**
+ * Зчитує всі змістовні рядки `.gitignore` (без коментарів і порожніх). Якщо файла нема — `null`.
+ * @returns {Promise<string[] | null>} список trim-нутих рядків або `null`
+ */
+async function readGitignoreLines() {
+  if (!existsSync('.gitignore')) return null
+  const raw = await readFile('.gitignore', 'utf8')
+  return raw
+    .split('\n')
+    .map(l => l.trim())
+    .filter(l => l.length > 0 && !l.startsWith('#'))
+}
+
+/**
+ * Перевіряє, що `.n-minify-image.tsv` НЕ в `.gitignore` — він має бути в git
+ * (split-cache 3.2.0: source of truth для slow-path і lifetime savings).
+ *
+ * Сам факт існування файла НЕ вимагається — на свіжому проєкті без обробки
+ * зображень його ще нема, це нормально.
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<void>}
+ */
+async function checkHashCacheNotIgnored(pass, fail) {
+  const lines = await readGitignoreLines()
+  if (lines && lines.includes(HASH_CACHE_FILENAME)) {
+    fail(
+      `.gitignore: прибери рядок \`${HASH_CACHE_FILENAME}\` — це закомічений source of truth split-cache 3.2.0 (image-compress.mdc)`
+    )
+  } else {
+    pass(`${HASH_CACHE_FILENAME} не в .gitignore (має бути в git)`)
+  }
+}
+
+/**
+ * Перевіряє, що застарілий `.minify-image-cache.tsv` (з версій < 3.2) видалений
+ * з кореня. Якщо лежить — користувач не завершив міграцію на split-cache, що
+ * залишає файл як орфана у git-історії.
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<void>}
+ */
+async function checkLegacyCacheRemoved(pass, fail) {
+  if (existsSync(LEGACY_CACHE_FILENAME)) {
+    fail(
+      `${LEGACY_CACHE_FILENAME} застарілий (split-cache 3.2.0) — видали: ` +
+        `\`git rm --cached ${LEGACY_CACHE_FILENAME} 2>/dev/null || true && rm -f ${LEGACY_CACHE_FILENAME}\` ` +
+        '(також прибери відповідний рядок з .gitignore, якщо є)'
+    )
+    return
+  }
+  const lines = await readGitignoreLines()
+  if (lines && lines.includes(LEGACY_CACHE_FILENAME)) {
+    fail(`.gitignore: прибери застарілий рядок \`${LEGACY_CACHE_FILENAME}\` — split-cache 3.2.0 його не використовує`)
+    return
+  }
+  pass(`${LEGACY_CACHE_FILENAME} відсутній (міграція на split-cache завершена)`)
+}
+
+/**
+ * Перевіряє кореневий `package.json`: скрипти, заборонені залежності, агрегований `lint`.
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<boolean>} `true`, якщо `package.json` знайдено й оброблено; `false` — нема
+ */
+async function checkPackageJsonImage(pass, fail) {
+  if (!existsSync('package.json')) {
+    fail('package.json не знайдено в корені — додай (image-compress.mdc)')
+    return false
+  }
+  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+  const scripts = /** @type {Record<string, unknown>} */ (pkg.scripts || {})
+  checkLintImageScript(typeof scripts['lint-image'] === 'string' ? scripts['lint-image'] : undefined, pass, fail)
+  checkLintAggregateIncludesImage(typeof scripts.lint === 'string' ? scripts.lint : undefined, pass, fail)
+  checkMinifyImageNotInDeps(pkg, pass, fail)
+  return true
+}
+
+/**
+ * Перевіряє відповідність проєкту правилу `image-compress.mdc`: канонічний `lint-image`
+ * (через `npx @nitra/minify-image --src=. --write`, без `--avif`!), агрегований `lint`,
+ * `@nitra/minify-image` не у залежностях, `.n-minify-image.tsv` НЕ в `.gitignore`,
+ * застарілий `.minify-image-cache.tsv` видалений. CI-workflow для image не вимагається —
+ * лінт зображень виконується лише локально.
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  const pkgFound = await checkPackageJsonImage(pass, fail)
+  if (pkgFound) {
+    await checkHashCacheNotIgnored(pass, fail)
+    await checkLegacyCacheRemoved(pass, fail)
+  }
+
+  return reporter.getExitCode()
+}

package/scripts/check-js-run.mjs

@@ -358,7 +358,7 @@ async function checkWorkspacePackage(rootDir, ignorePaths, workflows, fail, pass
  */
 function checkDepcheckInWorkflows(rootDir, workflows, label, fail, passFn) {
   if (workflows.length === 0) return
-  const violations = findDepcheckViolationsForPackage(workflows, rootDir.replace(/\\/g, '/'))
+  const violations = findDepcheckViolationsForPackage(workflows, rootDir.replaceAll('\\', '/'))
   if (violations.length === 0) {
     passFn(`${label}depcheck у path-scoped workflow налаштовано (або відсутній path-scoped workflow для пакета)`)
     return

package/scripts/utils/depcheck-workflow.mjs

@@ -37,7 +37,7 @@ const IGNORES_FLAG_RE = /--ignores\s*=?\s*(?:"([^"]*)"|'([^']*)'|([^\s"']+))/u
  * @returns {boolean} `true`, якщо знайдено хоча б один підходящий glob
  */
 export function workflowHasPathsScopedToPackage(root, pkgRoot) {
-  const prefix = `${pkgRoot.replace(/\\/g, '/').replace(/\/+$/, '')}/`
+  const prefix = `${pkgRoot.replaceAll('\\', '/').replace(/\/+$/, '')}/`
   const on = root?.on
   if (!on || typeof on !== 'object') return false
   for (const event of /** @type {const} */ (['push', 'pull_request'])) {
@@ -85,8 +85,8 @@ export function extractDepcheckArgs(runText) {
 export function stepWorkingDirectoryEquals(step, pkgRoot) {
   const wd = step['working-directory']
   if (typeof wd !== 'string') return false
-  const norm = wd.replace(/\\/g, '/').replace(/\/+$/, '')
-  const expected = pkgRoot.replace(/\\/g, '/').replace(/\/+$/, '')
+  const norm = wd.replaceAll('\\', '/').replace(/\/+$/, '')
+  const expected = pkgRoot.replaceAll('\\', '/').replace(/\/+$/, '')
   return norm === expected
 }
 

package/mdc/image.mdc

@@ -1,96 +0,0 @@
----
-description: Оптимізація зображень через @nitra/minify-image у локальному lint
-alwaysApply: true
-version: '1.5'
----
-
-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` заборонена** — її виконує лише `npx @nitra/cursor check image`, який заодно прибирає AVIF-сироти (див. секцію «AVIF-імпорти у `.vue`»). Split-cache робить повторні прогони дешевими — і локально, і після `git clone`.
-
-Перевірка лише локальна — у CI `lint-image` не запускаємо (sharp/svgo тягнуть бінарні залежності, цінність на ubuntu-runner-ах нижча за час прогону). Окремий workflow `lint-image.yml` створювати не треба.
-
-## `package.json`
-
-```json title="package.json"
-{
-  "scripts": {
-    "lint": "bun run lint-js && bun run lint-text && bun run lint-ga && bun run lint-image && oxfmt .",
-    "lint-image": "npx @nitra/minify-image --src=. --write"
-  }
-}
-```
-
-Якщо в `package.json` уже є агрегований `lint`, додай у його ланцюжок `bun run lint-image` (як `bun run lint-text`, `bun run lint-js`, `bun run lint-ga`). Так розробник, що локально гонить `bun run lint`, перед фіксацією одразу бачить, чи зросли зображення.
-
-## Split-cache
-
-Починаючи з `@nitra/minify-image` **3.2.0** кеш розбитий на два файли з різною семантикою:
-
-### `.n-minify-image.tsv` — source of truth у git
-
-У корені сканованого каталогу. Формат: `<rel-path>\t<sha1-hex>\t<originalSize>\t<size>`.
-
-Slow-path і джерело даних для `Project lifetime savings`. **Має бути в git** — після `git clone` чи `git checkout` (mtime скидається на час checkout-у) CLI читає файл, рахує SHA-1 і порівнює зі збереженим у TSV хешем; на match локальний mtime-кеш зігрівається без reprocess. Рядки відсортовані алфавітно, hash і size змінюються лише при реальній зміні контенту — diff чистий.
-
-### `node_modules/.cache/@nitra/minify-image/mtime.tsv` — локальний fast-path
-
-Формат: `<rel-path>\t<mtime>\t<size>`. При збігу `(size, mtime)` CLI пропускає файл без читання — константа per-file.
-
-Лежить під `node_modules/`, тож **авто-gitignored** за конвенцією JS-tooling-у (так кешуються ESLint, Babel, webpack, Turbo). Окремий рядок у `.gitignore` не потрібен. `rm -rf node_modules` зносить — наступний запуск відновлює його через slow-path проти `.n-minify-image.tsv`, без reprocess.
-
-### Міграція з versions < 3.2
-
-Старий єдиний `.minify-image-cache.tsv` (4 колонки `path\tmtime\toriginalSize\tsize`, зазвичай у `.gitignore`) автоматично читається при першому запуску для seed-у `originalSize` у `.n-minify-image.tsv` (lifetime savings не скидається). Після цього старий файл видаляють вручну:
-
-```bash
-git rm --cached .minify-image-cache.tsv 2>/dev/null || true
-rm -f .minify-image-cache.tsv
-# прибери відповідний рядок з .gitignore, якщо був
-```
-
-AVIF-двійники (`<name>.<ext>.avif`) **зберігаємо в git** — це готові артефакти для віддачі браузеру (без них ефект від AVIF втрачається на чистому checkout-і).
-
-## AVIF-імпорти у `.vue`
-
-AVIF-двійники (`<name>.<ext>.avif`) генерує **виключно** `npx @nitra/cursor check image` — у `lint-image` прапорець `--avif` заборонений (інакше `bun run lint` плодить непотрібні `.avif` для зображень, що ніде не використовуються). Перевірка робить три кроки в порядку:
-
-1. Запускає `npx @nitra/minify-image --src=. --write --avif` — генерує `<name>.<ext>.avif` поряд з кожним PNG/JPEG/GIF.
-2. Сканує `.vue` (а також `.html`) файли в кожному workspace-пакеті (root + workspaces) і автоматично переписує raster-посилання на AVIF-двійник у двох формах:
-   - **Імпорт-пов'язані** — `import x from '...png|jpg|jpeg|gif'` (далі `:src="x"` у шаблоні);
-   - **Прямі статичні** — `<img src="...png" />` у `<template>` (Vite перетворює такий шлях на asset-імпорт на етапі збірки, тож вимога та сама).
-3. Видаляє AVIF-сироти: ходить по всіх `<...>.avif` у репозиторії; якщо на двійник не лишилось жодного посилання у `.vue`/`.html` — файл видаляється. **AVIF на диску лишається лише там, де заміна реально відбулась** — тому невикористані оригінали не накопичують `.avif`-«хвости».
-
-```vue title="App.vue (після check image)"
-<script setup>
-import welcomeImage from './assets/welcome.png.avif'
-</script>
-
-<template>
-  <img :src="welcomeImage" alt="Welcome" />
-</template>
-```
-
-Реактивне `:src="..."` (з JS-виразом — змінною, тернарником, викликом тощо) **не сканується** — значення обчислюється у рантаймі й шлях туди потрапляє через імпорт або інший резолвинг, який ловить імпорт-перевірка вище. SVG не торкаємо (vector → AVIF безглуздо). Атрибути `data-src=`, `obj.src=` у `<script>` тощо також пропускаються.
-
-Якщо raster-посилання у `.vue`/`.html` не вдалось переписати (наприклад, оригіналу немає на диску, тож і `.avif` не згенерувався) — `check image` падає з помилкою на конкретний файл, як раніше.
-
-### Опт-аут для конкретного пакета
-
-У workspace-пакеті, де AVIF-імпорти небажані (наприклад, мобільний бандл, де AVIF-підтримка не гарантована), додай у `package.json` цього пакета:
-
-```json title="apps/mobile/package.json"
-{
-  "@nitra/minify-image": {
-    "disable-avif": true
-  }
-}
-```
-
-Тоді перевірка пропускає `.vue` файли цього пакета. У root-`package.json` опт-аут діє лише для файлів кореня (вкладені workspaces перевіряються незалежно — вмикай прапор у кожному пакеті, де треба).
-
-## Заборонені залежності
-
-`@nitra/minify-image` не повинен зʼявлятися ні в `dependencies`, ні в `devDependencies` кореневого `package.json` — CLI запускається лише через `npx` (так само, як `markdownlint-cli2` у text.mdc). Якщо потрібен явний пін — закладай діапазон версій npm у самому виклику (`npx @nitra/minify-image@^3 --src=. --write`).
-
-## Перевірка
-
-`npx @nitra/cursor check image` (охоплює `lint-image` з обовʼязковими `--src=.`, `--write` і **забороненим** `--avif`; агрегований `lint`; `.n-minify-image.tsv` НЕ в `.gitignore` — має бути в git; відсутність застарілого `.minify-image-cache.tsv` у корені; запуск AVIF-генерації + авто-заміна raster-посилань на `.avif` у `.vue`/`.html` кожного workspace-пакета + прибирання AVIF-сиріт).