@nitra/cursor 12.11.1 → 12.11.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.11.3] - 2026-06-25
+
+### Changed
+
+- rm doc-aggregate; dep policy
+
+## [12.11.2] - 2026-06-25
+
+### Changed
+
+- docs: файлова документація для fix-<concern>.mjs та суміжних файлів; feat(fix): розкладаємо T0-паттерни по правилах — fix-<concern>.mjs конвенція
+
 ## [12.11.1] - 2026-06-25
 
 ### Changed

package/bin/n-cursor.js

@@ -14,7 +14,6 @@
  *                                     весь репо (`per-file` ∪ `full`); `--read-only` = без мутацій/LLM (CI); позиційні
  *                                     (не-флаг) аргументи — фільтр правил конформності (мапить колишній `fix <rule>`).
  *                                     CI = `lint --read-only --full` (весь репо, нуль мутацій/LLM).
- *   `npx \@nitra/cursor doc-aggregate modules` — JSON-лістинг логічних модулів (межі за `package.json`) для Tier 2 скілу doc-aggregate
  *   `npx \@nitra/cursor skill list`     — скіли пакета без синку в проєкт
  *   `npx \@nitra/cursor skill taze`     — промпт на stdout
  *   `npx \@nitra/cursor skill cursor taze ["task"]` — Cursor CLI (`cursor-agent -p`)
@@ -1593,20 +1592,6 @@ try {
 
       break
     }
