@nitra/cursor 12.8.1 → 12.8.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.8.3] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(npm): Перехід з `style-lint` на `style` у правил та конфігах
+
+## [12.8.2] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(docs): Оновлення логіки та формату в документації
+
 ## [12.8.1] - 2026-06-22
 
 ### Changed

package/bin/n-cursor.js

@@ -9,7 +9,7 @@
  *   `npx \@nitra/cursor rename-yaml-extensions` — k8s `*.yml` → `*.yaml`, `.github` `*.yaml` → `*.yml` (опції: `--dry-run`, `--root=…`; див. bin/rename-yaml-extensions.mjs)
  *   `npx \@nitra/cursor post-tool-use-check` — точка входу PostToolUse hook Claude Code: читає stdin JSON,
  *                                     дістає `tool_input.file_path`, маршрутизує його у відповідні правила
- *                                     (`*.mjs` → `js-lint`, `*.vue` → `js-lint style-lint vue` тощо) і викликає
+ *                                     (`*.mjs` → `js-lint`, `*.vue` → `js-lint style vue` тощо) і викликає
  *                                     `fix` лише з ними. Прописується автоматично в `.claude/settings.json`.
  *   `npx \@nitra/cursor lint`        — data-driven оркестратор lint+конформності по `rules/<id>/meta.json` (`lint: per-file|full`):
  *                                     за замовчуванням fix-by-default по дельті vs origin (лише `per-file` правила); `--full` =

package/package.json

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

package/rules/feedback/feedback.mdc

@@ -29,7 +29,7 @@ version: '1.0'
 Кожен пункт — за схемою:
 
 - **target** — `rule` | `skill` | `check`
-- **id** — який саме (`lint`, `text`, `js-lint`, …)
+- **id** — який саме (`lint`, `text`, `js`, …)
 - **kind** — `ambiguous-doc` | `missing-check` | `false-positive` | `no-autofix` | `recurring-pattern`
 - **evidence** — конкретний `файл:рядок` або вивід команди з цього запуску
 - **suggestion** — запропонована зміна
@@ -42,8 +42,8 @@ version: '1.0'
 - skill `n-lint`, `ambiguous-doc` — крок 2 не каже, як діяти при частковому autofix
   evidence: `oxlint --fix` лишив 3 no-autofix-помилки
   suggestion: додати в SKILL.md підпункт про частковий autofix
