@nitra/cursor 12.8.0 → 12.8.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.8.2] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(docs): Оновлення логіки та формату в документації
+
+## [12.8.1] - 2026-06-22
+
+### Changed
+
+- ♻️ refactor(docs): Оновлення логіки та формату в документації
+
 ## [12.8.0] - 2026-06-21
 
 ### Added

package/package.json

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

package/rules/doc-files/js/docgen-scan.mjs

@@ -115,9 +115,11 @@ export function scanOrphanedDocs(root) {
     }
   }
 
-  /** Обходить дерево, шукаючи docs/-директорії для orphan-перевірки.
+  /**
+   * Обходить дерево, шукаючи docs/-директорії для orphan-перевірки.
    *  docs/ — входимо завжди (батьківська пройшла ignore-перевірку);
-   *  інші — перевіряємо через isDocgenIgnored. */
+   *  інші — перевіряємо через isDocgenIgnored.
+   */
   function walk(dir) {
     let entries
     try {

package/rules/doc-files/js/docs/docgen-extract.md

@@ -17,17 +17,17 @@ docgen:
 1. Витягує факт-лист з вмісту файлу.
 2. Визначає мову файлу за розширенням.
 3. Якщо мова — Rust, виконує аналіз Rust-коду:
-    а. Витягує модульний заголовок (`//!`).
-    б. Визначає публічні експорти (структури, функції, класи), виходячи з префіксів `pub` та атрибутів експозиції.
-    в. Визначає локальні (приватні) символи, які не є публічними.
-    г. Класифікує імпорти (`use`) як стандартні, зовнішні чи внутрішні.
-    д. Визначає поведінкові маркери (наприклад, чи є код лише для читання, чи обробляє помилки).
+   а. Витягує модульний заголовок (`//!`).
+   б. Визначає публічні експорти (структури, функції, класи), виходячи з префіксів `pub` та атрибутів експозиції.
+   в. Визначає локальні (приватні) символи, які не є публічними.
+   г. Класифікує імпорти (`use`) як стандартні, зовнішні чи внутрішні.
+   д. Визначає поведінкові маркери (наприклад, чи є код лише для читання, чи обробляє помилки).
 4. Якщо мова — JavaScript/TypeScript/MJS, виконує аналіз JS-коду:
-    а. Витягує заголовок файлу.
-    б. Визначає публічні експорти з їхнім JSDoc.
-    в. Класифікує імпорти як стандартні, npm або внутрішні.
-    г. Визначає локальні символи (службові функції).
-    д. Визначає поведінкові маркери (наприклад, чи є код лише для читання, чи звертається до мережі).
+   а. Витягує заголовок файлу.
+   б. Визначає публічні експорти з їхнім JSDoc.
+   в. Класифікує імпорти як стандартні, npm або внутрішні.
+   г. Визначає локальні символи (службові функції).
+   д. Визначає поведінкові маркери (наприклад, чи є код лише для читання, чи звертається до мережі).
 5. Усі аналізи свідомо ігнорують шляхи: `.github`, `.git`, `node_modules`, `base/`, `ua/`, `.firebase`.
 6. Повертає структуру фактів, що містить інформацію про файл.
 

package/rules/doc-files/js/docs/docgen-judge-measure.md

@@ -10,21 +10,21 @@ docgen:
 
 ## Огляд
 
-Модуль обробляє файли, витягуючи їхній зміст для генерації документації. Він порівнює цю документацію з оцінками сильної модільної системи. Під час роботи відбувається кешування у межах прогону. Модуль збирає метрики якості згенерованої документації та зберігає фінальний звіт у `report.json`, який спирається на конфігурації, визначені в `report.json`.
+Файл аналізує надані файли коду, створюючи документацію та оцінюючи її якість відповідно до конфігурації, що міститься у report.json. Процес збирає результати для кожного файлу, використовуючи кешування у межах прогону на основі вмісту джерела та вже згенерованої документації. У кінці процес агрегує дані та зберігає повний звіт у report.json, а також виводить його у консоль.
 
 ## Поведінка
 
 1. Зчитує список файлів для аналізу з аргументів командного рядка.
 2. Для кожного файлу зчитує його вміст.
-3. Генерує документацію для файлу, використовуючи кеш за вмістом джерела.
-4. Якщо документація згенерована, перевіряє її якість за встановленим порогом.
-5. Якщо якість документації відповідає порогу, передає вміст джерела та згенеровану документацію для оцінки сильною моделлю.
-6. Оцінювач повертає вердикт (точний, загальний, неточний) з обґрунтуванням.
-7. Зберігає результати для кожного файлу.
-8. Агрегує результати: підраховує загальну кількість файлів, успішно згенерованих, пройшли перевірку, а також розподіл вердиктів серед тих, що пройшли перевірку.
-9. Формує звіт, який включає конфігурацію, підрахунки та відсотки помилкових спрацьовувань.
-10. Зберігає фінальний звіт у файл `report.json` у каталозі кешу.
-11. Виводить консольний звіт про результати вимірювання.
+3. Генерує документацію для файлу, використовуючи кешування за вмістом джерела.
+4. Якщо генерація документації успішна і отриманий бал перевищує встановлений поріг, переходить до етапу оцінки.
+5. Якщо бал не перевищує порогу, файл вважається "degraded" (зниженою якістю) і не підлягає подальшій оцінці.
+6. Якщо бал перевищує поріг, документація передається для оцінки потужній моделі, використовуючи кешування за вмістом джерела та згенерованою документацією.
+7. Оцінка повертає вердикт ("accurate", "generic" або "inaccurate"), впевненість та причину.
+8. Збираються результати для кожного файлу.
+9. Після обробки всіх файлів агрегуються результати: підраховуються загальні показники (кількість файлів, помилки генерації, кількість пройшлих тестів, розподіл вердиктів).
+10. Зберігається звіт у файл `report.json` у каталозі кешу.
+11. Виводиться консольний звіт про результати вимірювання.
 
 ## Гарантії поведінки
 

package/rules/doc-files/js/docs/docgen-judge.md

@@ -3,30 +3,32 @@ type: JS Module
 title: docgen-judge.mjs
 resource: npm/rules/doc-files/js/docgen-judge.mjs
 docgen:
-  crc: c6ab093a
+  crc: fcbf72fa
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Модуль оцінює згенеровану документацію, порівнюючи її з вихідним файлом за допомогою великої мовної моделі. Це дозволяє визначити відповідність та якість документації. Модуль надає функції для запуску оцінки (`judgeDoc`, `judgeFailsDoc`), отримання результатів (`parseDocVerdict`), визначення моделі (`JUDGE_MODEL`), перевірки статусу оцінювача (`JUDGE_ENABLED`) та отримання рівня впевненості (`JUDGE_CONFIDENCE`).
+## Огляд
+
+Модуль реалізує механізм оцінки якості документації. Він визначає модель для оцінки за допомогою `JUDGE_MODEL`, перевіряє статус активності гейту через `JUDGE_ENABLED` та встановлює поріг впевненості за допомогою `JUDGE_CONFIDENCE`. Модуль отримує, парсить та визначає фінальний статус документації, викликаючи `judgeDoc` для отримання висновків, а також може використовувати `judgeFailsDoc` для визначення провалу.
 
 ## Поведінка
 
 JUDGE_MODEL — Вказує модель, яку використовує суддя для оцінки документації.
-JUDGE_ENABLED — Позначає, чи активна функціональність судді.
-JUDGE_CONFIDENCE — Визначає мінімальний рівень впевненості, необхідний для позначення документації як деградованої.
-parseDocVerdict — Витягує та валідує об'єкт з оцінкою документації з сирого текстового виводу судді.
-judgeDoc — Виконує оцінку згенерованої документації проти вмісту вихідного файлу за допомогою великої мовної моделі.
+JUDGE_ENABLED — Позначає, чи активний семантичний гейт судді.
+JUDGE_CONFIDENCE — Визначає мінімальну впевненість, необхідну для позначення документації як деградованої.
+parseDocVerdict — Витягує та валідує об'єкт оцінки з сирого текстового виводу судді.
+judgeDoc — Зіставляє вміст вихідного файлу та згенеровану документацію, щоб отримати оцінку від судді.
 judgeFailsDoc — Визначає, чи слід вважати документацію деградованою на основі оцінки судді.
 
 ## Публічний API
 
 JUDGE_MODEL — Визначає модель-суддю як `N_CLOUD_MIN_MODEL` (хмарний мінімальний рівень).
-JUDGE_ENABLED — Автоматично вмикає механізм судді, якщо обрано `N_CLOUD_MIN_MODEL`.
-JUDGE_CONFIDENCE — Встановлює мінімальний рівень впевненості, необхідний для позначення документа як погіршеного (degraded) за неточним вердиктом.
-parseDocVerdict — Витягує та перевіряє структуру вердикту у форматі JSON із сирих даних від великої мовної моделі.
-judgeDoc — Оцінює згенерований документ потужною моделлю, порівнюючи його з вихідним джерелом.
-judgeFailsDoc — Визначає, чи повинен документ бути позначений як погіршений (degraded) на підставі вердикту, якщо він неточний і має достатню впевненість.
+JUDGE_ENABLED — Автоматично вмикає механізм суддівства, якщо обрано `N_CLOUD_MIN_MODEL`.
+JUDGE_CONFIDENCE — Встановлює мінімальний рівень впевненості для позначення документа як погіршеного (degraded) через неточність.
+parseDocVerdict — Витягує та перевіряє JSON-вердикт із відповіді великої мовної моделі.
+judgeDoc — Оцінює згенерований документ потужною моделлю порівняно з оригінальним джерелом.
+judgeFailsDoc — Визначає, чи повинен документ бути позначений як погіршений, якщо вердикт є `inaccurate` і впевненість достатня.
 
 ## Гарантії поведінки
 

package/rules/doc-files/js/docs/docgen-scan.md

@@ -3,47 +3,48 @@ type: JS Module
 title: docgen-scan.mjs
 resource: npm/rules/doc-files/js/docgen-scan.mjs
 docgen:
-  crc: f01465d8
+  crc: 563b7722
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль аналізує кодову базу та пов'язану з нею документацію. Він визначає, які файли є джерелами за допомогою `isSourceFile` та знаходить відповідні шляхи документації за допомогою `docPathForSource`. Модуль перевіряє, чи не залишилися без зв'язку (сиротами) документи, використовуючи `scanOrphanedDocs`, та сканує файли документації за допомогою `scanForDocFiles`. Для роботи з кореневими каталогами використовується `resolveRoot`. Усі операції виконуються з механізмом перехоплення помилок (fail-safe), при цьому при певних збоях повертається `null` замість викидання винятків.
+Модуль визначає, які файли є кодовим джерелом за допомогою `isSourceFile`. Він обчислює відповідні шляхи до Markdown-документів для коду за допомогою `docPathForSource`. Модуль ідентифікує потенційні кандидати для документування за допомогою `isDocCandidate` та надає опис файлу за допомогою `describeFile`. Для аналізу файлової системи використовуються `scanOrphanedDocs` для пошуку "сирітських" документів та `scanForDocFiles` для сканування файлів. Модуль також може визначати кореневий каталог за допомогою `resolveRoot` та виконувати сканування файлів документації через `runDocFilesScanCli` або перевірку через `runDocFilesCheckCli`.
 
 ## Поведінка
 
 isSourceFile визначає, чи є ім'я файлу кодовим джерелом для документування.
-docPathForSource обчислює шлях до відповідного MD-документа для заданого кодового файлу.
-isDocCandidate визначає, чи підлягає певний файл документуванню, враховуючи розширення, статус тесту та ігнорування.
-describeFile описує кодовий файл, надаючи його шлях, шлях до документації та стан застарілості.
-scanOrphanedDocs знаходить MD-документи, які посилаються на кодові файли, що більше не існують.
-scanForDocFiles рекурсивно обходить дерево і повертає список кодових файлів із їхнім станом застарілості, відфільтрований за ігноруванням Git.
-resolveRoot парсить аргументи для визначення абсолютного кореня обходу, використовуючи поточну робочу директорію за замовчуванням.
+docPathForSource обчислює шлях до відповідного md-документа для заданого кодового файлу.
+isDocCandidate визначає, чи є файл кандидатом на документування, враховуючи розширення, статус тесту та ігнорування.
+describeFile описує кодовий файл, надаючи шлях джерела, шлях доки та стан застарілості.
+scanOrphanedDocs знаходить md-документи, які посилаються на джерела, що більше не існують.
+scanForDocFiles рекурсивно сканує дерево і повертає список кодових файлів зі станом застарілості, відфільтрований за ігноруванням Git.
+resolveRoot визначає абсолютний корінь обходу, використовуючи аргументи або поточний робочий каталог.
 runDocFilesScanCli сканує дерево і друкує JSON-масив усіх кодових файлів зі станом застарілості.
-runDocFilesCheckCli виконує перевірку застарілості, підтримуючи режими для перевірки одного файлу, Git-гейту або звітів про знижену якість.
+runDocFilesCheckCli виконує перевірку застарілості, що може бути використана для хуків, Git-гейтів або ручного переліку шляхів.
 
 ## Публічний API
 
-isSourceFile — визначає, чи є файл кодовим джерелом для створення документації.
-docPathForSource — визначає шлях до відповідного MD-документа, розміщений у теці `docs/` відносно коду.
-isDocCandidate — вирішує, чи повинен кодовий файл бути документований: має правильне розширення, не є тестом, не ігнорується та не є системним документом.
-describeFile — надає опис кодового файлу, включаючи його шлях, шлях до документації та статус застарілості.
-scanOrphanedDocs — шукає документи, які посилаються на кодові файли, що більше не існують, перевіряючи лише згенеровані файли.
-scanForDocFiles — рекурсивно збирає всі кодові файли з дерева, визначаючи їхній статус застарілості, і відсіюючи ті, що ігноруються через `.gitignore`.
-resolveRoot — встановлює кореневу директорію для сканування, використовуючи аргумент командного рядка або поточну робочу директорію.
-runDocFilesScanCli — сканує дерево та виводить JSON-масив усіх кодових файлів зі статусом застарілості, дозволяючи фільтрувати лише застарілі або всі файли.
-runDocFilesCheckCli — виконує перевірку застарілості для використання у хуках та командному інтерфейсі.
-
-Режими:
---hook — перевіряє один файл, отриманий з JSON через стандартний ввід.
---git — порівнює файли у `git diff` та блокує процес, якщо знайдено більше за встановлений поріг застарілих файлів.
---degraded — виводить звіт про документи з низьким показником якості.
-<paths…> — обробляє лише вказані шляхи-джерела.
-
-Вихідний код 2 — вказує на знаходження застарілих файлів (для блокування хука).
-Вихідний код 0 — вказує на відсутність застарілих файлів або проходження перевірки згідно з порогом.
+isSourceFile — визначає, чи є файл вихідним кодом для створення документації.
+docPathForSource — визначає шлях до файлу документації, розміщений у теці `docs/` відносно коду.
+isDocCandidate — вирішує, чи повинен кодовий файл бути документований (правильне розширення, не тест, не ігнорується, не системний).
+describeFile — надає опис кодового файлу, включаючи його шлях та статус застарілості.
+scanOrphanedDocs — знаходить файли документації, які посилаються на вихідний код, що більше не існує.
+scanForDocFiles — рекурсивно шукає всі кодові файли у заданому дереві та визначає їхній статус застарілості.
+resolveRoot — встановлює кореневу директорію для сканування, використовуючи аргумент командного рядка або поточну директорію.
+runDocFilesScanCli — сканує дерево та виводить JSON-масив усіх кодових файлів зі статусом застарілості.
+runDocFilesCheckCli — виконує перевірку застарілості файлів для хуків та командного інтерфейсу.
+
+**Режими роботи:**
+`--hook` — перевіряє один файл, отриманий із вхідного JSON, у контексті хука.
+`--git` — порівнює файли у `git diff` та блокує виконання, якщо знайдено застарілі файли, перевищуючи встановлений ліміт.
+`--degraded` — генерує звіт про файли документації, які не відповідають встановленому рівню якості.
+`<paths…>` — обробляє лише вказані явно шляхи-джерела.
+
+**Коди виходу:**
+Вихід 2 — вказує на знаходження застарілих файлів (для блокування хука).
+Вихід 0 — вказує на відсутність застарілих файлів або проходження перевірки згідно з лімітом.
 
 ## Гарантії поведінки
 

package/rules/doc-files/js/docs/index.md

@@ -6,20 +6,19 @@ resource: npm/rules/doc-files/js/
 
 # npm/rules/doc-files/js
 
-| Файл                                                    | Тип       |
-| ------------------------------------------------------- | --------- |
-| [docgen-crc.mjs](docgen-crc.md)                         | JS Module |
+| Файл | Тип |
+|---|---|
+| [docgen-crc.mjs](docgen-crc.md) | JS Module |
 | [docgen-extract-anchors.mjs](docgen-extract-anchors.md) | JS Module |
-| [docgen-extract.mjs](docgen-extract.md)                 | JS Module |
-| [docgen-files-batch.mjs](docgen-files-batch.md)         | JS Module |
-| [docgen-gen.mjs](docgen-gen.md)                         | JS Module |
-| [docgen-ignore.mjs](docgen-ignore.md)                   | JS Module |
-| [docgen-judge-measure.mjs](docgen-judge-measure.md)     | JS Module |
-| [docgen-judge.mjs](docgen-judge.md)                     | JS Module |
-| [docgen-prompts.mjs](docgen-prompts.md)                 | JS Module |
-| [docgen-scan.mjs](docgen-scan.md)                       | JS Module |
-| [lint.mjs](lint.md)                                     | JS Module |
-| [run-lint.mjs](run-lint.md)                             | JS Module |
-| [units-js.mjs](units-js.md)                             | JS Module |
-| [units-rs.mjs](units-rs.md)                             | JS Module |
-| [units.mjs](units.md)                                   | JS Module |
+| [docgen-extract.mjs](docgen-extract.md) | JS Module |
+| [docgen-files-batch.mjs](docgen-files-batch.md) | JS Module |
+| [docgen-gen.mjs](docgen-gen.md) | JS Module |
+| [docgen-ignore.mjs](docgen-ignore.md) | JS Module |
+| [docgen-judge-measure.mjs](docgen-judge-measure.md) | JS Module |
+| [docgen-judge.mjs](docgen-judge.md) | JS Module |
+| [docgen-prompts.mjs](docgen-prompts.md) | JS Module |
+| [docgen-scan.mjs](docgen-scan.md) | JS Module |
+| [run-lint.mjs](run-lint.md) | JS Module |
+| [units-js.mjs](units-js.md) | JS Module |
+| [units-rs.mjs](units-rs.md) | JS Module |
+| [units.mjs](units.md) | JS Module |

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-lint → 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-lint → 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-lint → 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-lint → 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-lint → 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-lint → 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-lint → 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-lint → 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-lint → 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