-    case 'doc-aggregate': {
-      // n-cursor doc-aggregate modules — детермінований лістинг логічних модулів
-      // (межі за package.json) для Tier 2 module-summary скілу doc-aggregate.
-      // Друкує JSON; module-summary і доменні доки пише скіл, диспатчачи субагентів.
-      const { runDocAggregateModulesCli } = await import('../skills/doc-aggregate/js/docgen-scan.mjs')
-      if (args[0] === 'modules') {
-        process.exitCode = await runDocAggregateModulesCli(args.slice(1))
-      } else {
-        console.error('Usage: npx @nitra/cursor doc-aggregate <modules> [--root <dir>]')
-        process.exitCode = 1
-      }
-
-      break
-    }
     case undefined:
     case '': {
       await runSync()

package/package.json

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

package/rules/adr/js/docs/hooks.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль перевіряє стан проєкту, валідуючи конфігураційні файли (`settings.json`, `hooks.json`, `settings.local.json`) та перевіряючи наявність структур для документації (adr.mdc). Перевірка включає перевірку наявності необхідних елементів, при цьому шляхи `.git` свідомо ігноруються.
 
 ## Поведінка

package/rules/bun/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/bun/
 
 # npm/rules/bun
 
-| Файл                | Тип       |
-| ------------------- | --------- |
+| Файл | Тип |
+|---|---|
 | [main.mjs](main.md) | JS Module |

package/rules/bun/docs/main.md

@@ -3,24 +3,24 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/bun/main.mjs
 docgen:
-  crc: 762b6875
+  crc: a2cfc572
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
+  score: 90
 ---
 
-Модуль валідує дані, застосовуючи правила, визначені у конфігурації meta.json, та збирає посилання на MDC. При виклику публічної функції run він здійснює повний запуск правила, включаючи завантаження конфігурацій та застосування білих списків. Результат виконання повертається як код виходу процесу.
+## Огляд
+
+Модуль виконує перевірку відповідності коду встановленим політикам, використовуючи маркер повідомлень (bun.mdc). Він також аналізує ліцензії залежностей, спираючись на конфігурацію .licensee.json. Модуль надає функції для запуску перевірок (run) та лінтингу (lint).
 
 ## Поведінка
 
-1. Викликається функція `run` для виконання перевірки.
-2. Виконання перевірки включає застосування правил, обробку логіки, визначену в конфігурації `meta.json`, та збір посилань на MDC.
-3. Якщо код виконується як окремий інструмент (standalone), ініціюється повний запуск правила.
-4. Повний запуск правила включає завантаження конфігурацій, застосування білих списків та підбиття підсумків.
-5. Результат виконання повертається як код виходу процесу.
+run виконує перевірку коду, застосовуючи політики та посилання MDC.
+lint виконує перевірку ліцензій npm-залежностей, якщо існує файл .licensee.json у корені проєкту.
 
 ## Публічний API
 
-run — виконує основну логіку правила: застосовує перевірки до коду, аналізує відповідність політиці та перевіряє посилання на метадані.
+run — Основний вхідний пункт правила, який виконує перевірку: застосовує логіку, перевіряє відповідність політикам та згадки в (bun.mdc).
+lint — Інструмент для перевірки ліцензій npm-залежностей у всьому репозиторії, що активується через конфігурацію (.licensee.json).
 
 ## Гарантії поведінки
 

package/rules/bun/js/docs/fix-layout.md

@@ -0,0 +1,25 @@
+---
+type: JS Module
+title: fix-layout.mjs
+resource: npm/rules/bun/js/fix-layout.mjs
+docgen:
+  crc: 168821f1
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Файл T0-autofix паттерни для `bun/js/layout.mjs` детермінують FS-виправлення, які видаляють заборонені файли залежностей (наприклад, package-lock.json), створюють відсутній bunfig.toml та рекурсивно видаляють каталог .yarn. Ці виправлення спираються на конфіги, зокрема package-lock.json.
+
+## Поведінка
+
+patterns
+
+1. Перевіряє вивід на наявність повідомлення про знайдений заборонений файл. Якщо знайдено, ідентифікує всі заборонені файли. Для кожного ідентифікованого файлу, якщо він існує, видаляє його. Повертає результат, що вказує на успішне видалення файлів або відсутність відповідності.
+2. Перевіряє вивід на наявність повідомлення про відсутність `bunfig.toml`. Якщо повідомлення знайдено, і якщо файл `bunfig.toml` не існує, створює його з базовим вмістом. Повертає результат, що вказує на успішне створення файлу або на те, що він вже існує.
+3. Перевіряє вивід на наявність повідомлення про знайдену директорію `.yarn`. Якщо повідомлення знайдено, і якщо директорія `.yarn` існує, рекурсивно видаляє її. Повертає результат, що вказує на успішне видалення директорії або на її відсутність.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/bun/js/docs/index.md

@@ -6,6 +6,7 @@ resource: npm/rules/bun/js/
 
 # npm/rules/bun/js
 
-| Файл                    | Тип       |
-| ----------------------- | --------- |
+| Файл | Тип |
+|---|---|
+| [fix-layout.mjs](fix-layout.md) | JS Module |
 | [layout.mjs](layout.md) | JS Module |

package/rules/bun/js/fix-layout.mjs

@@ -0,0 +1,55 @@
+/**
+ * T0-autofix паттерни для `bun/js/layout.mjs` — детерміновані FS-виправлення
+ * заборонених файлів (package-lock.json, yarn.lock тощо), відсутнього bunfig.toml
+ * та каталогу .yarn без звернення до LLM.
+ */
+import { existsSync, rmSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const FORBIDDEN_FILE_RE = /Знайдено заборонений файл: \S+/
+const FORBIDDEN_FILE_MATCH_ALL_RE = /Знайдено заборонений файл: (\S+)/g
+
+/** @type {import('../../../scripts/lib/fix/discover-t0-patterns.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'rm-forbidden-file',
+    test: out => FORBIDDEN_FILE_RE.test(out),
+    apply: (out, cwd) => {
+      const matches = [...out.matchAll(FORBIDDEN_FILE_MATCH_ALL_RE)]
+      if (matches.length === 0) return { ok: false, action: 'no match' }
+
+      const removed = []
+      for (const m of matches) {
+        const filePath = join(cwd, m[1])
+        if (existsSync(filePath)) {
+          rmSync(filePath, { force: true })
+          removed.push(m[1])
+        }
+      }
+      if (removed.length === 0) return { ok: false, action: 'файлів не знайдено' }
+      return { ok: true, action: `видалено: ${removed.join(', ')}` }
+    }
+  },
+
+  {
+    id: 'bun-bunfig-create',
+    test: out => /Відсутній bunfig\.toml/.test(out),
+    apply: (_out, cwd) => {
+      const target = join(cwd, 'bunfig.toml')
+      if (existsSync(target)) return { ok: false, action: 'bunfig.toml вже існує' }
+      writeFileSync(target, '[install]\nlinker = "hoisted"\n', 'utf8')
+      return { ok: true, action: 'створено bunfig.toml' }
+    }
+  },
+
+  {
+    id: 'bun-yarn-dir-remove',
+    test: out => /Знайдено директорію \.yarn/.test(out),
+    apply: (_out, cwd) => {
+      const target = join(cwd, '.yarn')
+      if (!existsSync(target)) return { ok: false, action: '.yarn не знайдено' }
+      rmSync(target, { recursive: true, force: true })
+      return { ok: true, action: 'видалено .yarn/' }
+    }
+  }
+]

package/rules/bun/main.json

@@ -1 +1 @@
-{ "auto": { "glob": "package.json" } }
+{ "auto": { "glob": "package.json" }, "lint": "full" }

package/rules/bun/main.mjs

@@ -1,11 +1,17 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+import { createCheckReporter } from '../../scripts/lib/check-reporter.mjs'
+import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
 import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
  * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
- * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
- * (`meta.json` без `lint`), тож експорту `lint` тут немає.
- * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * JS-concerns → policy → mdc-refs (через runStandardRule). `lint()` — lint-поверхня
+ * (licensee — перевірка ліцензій npm-залежностей, лише у `--full`).
  * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
  */
@@ -13,6 +19,50 @@ export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
 
+/**
+ * Перевірка ліцензій npm-залежностей через `licensee`. Opt-in: пропускається якщо
+ * `.licensee.json` відсутній у cwd (проєкт не налаштував allowlist). `bun x licensee`
+ * не потребує локальної установки — bunx завантажує пакет ad-hoc.
+ * @param {string} [cwd] корінь проєкту
+ * @returns {number} 0 — OK, 1 — порушення
+ */
+function runLicenseeSteps(cwd = process.cwd()) {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  if (!existsSync(join(cwd, '.licensee.json'))) {
+    pass('lint-bun: licensee — немає .licensee.json, перевірку ліцензій пропущено')
+    return reporter.getExitCode()
+  }
+
+  const bun = resolveCmd('bun')
+  if (!bun) {
+    fail('lint-bun: `bun` не знайдено в PATH (bun.mdc)')
+    return reporter.getExitCode()
+  }
+
+  const r = spawnSync(bun, ['x', 'licensee', '--production', '--quiet'], { cwd, stdio: 'inherit', shell: false })
+  if (r.status === 0) {
+    pass('lint-bun: licensee — ліцензії OK')
+  } else {
+    const code = typeof r.status === 'number' ? r.status : 1
+    fail(`lint-bun: licensee — порушення ліцензій (код ${code}, bun.mdc)`)
+  }
+  return reporter.getExitCode()
+}
+
+/**
+ * Оркестраторний адаптер `n-cursor lint bun`: licensee-перевірка ліцензій npm-залежностей.
+ * Whole-repo (ігнорує `_files`). Opt-in через `.licensee.json` у cwd.
+ * @param {string[] | undefined} _files ігнорується
+ * @param {string} [cwd] корінь
+ * @param {{ readOnly?: boolean }} [_opts] не використовується (licensee завжди read-only)
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files, cwd = process.cwd(), _opts = {}) {
+  return runStandardLint(import.meta.dirname, () => runLicenseeSteps(cwd))
+}
+
 if (isRunAsCli(import.meta.url)) {
   // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
   // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).

package/rules/changelog/js/docs/fix-consistency.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: fix-consistency.mjs
+resource: npm/rules/changelog/js/fix-consistency.mjs
+docgen:
+  crc: f8727498
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Створює change-файл для воркспейсів у `changelog/js/consistency.mjs`, коли відсутній відповідний файл. Опис change-файлу береться з суб'єкта останнього git-коміту, а рівень зміни (`bump`) завжди встановлюється як `patch`.
+
+## Поведінка
+
+1. Визначає шаблони для автоматичного виправлення.
+2. `patterns` містить один шаблон, який перевіряє наявність повідомлення про відсутність change-файлу.
+3. Якщо шаблон спрацьовує, він виявляє всі воркспейси, які потребують створення change-файлу.
+4. Визначає опис для change-файлу на основі суб'єкта останнього git-коміту в корені репозиторію. Якщо суб'єкт відсутній, використовується зарезервоване повідомлення.
+5. Для кожного виявленого воркспейсу створюється change-файл з рівнем `patch` та розділом `Changed`, використовуючи визначений опис.
+6. Повертає результат, що вказує на успішне створення change-файлів для відповідних воркспейсів.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/changelog/js/docs/index.md

@@ -9,3 +9,4 @@ resource: npm/rules/changelog/js/
 | Файл | Тип |
 |---|---|
 | [consistency.mjs](consistency.md) | JS Module |
+| [fix-consistency.mjs](fix-consistency.md) | JS Module |

package/rules/changelog/js/fix-consistency.mjs

@@ -0,0 +1,50 @@
+/**
+ * T0-autofix для `changelog/js/consistency.mjs` — детерміноване створення
+ * change-файлу для воркспейсів з релевантними змінами без change-файлу.
+ * Subject останнього git-коміту стає описом; bump завжди `patch`.
+ */
+import { spawnSync } from 'node:child_process'
+import { join } from 'node:path'
+
+import { writeChange } from '../../release/change.mjs'
+
+const MISSING_CHANGE_RE = /є релевантні зміни, але немає change-файлу/
+const MISSING_CHANGE_MATCH_ALL_RE = /(?:^|\s)([\w./@-]+): є релевантні зміни, але немає change-файлу/gm
+
+const CHANGE_BUMP = 'patch'
+const CHANGE_SECTION = 'Changed'
+const CHANGE_FALLBACK_MESSAGE = 'оновлення'
+
+/**
+ * @param {string} cwd корінь репозиторію
+ * @returns {string} непорожній опис
+ */
+function autoChangeMessage(cwd) {
+  const r = spawnSync('git', ['log', '-1', '--format=%s'], { cwd, encoding: 'utf8' })
+  const subject = r.status === 0 ? (r.stdout ?? '').trim() : ''
+  return subject || CHANGE_FALLBACK_MESSAGE
+}
+
+/** @type {import('../../../scripts/lib/fix/discover-t0-patterns.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'changelog-create-change-file',
+    test: out => MISSING_CHANGE_RE.test(out),
+    apply: async (out, cwd) => {
+      const workspaces = Array.from(out.matchAll(MISSING_CHANGE_MATCH_ALL_RE), m => m[1])
+      if (workspaces.length === 0) return { ok: false, action: 'no match' }
+
+      const message = autoChangeMessage(cwd)
+      const created = []
+      for (const ws of workspaces) {
+        try {
+          const rel = await writeChange({ bump: CHANGE_BUMP, section: CHANGE_SECTION, message, ws, cwd })
+          created.push(ws === '.' ? rel : join(ws, rel))
+        } catch (error) {
+          return { ok: false, action: `writeChange ${ws}: ${error.message}` }
+        }
+      }
+      return { ok: true, action: `створено change-файл (${CHANGE_BUMP}/${CHANGE_SECTION}): ${created.join(', ')}` }
+    }
+  }
+]

package/rules/ci4/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/ci4/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл відповідає за завантаження шаблонів, необхідних для функціонування розширення VS Code.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з іншого скрипта.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/ci4/policy/vscode_extensions/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/ci4/policy/vscode_extensions
+resource: npm/rules/ci4/policy/vscode_extensions/
+---
+
+# npm/rules/ci4/policy/vscode_extensions
+
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [fix-vscode_extensions.mjs](fix-vscode_extensions.md) | JS Module |

package/rules/ci4/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/ga/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,22 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/ga/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл реалізує застосування шаблонів для форматування розширень VS Code. Він застосовує правила форматування, використовуючи імпортовані шаблони.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code.
+2. Використовує імпортовані шаблони для виконання логіки виправлення розширень VS Code.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/ga/policy/vscode_extensions/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/ga/policy/vscode_extensions
+resource: npm/rules/ga/policy/vscode_extensions/
+---
+
+# npm/rules/ga/policy/vscode_extensions
+
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [fix-vscode_extensions.mjs](fix-vscode_extensions.md) | JS Module |

package/rules/ga/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/graphql/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/graphql/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Завантажує шаблони, необхідні для функціонування розширення VS Code.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з іншого скрипта.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/graphql/policy/vscode_extensions/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/graphql/policy/vscode_extensions
+resource: npm/rules/graphql/policy/vscode_extensions/
+---
+
+# npm/rules/graphql/policy/vscode_extensions
+
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [fix-vscode_extensions.mjs](fix-vscode_extensions.md) | JS Module |

package/rules/graphql/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/js/js/dep-policy.mdc

@@ -2,6 +2,25 @@
 
 `@e18e/eslint-plugin` окремо не додавай — він уже в залежностях `@nitra/eslint-config` (з **3.8.0**), oxlint підвантажує його з `node_modules`. Пакети `oxlint`/`eslint`/`jscpd`/`knip` теж не додавай у `devDependencies` без потреби монорепо — `bunx` тягне їх ad-hoc.
 
+### Заборона `ua-parser-js`
+
+Пакет **`ua-parser-js`** заборонений починаючи з версії **2.x**, де ліцензія змінилась з MIT на **AGPL-3.0** — несумісну з комерційним використанням у закритому SaaS. Замінити на **`bowser`** (MIT, ~6 KB gzip):
+
+```javascript title="❌ до"
+import { UAParser } from 'ua-parser-js'
+const parser = new UAParser(userAgent)
+const result = parser.getResult()
+const browserName = result.browser.name
+```
+
+```javascript title="✅ після"
+import Bowser from 'bowser'
+const browser = Bowser.getParser(userAgent)
+const browserName = browser.getBrowserName()
+```
+
+Bowser надає ті самі поля: `getBrowserName()`, `getOSName()`, `getPlatform().vendor`. Міграція займає кілька рядків; логіка не змінюється.
+
 ### Заборона `@nitra/as-integrations-fastify`
 
 Пакет **`@nitra/as-integrations-fastify`** заборонений у **`dependencies`**, **`peerDependencies`** та в import-specifier-ах. Це чистий републіш upstream, застряглий на peer `@apollo/server: "^4.0.0"`, тож на Apollo 5 `bun install` дає `warn: incorrect peer dependency`. Заміна — upstream **`@as-integrations/fastify`** (**`^3.1.0`**): peer `@apollo/server: "^4.0.0 || ^5.0.0"` + `fastify: "^5.3.0"`.

package/rules/js/js/dep-policy.mjs

@@ -16,8 +16,17 @@ import {
 
 const JS_SOURCE_RE = /\.(?:[cm]?[jt]sx?)$/u
 
-/** Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі. */
-const BANNED_SPECIFIERS = new Set(['@nitra/as-integrations-fastify'])
+/**
+ * Пакети, заборонені як import-specifier у будь-якому JS/TS-файлі.
+ * Ключ — specifier, значення — підказка про заміну.
+ */
+const BANNED_SPECIFIERS = new Map([
+  ['@nitra/as-integrations-fastify', 'використовуй @as-integrations/fastify'],
+  [
+    'ua-parser-js',
+    'замінити на bowser (MIT, ~6 KB) — npm i bowser. ua-parser-js v2 змінив ліцензію на AGPL-3.0, несумісну з комерційним використанням'
+  ]
+])
 
 /**
  * Витягає з джерела всі import-specifier'и (static + dynamic + require).
@@ -73,11 +82,10 @@ export async function check(cwdParam = process.cwd()) {
     const source = await readFile(absPath, 'utf8')
     const specifiers = extractImportSpecifiers(source, absPath)
     for (const spec of specifiers) {
-      if (BANNED_SPECIFIERS.has(spec)) {
+      const hint = BANNED_SPECIFIERS.get(spec)
+      if (hint !== undefined) {
         const rel = relative(cwd, absPath)
-        reporter.fail(
-          `${rel}: заборонений import '${spec}' — використовуй @as-integrations/fastify (js.mdc dep-policy)`
-        )
+        reporter.fail(`${rel}: заборонений import '${spec}' — ${hint} (js.mdc dep-policy)`)
         violations += 1
       }
     }

package/rules/js/js/docs/dep-policy.md

@@ -3,26 +3,28 @@ type: JS Module
 title: dep-policy.mjs
 resource: npm/rules/js/js/dep-policy.mjs
 docgen:
-  crc: 020620cb
+  crc: a2417b44
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Модуль сканує файли з розширеннями JS/TS у проєкті. Він перевіряє, чи не містять ці файли імпортів, заборонених відповідно до політики (dep-policy.mdc). Модуль виконує перевірку у режимі лише для читання. У разі виявлення порушень, він реєструє їх у звіті. Модуль перехоплює всі можливі помилки (fail-safe) і не генерує винятків назовні. Результат роботи відображається через код виходу, що інформує про статус перевірки (js.mdc).
+## Огляд
+
+Модуль аналізує вміст файлів з розширеннями JS/TS у проєкті. Він перевіряє, чи містять ці файли імпорти, які заборонені відповідно до політики, визначеної в (dep-policy.mdc). При виявленні заборонених специфікаторів, модуль реєструє помилку у звіті та надає рекомендацію щодо заміни, згідно з (js.mdc). Модуль перехоплює всі внутрішні помилки під час сканування, забезпечуючи безпечну роботу.
 
 ## Поведінка
 
 1. Ініціалізує звітність.
 2. Визначає кореневу директорію проєкту.
-3. Завантажує списки шляхів, які слід ігнорувати.
-4. Збирає список усіх файлів з розширеннями JS/TS у кореневій директорії, ігноруючи визначені шляхи.
-5. Для кожного зібраного файлу:
+3. Зчитує списки шляхів, які слід ігнорувати.
+4. Знаходить усі файли з розширеннями JS/TS у кореневій директорії, дотримуючись списку ігнорування.
+5. Для кожного знайденого файлу:
    а. Зчитує вміст файлу.
-   б. Витягує з вмісту всі імпортовані специфікатори (статичні, динамічні та через `require`).
-   в. Для кожного витягнутого специфікатора перевіряє, чи він є забороненим відповідно до політики (dep-policy.mdc).
-   г. Якщо специфікатор заборонений, реєструє помилку у звіті, вказуючи шлях до файлу та заборонений імпорт. Збільшує лічильник порушень.
-6. Якщо порушень не знайдено, реєструє повідомлення про успішну перевірку (js.mdc).
-7. Повертає код виходу звіту.
+   б. Витягує всі імпортовані специфікатори з файлу.
+   в. Перевіряє кожен витягнутий специфікатор на наявність у списку заборонених специфікаторів (dep-policy.mdc).
+   г. Якщо специфікатор заборонений, реєструє помилку у звіті, вказуючи відносний шлях до файлу та підказку про заміну (js.mdc).
+6. Якщо жодних порушень не знайдено, реєструє успішне повідомлення про перевірку.
+7. Повертає код виходу з репортера.
 
 ## Публічний API
 

package/rules/js/js/docs/index.md

@@ -6,10 +6,10 @@ resource: npm/rules/js/js/
 
 # npm/rules/js/js
 
-| Файл                                  | Тип       |
-| ------------------------------------- | --------- |
-| [check.mjs](check.md)                 | JS Module |
-| [dep-policy.mjs](dep-policy.md)       | JS Module |
+| Файл | Тип |
+|---|---|
+| [check.mjs](check.md) | JS Module |
+| [dep-policy.mjs](dep-policy.md) | JS Module |
 | [lint-findings.mjs](lint-findings.md) | JS Module |
-| [tooling.mjs](tooling.md)             | JS Module |
+| [tooling.mjs](tooling.md) | JS Module |
 | [utils_imports.mjs](utils_imports.md) | JS Module |

package/rules/js/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,22 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/js/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Файл застосовує шаблони для виправлення розширень VS Code. Він виконує заміну рядків у розширеннях відповідно до імпортованих шаблонів.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code.
+2. Використовує імпортовані шаблони для виконання логіки виправлення розширень VS Code.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).