@nitra/cursor 12.8.0 → 12.8.2

package/rules/{js-lint → 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-lint → 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-lint → 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-lint/js-lint.mdc → 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-lint → 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-lint → 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-lint → 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"
 }

package/rules/{js-lint → js}/policy/lint_js_yml/lint_js_yml.rego

@@ -1,4 +1,4 @@
-# Перевірка `.github/workflows/lint-js.yml` (js-lint.mdc).
+# Перевірка `.github/workflows/lint-js.yml` (js.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/lint-js.yml.snippet.yml.
@@ -50,7 +50,7 @@ all_run_blob := concat("\n", [r |
 deny contains msg if {
 	some required_use in expected_uses_set
 	not contains(all_uses_blob, required_use)
-	msg := sprintf("lint-js.yml: відсутній крок uses: %s (js-lint.mdc)", [required_use])
+	msg := sprintf("lint-js.yml: відсутній крок uses: %s (js.mdc)", [required_use])
 }
 
 # ── deny: required run substrings ───────────────────────────────────────
@@ -58,26 +58,26 @@ deny contains msg if {
 deny contains msg if {
 	some required_run in expected_run_substrings
 	not contains(all_run_blob, required_run)
-	msg := sprintf("lint-js.yml: у run немає %q (js-lint.mdc)", [required_run])
+	msg := sprintf("lint-js.yml: у run немає %q (js.mdc)", [required_run])
 }
 
 # ── deny: actions/checkout@v6 has persist-credentials: false (inverse) ──
 
 deny contains msg if {
 	not has_checkout_persist_credentials_false
-	msg := "lint-js.yml: actions/checkout@v6 має бути з with.persist-credentials: false (js-lint.mdc)"
+	msg := "lint-js.yml: actions/checkout@v6 має бути з with.persist-credentials: false (js.mdc)"
 }
 
 # ── deny: --fix у CI заборонено (inverse) ───────────────────────────────
 
 deny contains msg if {
 	regex.match(`bunx\s+oxlint[^\n]*--fix`, all_run_blob)
-	msg := "lint-js.yml: у run є oxlint з `--fix` (у CI заборонено) (js-lint.mdc)"
+	msg := "lint-js.yml: у run є oxlint з `--fix` (у CI заборонено) (js.mdc)"
 }
 
 deny contains msg if {
 	contains(all_run_blob, "eslint --fix")
-	msg := "lint-js.yml: у run є `eslint --fix` (у CI заборонено) (js-lint.mdc)"
+	msg := "lint-js.yml: у run є `eslint --fix` (у CI заборонено) (js.mdc)"
 }
 
 # ── helpers ─────────────────────────────────────────────────────────────

package/rules/{js-lint → js}/policy/lint_js_yml/template/lint-js.yml.snippet.yml

@@ -37,4 +37,4 @@ jobs:
       - uses: ./.github/actions/setup-bun-deps
 
       - name: Eslint
-        run: n-cursor lint js-lint js-lint-ci --read-only
+        run: n-cursor lint js --read-only

package/rules/{js-lint → js}/policy/package_json/package_json.rego

@@ -1,4 +1,4 @@
-# Перевірка `package.json` (js-lint.mdc).
+# Перевірка `package.json` (js.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/package.json.snippet.json
@@ -20,7 +20,7 @@ deny contains msg if {
 	not is_object(expected_value)
 	actual := object.get(input, key, null)
 	actual != expected_value
-	msg := sprintf("package.json: \"%s\" має бути %q (js-lint.mdc)", [key, expected_value])
+	msg := sprintf("package.json: \"%s\" має бути %q (js.mdc)", [key, expected_value])
 }
 
 # ── deny: scripts (nested) — exact match із normalize ──────────────────
@@ -29,7 +29,7 @@ deny contains msg if {
 	some script_name, expected in data.template.snippet.scripts
 	actual := object.get(object.get(input, "scripts", {}), script_name, "")
 	normalize_script(actual) != expected
-	msg := sprintf("package.json: scripts.%s має бути %q (js-lint.mdc)", [script_name, expected])
+	msg := sprintf("package.json: scripts.%s має бути %q (js.mdc)", [script_name, expected])
 }
 
 # ── deny: engines.node >= 24 (inverse, у rego) ──────────────────────────
@@ -37,13 +37,13 @@ deny contains msg if {
 deny contains msg if {
 	engines := object.get(input, "engines", {})
 	not engines_node_meets(object.get(engines, "node", ""))
-	msg := "package.json: engines.node має бути >= 24 (js-lint.mdc)"
+	msg := "package.json: engines.node має бути >= 24 (js.mdc)"
 }
 
 deny contains msg if {
 	engines := object.get(input, "engines", {})
 	not engines_bun_meets(object.get(engines, "bun", ""))
-	msg := "package.json: engines.bun має бути >= 1.3 (js-lint.mdc)"
+	msg := "package.json: engines.bun має бути >= 1.3 (js.mdc)"
 }
 
 # ── deny: @nitra/eslint-config >= snippet-поріг ─────────────────────────
@@ -51,14 +51,14 @@ deny contains msg if {
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
 	not "@nitra/eslint-config" in object.keys(dev)
-	msg := "package.json: відсутній @nitra/eslint-config у devDependencies (js-lint.mdc)"
+	msg := "package.json: відсутній @nitra/eslint-config у devDependencies (js.mdc)"
 }
 
 deny contains msg if {
 	range := object.get(object.get(input, "devDependencies", {}), "@nitra/eslint-config", "")
 	range != ""
 	not eslint_config_meets_min(range)
-	msg := sprintf("package.json: @nitra/eslint-config має бути >= %s (зараз %q) (js-lint.mdc)", [eslint_min_display, range])
+	msg := sprintf("package.json: @nitra/eslint-config має бути >= %s (зараз %q) (js.mdc)", [eslint_min_display, range])
 }
 
 # ── helpers ──────────────────────────────────────────────────────────────

package/rules/{js-lint → js}/policy/vscode_extensions/target.json

@@ -4,5 +4,5 @@
     "single": ".vscode/extensions.json",
     "required": true
   },
-  "missingMessage": ".vscode/extensions.json не існує — додай recommendations з js-lint.mdc"
+  "missingMessage": ".vscode/extensions.json не існує — додай recommendations з js.mdc"
 }

package/rules/{js-lint → js}/policy/vscode_extensions/vscode_extensions.rego

@@ -1,4 +1,4 @@
-# Перевірка `.vscode/extensions.json` для js-lint (js-lint.mdc).
+# Перевірка `.vscode/extensions.json` для js (js.mdc).
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 package js_lint.vscode_extensions
@@ -8,5 +8,5 @@ import rego.v1
 deny contains msg if {
 	some rec in data.template.snippet.recommendations
 	not rec in {r | some r in object.get(input, "recommendations", [])}
-	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (js-lint.mdc)", [rec])
+	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (js.mdc)", [rec])
 }

package/rules/js-run/lib/docs/conn-file-rules.md

@@ -29,7 +29,7 @@ docgen:
 
 ## Експорти / API
 
-Модуль експортує тільки named-exports (узгоджено з `n-js-lint` / `js-run.mdc`):
+Модуль експортує тільки named-exports (узгоджено з `n-js` / `js-run.mdc`):
 
 | Експорт                                                  | Тип                               | Призначення                                                                                       |
 | -------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------- |

package/rules/npm-module/js/docs/header_doc_pointer.md

@@ -3,28 +3,38 @@ type: JS Module
 title: header_doc_pointer.mjs
 resource: npm/rules/npm-module/js/header_doc_pointer.mjs
 docgen:
-  crc: d96a2957
+  crc: 90fc46dc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Файл виконує перевірку документації для модулів. Сканує директорії npm/rules та npm/skills. Перевіряє наявність файлів docs/<stem>.md у піддиректоріях правил/скілів. Перевіряє, чи містить відповідні js-файли не більше одного рядка JSDoc. У разі перевищення ліміту, генерує звіт про порушення.
+## Огляд
+
+Модуль валідує відповідність контракту документації для файлів `.mjs` у сегментах `npm/rules` та `npm/skills`. Він виявляє порушення, якщо для файлу `.mjs` існує відповідний файл `docs/<ім'я>.md`, а його JSDoc-блок містить більше одного непорожнього рядка.
 
 ## Поведінка
 
-1. Сканувати директорії npm/rules та npm/skills.
-2. Для кожної директорії перевіряти піддиректорії правил/скілів.
-3. Для кожного знайденого js-файлу перевіряти наявність файлу docs/<stem>.md.
-4. Якщо файл docs/<stem>.md існує, перевіряти, чи містить module-level JSDoc не більше одного непорожного рядка.
-5. У разі перевищення ліміту, зарепортувати порушення.
-6. Повертати код виходу репортера.
+1. Викликається функція check з корінням репозиторію як аргументом.
+2. Ініціалізується репортер для фіксації порушень.
+3. Для кожного з сегментів 'npm/rules' та 'npm/skills' виконується наступне:
+   а. Перевіряється існування відповідного базового сегмента.
+   б. Для кожного підсегмента (правила/скіла) у базовому сегменті:
+   i. Перевіряється існування каталогу `js/` у підсегменті.
+   ii. Для кожного файлу `.mjs` у каталозі `js/`:
+   а. Перевіряється, чи є файл звичайним вихідним файлом (не тест).
+   б. Визначається ім'я без розширення файлу.
+   в. Перевіряється існування файлу `docs/<ім'я>.md` у каталозі `js/docs/`.
+   г. Якщо файл `docs/<ім'я>.md` існує:
+   i. Зчитується вміст файлу `.mjs`.
+   ii. Визначається перша не-жадібна JSDoc-блока в файлі.
+   iii. Підраховується кількість непорожніх рядків у тілі цього JSDoc-блока.
+   iv. Якщо кількість непорожніх рядків перевищує 1, фіксується порушення, оскільки `docs/<ім'я>.md` вже описує поведінку, а JSDoc має бути лише вказівником.
+4. Повертається код виходу репортера.
 
 ## Публічний API
 
-- check — сканує файли `npm/rules/*/js/*.mjs` та `npm/skills/*/js/*.mjs`.
-  - Якщо існує `docs/<stem>.md`, модуль повинен мати посилання на JSDoc (не наратив).
-  - Якщо `docs` відсутній, обмеження не застосовуються.
+check — перевіряє файли `.mjs` у директоріях `npm/rules/*\/js/` та `npm/skills/*\/js/`. Якщо поруч є відповідний файл `docs/<stem>.md`, вимагає, щоб JSDoc на рівні модуля був посиланням (не описом); якщо `docs` відсутній, обмежень немає.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/python/docs/main.md

@@ -3,28 +3,28 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/main.mjs
 docgen:
-  crc: 8ceba96a
+  crc: d8a3aa1f
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 90
 ---
 
 ## Огляд
 
-Виконує логіку `lint-python` за правилом `python.mdc` для забезпечення якості коду Python. Якщо файл `pyproject.toml` відсутній у корені, виконання завершується з кодом 0. Якщо файл присутній, але `uv` не знайдено у системному шляху, це вважається помилкою, оскільки `uv` є єдиним дозволеним пакет-менеджером (без Poetry). Для роботи необхідно виконати `uv lock --check` для підтвердження актуальності файлу блокування та `uv sync --frozen` для створення середовища, що відповідає `uv.lock` (детальніше про `uv` на https://docs.astral.sh/uv/). Опціональні лінтери запускаються лише за умови їх доступності через `uv run`. Запускаються `ruff` у режимі автоматичного виправлення (`--fix`) та форматування, а також `mypy` для статичного аналізу коду, використовуючи канонічний патерн серіалізації через `runStandardLint`.
+Реалізує логіку запуску `lint-python` за правилом `python.mdc` на базі [uv](https://docs.astral.sh/uv/). Якщо `pyproject.toml` у корені відсутній, процес завершується з кодом виходу 0. Якщо файл присутній, але інструмент `uv` не знайдено в PATH, це розглядається як помилка. Обов'язкові кроки включають перевірку актуальності lock-файлу (`uv lock --check`) та синхронізацію середовища (`uv sync --frozen`). Опційні лінтери (`ruff`, `mypy`) запускаються лише за умови їх доступності через `uv run`. `ruff` виконується у режимі автоматичного виправлення (`--fix`) для мутації робочого дерева та для форматування. Цей підхід відповідає канону патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`).
 
 ## Поведінка
 
-run виконує стандартну перевірку на основі контексту.
-runLintPythonSteps виконує послідовність кроків лінтування Python, включаючи перевірку `pyproject.toml`, виконання `uv lock --check` та `uv sync --frozen`, а також запуск опціональних лінтерів (`ruff`, `mypy`) через `uv run`.
-runLintPython запускає послідовність кроків лінтування Python, використовуючи механізм стандартного лінтування.
-lint оркеструє запуск `runLintPython` для аналізу всього проєкту.
+run виконує стандартну перевірку для правила, використовуючи контекст прогону.
+runLintPythonSteps виконує послідовність кроків лінтування Python, перевіряючи наявність `pyproject.toml` та виконуючи команди `uv lock --check` та `uv sync --frozen`, а також запускаючи опціональні лінтери (`ruff`, `mypy`) через `uv run` на базі https://docs.astral.sh/uv/.
+runLintPython запускає послідовність кроків лінтування Python, серіалізуючи її через стандартний механізм перевірки.
+lint делегує виклик до `runLintPython`, забезпечуючи можливість запуску в режимі, що не мутує робоче дерево.
 
 ## Публічний API
 
-run — Основна точка входу для виконання правил, що включає перевірку логіки застосування (JS-concerns → policy → mdc-refs) та виконання лінтингу.
-runLintPythonSteps — Виконує внутрішні етапи лінтингу для Python без збереження логів.
-runLintPython — Публічний інтерфейс для запуску лінтингу Python, що забезпечує унікальність виконання через блокування та аналіз стану репозиторію.
-lint — Координатор, який ініціює запуск лінтингу Python, делегуючи це `runLintPython`.
+run — Основна точка входу для виконання правил, яка перевіряє логіку застосування (JS-занепокложення $\rightarrow$ політика $\rightarrow$ mdc-посилання) та запускає перевірку коду (uv/ruff/mypy).
+runLintPythonSteps — Виконує внутрішні етапи перевірки Python-коду без збереження логу.
+runLintPython — Публічний інтерфейс для запуску перевірки Python-коду, який гарантує унікальність виконання через блокування та аналіз стану Git-дерева.
+lint — Адаптер, що керує запуском перевірки Python-коду, делегуючи цю роботу `runLintPython`.
 
 ## Гарантії поведінки
 

package/rules/rust/docs/main.md

@@ -3,24 +3,24 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rust/main.mjs
 docgen:
-  crc: a3060168
+  crc: 93c44fd7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 90
+  score: 100
 ---
 
 ## Огляд
 
-Модуль надає функції для роботи з кодом Rust. Функція `run` виконує повний аналіз коду, включаючи перевірку відповідності політиці MDC. Функція `lint` здійснює статичний аналіз коду. Обидві функції можуть ініціювати форматування та аналіз за допомогою `cargo`.
+Модуль надає інструменти для забезпечення якості коду Rust. Він дозволяє виконати перевірку коду на відповідність заданим Lint-правилам або запустити повну оркестрацію форматування та аналізу коду через `cargo`. Функціонал реалізується через публічні функції `run` та `lint`.
 
 ## Поведінка
 
-run виконує перевірку коду Rust, застосовуючи політику та посилання MDC.
-lint запускає оркестрацію перевірки Rust, виконуючи `rustfmt` та `clippy` через `cargo`.
+run виконує перевірку коду Rust відповідно до політик.
+lint запускає оркестрацію перевірки коду Rust, використовуючи `cargo` для виконання `rustfmt` та `clippy`.
 
 ## Публічний API
 
-run — точка входу для виконання правила, що перевіряє логіку, пов'язану з JS-зацікавленостями, політикою та посиланнями MDC.
-lint — точка входу для запуску лінтера Rust-коду.
+run — виконує основну логіку правила, включаючи перевірку аспектів застосування, логіки та посилань.
+lint — забезпечує точку входу для статичного аналізу коду Rust.
 
 ## Гарантії поведінки
 

package/rules/style-lint/js/tooling.mjs

@@ -6,7 +6,7 @@ import { join } from 'node:path'
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 
 // Зовнішні файли конфігу stylelint, які підхоплює cosmiconfig. Канон нових
-// JS-конфігів — `.mjs`/`.cjs` (js-lint.mdc), legacy `.js` лишається валідним.
+// JS-конфігів — `.mjs`/`.cjs` (js.mdc), legacy `.js` лишається валідним.
 const STYLELINT_CONFIG_FILES = [
   '.stylelintrc.json',
   '.stylelintrc.js',

package/rules/test/js/docs/stryker_config.md

@@ -11,7 +11,7 @@ docgen:
 
 ## Поведінка
 
-1. Перевірити наявність `js-lint` у конфігурації.
+1. Перевірити наявність `js` у конфігурації.
 2. Зібрати кореневі пакети.
 3. Перевірити наявність базових конфігурацій.
 4. Перевірити наявність базлайн-файлів.