-- rule `js-lint`, `missing-check` — немає програмної перевірки jscpd-порогу
-  evidence: jscpd впав, але `check js-lint` цього не ловить
+- rule `js`, `missing-check` — немає програмної перевірки jscpd-порогу
+  evidence: jscpd впав, але `check js` цього не ловить
 ```
 
 ## Ефемерність — обовʼязково

package/rules/ga/ga.mdc

@@ -138,4 +138,4 @@ CLI робить preflight на `shellcheck` і `uv` (`uvx`) у `PATH`, поті
 
 **MegaLinter:** не використовувати; прибрати workflow, конфіги (`.mega-linter.yml`, `.megalinter.yaml`, `.mega-linter.yaml`), залежності та згадки в CI / pre-commit / документації.
 
-**`depcheck`:** не використовувати у `.github/workflows/*.yml` — мігровано на `knip` (див. `js-lint.mdc`). Перевірка невикористаних залежностей виконується разом з рештою лінтерів у `lint-js`, окремий крок `npx depcheck` у workflow не потрібен і блокується полісі `ga.workflow_common`.
+**`depcheck`:** не використовувати у `.github/workflows/*.yml` — мігровано на `knip` (див. `js.mdc`). Перевірка невикористаних залежностей виконується разом з рештою лінтерів у `lint-js`, окремий крок `npx depcheck` у workflow не потрібен і блокується полісі `ga.workflow_common`.

package/rules/ga/policy/workflow_common/workflow_common.rego

@@ -34,7 +34,7 @@ forbidden_step_substrings := {
 }
 
 # Заборонені бінарки у `run:` кроках (ga.mdc). `depcheck` мігровано на `knip`
-# у `lint-js.mdc` — окремий крок у workflow не потрібен. Регексп ловить виклики
+# у `js.mdc` — окремий крок у workflow не потрібен. Регексп ловить виклики
 # через `npx`, `bunx`, `npm exec`, або як standalone-команду на початку рядка.
 forbidden_run_command_patterns := {"depcheck": `(?:^|[\s;&|])(?:npx|bunx|npm exec|pnpm exec)?[ \t]*depcheck\b`}
 
@@ -62,7 +62,7 @@ min_uses_version_template := concat(" ", [
 
 forbidden_run_command_template := concat(" ", [
 	"jobs.%s.steps[%d]: `%s` заборонено у workflow —",
-	"мігровано на knip (js-lint.mdc, ga.mdc)",
+	"мігровано на knip (js.mdc, ga.mdc)",
 ])
 
 # ── Аліаси на input ────────────────────────────────────────────────────────
@@ -90,7 +90,7 @@ deny contains msg if {
 
 # ── deny: depcheck у будь-якому `run:` ────────────────────────────────────
 #
-# `depcheck` мігровано на `knip` (js-lint.mdc); `knip` вже запускається у lint-js
+# `depcheck` мігровано на `knip` (js.mdc); `knip` вже запускається у lint-js
 # CI як частина `bunx knip` у скрипті, тож окремий depcheck-крок зайвий і має
 # бути видалений з workflow-файлів.
 

package/rules/js/coverage/coverage.mjs

@@ -1,7 +1,7 @@
 /**
  * JS-провайдер для `n-cursor coverage`: збирає метрики покриття (`vitest run --coverage`)
  * і мутаційного тестування (Stryker з vitest-runner + perTest) для JS/TS коду.
- * Активується через `js-lint` правило в `.n-cursor.json#rules`; реальна applies-логіка
+ * Активується через `js` правило в `.n-cursor.json#rules`; реальна applies-логіка
  * — у `detect(cwd)`.
  *
  * Контракт провайдера — у docs/superpowers/specs/2026-05-24-coverage-rule-design.md.
@@ -42,7 +42,7 @@ export function scopeToRoot(changedFiles, cwd, jsRoot) {
   return out
 }
 const VITEST_HINT =
-  'js-lint coverage: vitest відсутній у package.json — додай `vitest`, `@vitest/coverage-v8` та `@stryker-mutator/vitest-runner` у devDependencies (див. test.mdc)'
+  'js coverage: vitest відсутній у package.json — додай `vitest`, `@vitest/coverage-v8` та `@stryker-mutator/vitest-runner` у devDependencies (див. test.mdc)'
 
 /**
  * Чи у пакеті встановлено vitest (через dependencies або devDependencies).
@@ -334,7 +334,7 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   const mutateSrc = scope ? scope.files.filter(f => !TEST_FILE.test(f)) : null
 
   // 1. Coverage через vitest run --passWithNoTests --coverage (+ --changed у changed-режимі)
-  const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
+  const lcovDir = await mkdtemp(join(tmpdir(), 'js-cov-'))
   let coverage
   try {
     const code = await runner.runJsCoverage(scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir })
@@ -364,7 +364,7 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   const mutationPath = join(jsRoot, 'reports', 'stryker', 'mutation.json')
   if (!existsSync(mutationPath)) {
     throw new Error(
-      'js-lint coverage: stryker не залишив mutation.json — ' +
+      'js coverage: stryker не залишив mutation.json — ' +
         'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
         'або налаштуй його вручну'
     )
@@ -411,7 +411,7 @@ export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
   const changed = Array.isArray(opts.changedFiles)
   const jsRoots = await resolveAllJsRoots(cwd)
-  if (jsRoots.length === 0) throw new Error('js-lint coverage: package.json не знайдено')
+  if (jsRoots.length === 0) throw new Error('js coverage: package.json не знайдено')
 
   const results = []
   for (const jsRoot of jsRoots) {
@@ -429,9 +429,9 @@ export async function collect(cwd, opts = {}) {
     // Changed-режим: нема змінених JS у жодному root → тихо порожньо (це pass, не помилка).
     if (changed) return []
     console.error(
-      'js-lint coverage: жоден workspace не має тестів ' +
+      'js coverage: жоден workspace не має тестів ' +
         '(`*.test.{js,mjs}` у `tests/` або поряд із джерелом) — ' +
-        'додай тести або вилучи `js-lint` з .n-cursor.json#rules'
+        'додай тести або вилучи `js` з .n-cursor.json#rules'
     )
     return []
   }

package/rules/js/docs/fix.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: fix.mjs
-resource: npm/rules/js-lint/fix.mjs
+resource: npm/rules/js/fix.mjs
 docgen:
   crc: 38cf876b
   score: 90

package/rules/js/docs/index.md

@@ -1,10 +1,10 @@
 ---
 type: Directory Index
-title: npm/rules/js-lint
-resource: npm/rules/js-lint/
+title: npm/rules/js
+resource: npm/rules/js/
 ---
 
-# npm/rules/js-lint
+# npm/rules/js
 
 | Файл                | Тип       |
 | ------------------- | --------- |

package/rules/js/docs/main.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: main.mjs
-resource: npm/rules/js-lint/main.mjs
+resource: npm/rules/js/main.mjs
 docgen:
   crc: 4f68b557
   model: omlx/gemma-4-e4b-it-OptiQ-4bit

package/rules/js/js/check.mjs

@@ -24,7 +24,7 @@ async function checkEslintConfig(passFn, failFn, cwd) {
     eslintPath = 'eslint.config.mjs'
     passFn('eslint.config.mjs існує')
   } else {
-    failFn('Відсутній eslint.config.js або eslint.config.mjs — flat config з getConfig (js-lint.mdc)')
+    failFn('Відсутній eslint.config.js або eslint.config.mjs — flat config з getConfig (js.mdc)')
     return
   }
   const eslintRaw = await readFile(join(cwd, eslintPath), 'utf8')
@@ -32,7 +32,7 @@ async function checkEslintConfig(passFn, failFn, cwd) {
     {
       needle: 'getConfig',
       ok: `${eslintPath}: містить getConfig`,
-      err: `${eslintPath}: потрібен виклик getConfig (js-lint.mdc)`
+      err: `${eslintPath}: потрібен виклик getConfig (js.mdc)`
     },
     {
       needle: '@nitra/eslint-config',
@@ -42,7 +42,7 @@ async function checkEslintConfig(passFn, failFn, cwd) {
     {
       needle: '**/auto-imports.d.ts',
       ok: `${eslintPath}: ignores містить **/auto-imports.d.ts`,
-      err: `${eslintPath}: додай у ignores запис **/auto-imports.d.ts (js-lint.mdc)`
+      err: `${eslintPath}: додай у ignores запис **/auto-imports.d.ts (js.mdc)`
     }
   ]
   for (const { needle, ok, err } of checks) {
@@ -71,7 +71,7 @@ function checkPackageJsonTypeModule(label, pkg, passFn, failFn) {
   if (pkg.type === 'module') {
     passFn(`${label}: "type": "module"`)
   } else {
-    failFn(`${label}: має містити "type": "module" (js-lint.mdc)`)
+    failFn(`${label}: має містити "type": "module" (js.mdc)`)
   }
 }
 
@@ -163,7 +163,7 @@ async function checkPackageJsonJsLint(passFn, failFn, cwd) {
 async function checkOxlintRc(passFn, failFn, cwd) {
   const oxPath = join(cwd, '.oxlintrc.json')
   if (!existsSync(oxPath)) {
-    failFn('.oxlintrc.json не існує — додай конфіг oxlint (js-lint.mdc)')
+    failFn('.oxlintrc.json не існує — додай конфіг oxlint (js.mdc)')
     return
   }
   let oxCfg
@@ -204,14 +204,14 @@ async function checkLintJsWorkflows(passFn, failFn, cwd) {
   if (existsSync(join(cwd, '.github/workflows/lint-js.yml'))) {
     passFn('.github/workflows/lint-js.yml є (структуру перевіряє npx @nitra/cursor fix → js_lint.lint_js_yml)')
   } else {
-    failFn('.github/workflows/lint-js.yml не існує — створи його (js-lint.mdc)')
+    failFn('.github/workflows/lint-js.yml не існує — створи його (js.mdc)')
   }
 
   const lintYmlPath = join(cwd, '.github/workflows/lint.yml')
   if (existsSync(lintYmlPath)) {
     const lintYml = await readFile(lintYmlPath, 'utf8')
     if (lintYml.includes('bunx oxlint') && lintYml.includes('bunx eslint') && lintYml.includes('jscpd')) {
-      failFn('.github/workflows/lint.yml дублює кроки lint-js.yml — залиш один workflow на лінт JS (js-lint.mdc)')
+      failFn('.github/workflows/lint.yml дублює кроки lint-js.yml — залиш один workflow на лінт JS (js.mdc)')
     } else {
       passFn('.github/workflows/lint.yml не дублює oxlint/eslint/jscpd з lint-js.yml')
     }
@@ -223,7 +223,7 @@ async function checkLintJsWorkflows(passFn, failFn, cwd) {
  * копіює канонічний `knip-canonical.json` з пакета `@nitra/cursor` як стартовий
  * baseline; зміст подальших модифікацій локально не валідується (`entry` /
  * `project` / `ignore` / `ignoreDependencies` / `ignoreBinaries` дозволені
- * будь-які; це side effect — описано у js-lint.mdc).
+ * будь-які; це side effect — описано у js.mdc).
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  * @param {string} cwd корінь репозиторію
@@ -242,11 +242,11 @@ async function checkKnipConfig(passFn, failFn, cwd) {
     return
   }
   await copyFile(KNIP_CANONICAL_JSON_PATH, knipPath)
-  passFn('knip.json створено з канонічного npm/rules/js-lint/js/data/tooling/knip-canonical.json (js-lint.mdc)')
+  passFn('knip.json створено з канонічного npm/rules/js/js/data/tooling/knip-canonical.json (js.mdc)')
 }
 
 /**
- * Перевіряє відповідність проєкту правилам js-lint.mdc
+ * Перевіряє відповідність проєкту правилам js.mdc
  * @param {string} [cwd] корінь репозиторію
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */

package/rules/js/js/docs/check.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: check.mjs
-resource: npm/rules/js-lint/js/check.mjs
+resource: npm/rules/js/js/check.mjs
 docgen:
   crc: f61768f2
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
@@ -10,7 +10,7 @@ docgen:
 
 ## Огляд
 
-Модуль виконує перевірку конфігураційних файлів проєкту, забезпечуючи їхню відповідність встановленим стандартам. Він читає та аналізує конфігураційні файли, включаючи `package.json`, `.oxlintrc.json`, `knip.json`, `knip-canonical.json` та `.eslintrc.json`. Перевірка ґрунтується на логіці, визначеній у (js-lint.mdc) та (text.mdc). Функціонал реалізований у режимі лише читання, що означає відсутність змін у файловій системі чи базах даних. При виявленні проблем, система перехоплює помилки, працюючи у режимі fail-safe. Свідомо ігноруються шляхи `.github` та `.git`.
+Модуль виконує перевірку конфігураційних файлів проєкту, забезпечуючи їхню відповідність встановленим стандартам. Він читає та аналізує конфігураційні файли, включаючи `package.json`, `.oxlintrc.json`, `knip.json`, `knip-canonical.json` та `.eslintrc.json`. Перевірка ґрунтується на логіці, визначеній у (js.mdc) та (text.mdc). Функціонал реалізований у режимі лише читання, що означає відсутність змін у файловій системі чи базах даних. При виявленні проблем, система перехоплює помилки, працюючи у режимі fail-safe. Свідомо ігноруються шляхи `.github` та `.git`.
 
 ## Поведінка
 
@@ -30,7 +30,7 @@ docgen:
 
 ## Публічний API
 
-check — забезпечує відповідність проєкту вимогам, описаним у js-lint.mdc.
+check — забезпечує відповідність проєкту вимогам, описаним у js.mdc.
 
 ## Гарантії поведінки
 

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

@@ -1,10 +1,10 @@
 ---
 type: Directory Index
-title: npm/rules/js-lint/js
-resource: npm/rules/js-lint/js/
+title: npm/rules/js/js
+resource: npm/rules/js/js/
 ---
 
-# npm/rules/js-lint/js
+# npm/rules/js/js
 
 | Файл                                  | Тип       |
 | ------------------------------------- | --------- |

package/rules/js/js/docs/lint-findings.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: lint-findings.mjs
-resource: npm/rules/js-lint/js/lint-findings.mjs
+resource: npm/rules/js/js/lint-findings.mjs
 docgen:
   crc: bee587da
   score: 100

package/rules/js/js/docs/tooling.md

@@ -1,7 +1,7 @@
 ---
 type: JS Module
 title: tooling.mjs
-resource: npm/rules/js-lint/js/tooling.mjs
+resource: npm/rules/js/js/tooling.mjs
 docgen:
   crc: 7ead48ee
   model: omlx/gemma-4-e4b-it-OptiQ-4bit

package/rules/js/js/docs/utils_imports.md

@@ -1,12 +1,12 @@
 ---
 type: JS Module
 title: utils_imports.mjs
-resource: npm/rules/js-lint/js/utils_imports.mjs
+resource: npm/rules/js/js/utils_imports.mjs
 docgen:
   crc: 7eaeaf96
 ---
 
-Модуль `npm/rules/js-lint/js/utils_imports.mjs` реалізує одну з перевірок правила `js-lint.mdc`: жоден файл усередині будь-якого каталогу з ім'ям `utils/` не має імпортувати щось за межами цього самого каталогу через відносні шляхи з префіксом `..`.
+Модуль `npm/rules/js/js/utils_imports.mjs` реалізує одну з перевірок правила `js.mdc`: жоден файл усередині будь-якого каталогу з ім'ям `utils/` не має імпортувати щось за межами цього самого каталогу через відносні шляхи з префіксом `..`.
 
 Філософія перевірки:
 
@@ -150,7 +150,7 @@ docgen:
 
 ### Інтеграція в перевірочний рантайм
 
-Модуль викликається check-runner-ом правила `js-lint.mdc` (зазвичай із `npm/rules/js-lint/js/`). Runner імпортує named export `check` і чекає на її resolved-значення як на process exit-code. Сам файл **не** має top-level executable коду — лише визначення; це дозволяє безпечно імпортувати його у тестах.
+Модуль викликається check-runner-ом правила `js.mdc` (зазвичай із `npm/rules/js/js/`). Runner імпортує named export `check` і чекає на її resolved-значення як на process exit-code. Сам файл **не** має top-level executable коду — лише визначення; це дозволяє безпечно імпортувати його у тестах.
 
 Типовий виклик (псевдокод):
 
@@ -167,7 +167,7 @@ process.exit(exitCode)
 2. `check()` знаходить `utils/` каталоги в усіх package-roots.
 3. Для кожного non-test source файлу витягає імпорти.
 4. Жоден імпорт не починається з `..`.
-5. `reporter.pass('utils-каталогів: N, перевірено M файлів — domain-bound імпортів немає (js-lint.mdc)')`.
+5. `reporter.pass('utils-каталогів: N, перевірено M файлів — domain-bound імпортів немає (js.mdc)')`.
 6. `getExitCode() → 0`.
 
 ### Сценарій "є порушення"
@@ -175,7 +175,7 @@ process.exit(exitCode)
 1. Знайдено файл `packages/foo/utils/helper.mjs`.
 2. У ньому є `import bar from '../lib/bar.mjs'`.
 3. `PARENT_RELATIVE_RE` матчить `../lib/bar.mjs`.
-4. `reporter.fail('packages/foo/utils/helper.mjs: заборонений імпорт \'../lib/bar.mjs\' — utils/-файли мають бути generic (js-lint.mdc)')`.
+4. `reporter.fail('packages/foo/utils/helper.mjs: заборонений імпорт \'../lib/bar.mjs\' — utils/-файли мають бути generic (js.mdc)')`.
 5. `violations` інкрементується.
 6. По завершенню `getExitCode() → 1`.
 
@@ -183,7 +183,7 @@ process.exit(exitCode)
 
 1. У жодному package немає каталогу `utils/`.
 2. `utilsDirSet.size === 0`.
-3. `reporter.pass('utils-каталогів немає — перевірку пропущено (js-lint.mdc)')`.
+3. `reporter.pass('utils-каталогів немає — перевірку пропущено (js.mdc)')`.
 4. `getExitCode() → 0`.
 
 ### Сценарій "файл із синтаксичною помилкою"
@@ -207,6 +207,6 @@ process.exit(exitCode)
 - **De-duplication** через `Set`: якщо monorepo-структура повертає однаковий `utils/`-шлях двічі (наприклад, `.`-root і назва вкладеного пакета перетинаються), він обробиться лише раз.
 - **Помилки `readdir`** глушаться — недоступний каталог просто пропускається без падіння всієї перевірки.
 
-### Залежність від конвенцій правила `js-lint.mdc`
+### Залежність від конвенцій правила `js.mdc`
 
-Файл є технічною реалізацією одного з пунктів правила `js-lint.mdc`. Усі повідомлення `reporter.pass/fail` посилаються на `(js-lint.mdc)`, щоб користувач знав, де читати про сам принцип розділу `utils/` ↔ `lib/`.
+Файл є технічною реалізацією одного з пунктів правила `js.mdc`. Усі повідомлення `reporter.pass/fail` посилаються на `(js.mdc)`, щоб користувач знав, де читати про сам принцип розділу `utils/` ↔ `lib/`.

package/rules/js/js/tooling.mjs

@@ -141,7 +141,7 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
 
     if (!deepEqualOxlintCanonical(actual, expected)) {
       failures.push(
-        `.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/rules/js-lint/js/data/tooling/oxlint-canonical.json)`
+        `.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/rules/js/js/data/tooling/oxlint-canonical.json)`
       )
     }
   }

package/rules/js/js/utils_imports.mjs

@@ -153,7 +153,7 @@ export async function check() {
     }
   }
   if (utilsDirSet.size === 0) {
-    reporter.pass('utils-каталогів немає — перевірку пропущено (js-lint.mdc)')
+    reporter.pass('utils-каталогів немає — перевірку пропущено (js.mdc)')
     return reporter.getExitCode()
   }
   let violations = 0
@@ -167,7 +167,7 @@ export async function check() {
       for (const src of imports) {
         if (PARENT_RELATIVE_RE.test(src)) {
           const rel = relative(root, file)
-          reporter.fail(`${rel}: заборонений імпорт '${src}' — utils/-файли мають бути generic (js-lint.mdc)`)
+          reporter.fail(`${rel}: заборонений імпорт '${src}' — utils/-файли мають бути generic (js.mdc)`)
           violations += 1
         }
       }
@@ -175,7 +175,7 @@ export async function check() {
   }
   if (violations === 0) {
     reporter.pass(
-      `utils-каталогів: ${utilsDirSet.size}, перевірено ${checkedFiles} файлів — domain-bound імпортів немає (js-lint.mdc)`
+      `utils-каталогів: ${utilsDirSet.size}, перевірено ${checkedFiles} файлів — domain-bound імпортів немає (js.mdc)`
     )
   }
   return reporter.getExitCode()

package/rules/js/js.mdc

@@ -5,7 +5,7 @@ alwaysApply: false
 version: '1.30'
 ---
 
-**oxlint**, **ESLint**, **jscpd**, **knip**. Запуск — **`n-cursor lint js-lint js-lint-ci`** (локально; у CI — `--read-only`, без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config`** — версія не нижче канонічного мінімуму зі snippet нижче (semver-поріг, єдине джерело істини) (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint). Dependency-політику CI-етапу (`@e18e/eslint-plugin` і oxlint/eslint/jscpd/knip окремо не додавати) винесено в `js-lint-ci`.
+**oxlint**, **ESLint**, **jscpd**, **knip**. Запуск — **`n-cursor lint js`** (локально; у CI — `--read-only`, без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config`** — версія не нижче канонічного мінімуму зі snippet нижче (semver-поріг, єдине джерело істини) (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint). Dependency-політика CI-етапу: `@e18e/eslint-plugin` і oxlint/eslint/jscpd/knip окремо не додавати.
 
 У кожному **`package.json`** проєкту (корінь і всі workspace-пакети) має бути **`"type": "module"`** — весь код у ESM.
 
@@ -18,7 +18,7 @@ version: '1.30'
 }
 ```
 
-Канон `type` і мінімальна `@nitra/eslint-config` (semver-поріг `devDependencies`): [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json). Окремого `lint-js` скрипта немає — лінт через **`n-cursor lint js-lint js-lint-ci`** (CI — `--read-only`).
+Канон `type` і мінімальна `@nitra/eslint-config` (semver-поріг `devDependencies`): [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json). Окремого `lint-js` скрипта немає — лінт через **`n-cursor lint js`** (CI — `--read-only`).
 
 ## Розширення нових файлів — `.mjs` / `.cjs`, не `.js`
 
@@ -35,7 +35,7 @@ version: '1.30'
 
 У `.vscode/extensions.json` `recommendations` мають містити `dbaeumer.vscode-eslint`, `github.vscode-github-actions`, `oxc.oxc-vscode`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
 
-У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/rules/js-lint/js/data/tooling/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Канон **`oxlint-canonical.json`** — source-of-truth, редагується напряму; у споживачі оновлюється копіюванням файлу з репозиторію пакета. Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
+У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/rules/js/js/data/tooling/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Канон **`oxlint-canonical.json`** — source-of-truth, редагується напряму; у споживачі оновлюється копіюванням файлу з репозиторію пакета. Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
 
 Мінімум для розуміння структури (реальний корінь конфігу має збігатися з каноном повністю):
 
@@ -70,9 +70,33 @@ version: '1.30'
 .claude/worktrees/
 ```
 
+## Залежнісна політика (що не додавати)
+
+`@e18e/eslint-plugin` окремо не додавай — він уже в залежностях `@nitra/eslint-config` (з **3.8.0**), oxlint підвантажує його з `node_modules`. Пакети oxlint/eslint/jscpd/knip теж не додавай у `devDependencies` без потреби монорепо — `bunx` тягне їх ad-hoc.
+
 ## knip
 
-Залежнісний аналіз (knip — невикористані залежності/експорти, `knip.json` канон) крос-файловий, тож винесений у правило `js-lint-ci` (`lint: full`). Див. `js-lint-ci`.
+Залежнісний аналіз (knip — невикористані залежності/експорти, `knip.json` канон) крос-файловий; запускається автоматично у `lint --full` разом з jscpd.
+
+У корені проєкту має бути **`knip.json`**, який стартує з канонічного baseline з пакета `@nitra/cursor` — файл [`npm/rules/js/js/tooling/knip-canonical.json`](./js/tooling/knip-canonical.json). Він покриває типові false-positives для наших правил: `entry` зі CLI-конфігами (eslint, stylelint, oxlint, jscpd, markdownlint-cli2, `commitlint`), `project` для `**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts}`, `ignore` для `**/__fixtures__/**`, `ignoreDependencies` для пакетів, посилання на які є лише в не-JS-конфігах (`@nitra/cspell-dict`, `/@cspell\/dict-.+/`, `graphql`), і `ignoreBinaries` для CLI, які канон вимагає викликати через `npx`/`bunx` і яких заборонено додавати в `devDependencies` (`actionlint`, `cspell`, `eslint`, `git-ai`, `jscpd`, `markdownlint-cli2`, `oxfmt`, `oxlint`, `shellcheck`, `uvx`, `v8r`, `zizmor`).
+
+Якщо `knip.json` відсутній — `npx @nitra/cursor fix js` копіює канон у корінь проєкту (side effect). Після створення модифікуй файл під свій проєкт як завгодно: перевіряємо лише наявність, зміст подальших змін не валідується.
+
+Пакет `knip` окремо в `devDependencies` не додавай — `bunx knip` тягне його ad-hoc, як oxlint/eslint/jscpd.
+
+## Заборона `@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"`.
+
+Міграція — лише specifier у трьох місцях: залежність у `package.json`, `import`, та `vi.mock(...)` / `await import(...)` у тестах. **Код не міняється**, експорти ті самі: `default` → `fastifyApollo`, named → `fastifyApolloDrainPlugin`.
+
+```javascript title="❌ до"
+import fastifyApollo, { fastifyApolloDrainPlugin } from '@nitra/as-integrations-fastify'
+```
+
+```javascript title="✅ після"
+import fastifyApollo, { fastifyApolloDrainPlugin } from '@as-integrations/fastify'
+```
 
 ## jscpd: рефакторинг і структура
 
@@ -95,7 +119,7 @@ version: '1.30'
 
 Швидкий тест: якщо файл завтра можна опублікувати окремим npm-пакетом без переписування — це `utils/`; якщо він тримає domain-state, читає конфіг проєкту або викликає зовнішні сервіси/файли — це `lib/`. Не плутай із чужими каталогами на кшталт `shared/` чи `common/`: канонічні назви — лише `utils/` і `lib/`.
 
-Автоматично гарантується: `npx @nitra/cursor fix js-lint` (концерн `utils_imports`) обходить кожен `utils/`-каталог у воркспейсах і падає, якщо знаходить relative-імпорт з `..` (вихід за межі каталогу) у будь-якому не-тестовому файлі. Це механічне втілення правила «utils не знає про домен»: тільки same-dir (`./X`), bare-пакети та `node:*` дозволені; cross-rule, конфіги проєкту чи sibling-utils — fail. Якщо потрібна domain-залежність — перенеси файл у `lib/`.
+Автоматично гарантується: `npx @nitra/cursor fix js` (концерн `utils_imports`) обходить кожен `utils/`-каталог у воркспейсах і падає, якщо знаходить relative-імпорт з `..` (вихід за межі каталогу) у будь-якому не-тестовому файлі. Це механічне втілення правила «utils не знає про домен»: тільки same-dir (`./X`), bare-пакети та `node:*` дозволені; cross-rule, конфіги проєкту чи sibling-utils — fail. Якщо потрібна domain-залежність — перенеси файл у `lib/`.
 
 Додай workflow:
 
@@ -209,4 +233,4 @@ for (const item of arr) {
 
 ## Покриття + мутаційне тестування JS
 
-Покриття + мутаційне тестування JS постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/js-lint/coverage/coverage.mjs`: `bun test --coverage --coverage-reporter=lcov` + `bunx stryker run`. Stryker конфігурується в `stryker.config.mjs` у JS-корені (single-package або `workspaces[0]`).
+Покриття + мутаційне тестування JS постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/js/coverage/coverage.mjs`: `bun test --coverage --coverage-reporter=lcov` + `bunx stryker run`. Stryker конфігурується в `stryker.config.mjs` у JS-корені (single-package або `workspaces[0]`).

package/rules/js/main.mjs

@@ -77,6 +77,20 @@ function lintFullProject(cwd, readOnly) {
   return runInherit(readOnly ? ['eslint', '.'] : ['eslint', '--fix', '.'], cwd)
 }
 
+/**
+ * Крос-файловий аналіз: jscpd (дублікати) + knip (невикористані залежності/експорти).
+ * Ігнорує `files` — завжди по всьому репо.
+ * @param {string} cwd корінь репо
+ * @returns {number} exit code
+ */
+function lintFullCi(cwd) {
+  const jscpd = spawnSync('bunx', ['jscpd', '.'], { cwd, stdio: 'inherit' })
+  const jc = typeof jscpd.status === 'number' ? jscpd.status : 1
+  if (jc !== 0) return jc
+  const knip = spawnSync('bunx', ['knip', '--no-config-hints'], { cwd, stdio: 'inherit' })
+  return typeof knip.status === 'number' ? knip.status : 1
+}
+
 /**
  * Quick-режим: авто-фікс змінених файлів, тоді класифікація лишених findings
  * на introduced / pre-existing (беклог #6/A). Блокування на будь-якому finding.
@@ -102,7 +116,7 @@ function lintChangedClassified(js, cwd, readOnly) {
   // Краш інструмента (ненульовий exit + непарсабельний json) НЕ можна тихо пропустити
   // як «чисто» — це регресія проти старого fail-fast. Фейлимо явно.
   if ((ox === null && oxRes.status !== 0) || (es === null && esRes.status !== 0)) {
-    process.stderr.write('❌ js-lint: інструмент завершився з помилкою (не lint-порушення) — json не розпарсено\n')
+    process.stderr.write('❌ js: інструмент завершився з помилкою (не lint-порушення) — json не розпарсено\n')
     return 1
   }
 
@@ -110,13 +124,14 @@ function lintChangedClassified(js, cwd, readOnly) {
   if (findings.length === 0) return 0
 
   const classified = classifyFindings(findings, addedLinesByFile(js, cwd), cwd)
-  const header = `❌ js-lint: ${findings.length} порушень (introduced ${classified.introduced.length}, pre-existing ${classified.preExisting.length})`
+  const header = `❌ js: ${findings.length} порушень (introduced ${classified.introduced.length}, pre-existing ${classified.preExisting.length})`
   process.stdout.write(`${header}\n${renderFindings(classified, cwd)}\n`)
   return 1
 }
 
 /**
- * Запускає oxlint+eslint. За замовчуванням — з автофіксом; `opts.readOnly` — лише детект.
+ * Запускає oxlint+eslint (per-file або full) + jscpd+knip (лише full).
+ * За замовчуванням — з автофіксом; `opts.readOnly` — лише детект.
  * @param {string[] | undefined} files per-file: лише ці файли; undefined: весь проєкт (--full)
  * @param {string} [cwd] корінь репо
  * @param {{ readOnly?: boolean }} [opts] readOnly → без `--fix` (нуль мутацій)
@@ -125,7 +140,9 @@ function lintChangedClassified(js, cwd, readOnly) {
 export function lint(files, cwd = process.cwd(), opts = {}) {
   const readOnly = opts.readOnly === true
   if (files === undefined) {
-    return Promise.resolve(lintFullProject(cwd, readOnly))
+    const esCode = lintFullProject(cwd, readOnly)
+    if (esCode !== 0) return Promise.resolve(esCode)
+    return Promise.resolve(lintFullCi(cwd))
   }
   const js = filterJsFiles(files)
   if (js.length === 0) return Promise.resolve(0)
@@ -133,6 +150,6 @@ export function lint(files, cwd = process.cwd(), opts = {}) {
 }
 
 if (isRunAsCli(import.meta.url)) {
-  // Standalone: bun rules/js-lint/main.mjs — повний еквівалент `npx @nitra/cursor check js-lint`.
+  // Standalone: bun rules/js/main.mjs — повний еквівалент `npx @nitra/cursor check js`.
   process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/js/policy/jscpd/jscpd.rego

@@ -1,4 +1,4 @@
-# Перевірка `.jscpd.json` (js-lint.mdc).
+# Перевірка `.jscpd.json` (js.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/.jscpd.json.snippet.json.
@@ -17,7 +17,7 @@ deny contains msg if {
 	not is_array(expected_value)
 	actual := object.get(input, key, null)
 	actual != expected_value
-	msg := sprintf(".jscpd.json має містити \"%s\": %v (js-lint.mdc)", [key, expected_value])
+	msg := sprintf(".jscpd.json має містити \"%s\": %v (js.mdc)", [key, expected_value])
 }
 
 # Array subset-of для reporters.
@@ -27,7 +27,7 @@ deny contains msg if {
 	actual_set := {v | some v in object.get(input, field, [])}
 	some required in expected_values
 	not required in actual_set
-	msg := sprintf(".jscpd.json має містити \"%s\": [\"%s\"] (js-lint.mdc)", [field, required])
+	msg := sprintf(".jscpd.json має містити \"%s\": [\"%s\"] (js.mdc)", [field, required])
 }
 
 # minLines: must be number and >= expected.
@@ -35,7 +35,7 @@ deny contains msg if {
 	expected := data.template.snippet.minLines
 	actual := object.get(input, "minLines", null)
 	not is_valid_min_lines(actual, expected)
-	msg := sprintf(".jscpd.json має містити \"minLines\" як число >= %d (js-lint.mdc)", [expected])
+	msg := sprintf(".jscpd.json має містити \"minLines\" як число >= %d (js.mdc)", [expected])
 }
 
 is_valid_min_lines(actual, expected) if {

package/rules/js/policy/jscpd/target.json

@@ -4,5 +4,5 @@
     "single": ".jscpd.json",
     "required": true
   },
-  "missingMessage": ".jscpd.json не існує — створи з полями згідно js-lint.mdc"
+  "missingMessage": ".jscpd.json не існує — створи з полями згідно js.mdc"
 }