@nitra/cursor 12.6.1 → 12.8.0

package/rules/bun/docs/fix.md

@@ -12,11 +12,11 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 
 ## Публічний API
 

package/rules/bun/docs/index.md

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

package/rules/bun/docs/main.md

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

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

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

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

@@ -3,51 +3,26 @@ type: JS Module
 title: layout.mjs
 resource: npm/rules/bun/js/layout.mjs
 docgen:
-  crc: ba2a6730
+  crc: 468d3430
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Файл надає інструмент для перевірки відповідності даних визначеному контракту. Функція `check` (bun.mdc) виконує перевірку стану даних і повертає логічний результат, що вказує на успішність виконання перевірки. У разі невдачі функція повертає `false` або `null` замість генерації винятку.
+Модуль перевіряє наявність критично важливих файлів та директорій у корені репозиторію для забезпечення коректної роботи системи. Він валідує наявність файлів залежностей, директорії `.yarn`, `bun.lock`, `bunfig.toml`, `package.json` та `package-lock.json` відповідно до вимог, зазначених у (bun.mdc). Результат перевірки повертається як код завершення.
 
 ## Поведінка
 
-1. Завантаження конфігурації
-   Завантажувач зчитує налаштування правил та вимкнених правил з файлу `.n-cursor.json` у корені репозиторію. Якщо файл відсутній, повертається порожній набір правил.
-
-2. Перевірка зв'язку скриптів
-   Система перевіряє зв'язок між ідентифікаторами правил, визначеними у конфігурації, та наявністю скриптів у кореневому `package.json`.
-
-3. Оцінка стану власників
-   Оцінювач визначає стан кожного правила-власника, порівнюючи активні правила з налаштуваннями. Якщо активне правило присутнє, результат позначається як успішний. Якщо власник відсутній у налаштуваннях, результат позначається як провал, якщо власник не був вимкнений.
-
-4. Перевірка ланцюжків виконання
-   Система перевіряє, чи згадує ланцюжок виконання `bun run <скрипт>` конкретний скрипт. Ця перевірка виконується для уникнення хибних спрацьовувань через префікси.
-
-5. Перевірка відповідності
-   Основна перевірка встановлює, що якщо скрипт присутній у `package.json`, він повинен бути активним у конфігурації. Якщо скрипт присутній, але власники не активні, система вимагає видалення скрипта з кореневого файлу.
-
-6. Перевірка ланцюжків та вимкнених правил
-   Якщо ланцюжок виконання `bun run <скрипт>` присутній, але жоден власник не активний, система вимагає видалення з ланцюжка виконання.
-
-7. Перевірка відсутності
-   Якщо скрипт відсутній і власники не активні, система позначає це як успішне проходження.
-
-8. Перевірка заборонених файлів
-   Система перевіряє наявність заборонених файлів у корені репозиторію, включаючи файли блокування залежностей та директорії `.yarn`.
-
-9. Перевірка залежностей
-   Система перевіряє наявність необхідного файлу `bun.lock`. Відсутність цього файлу є провалом, що вимагає запуску `bun i`.
-
-10. Перевірка конфігурації Bun
-    Система перевіряє наявність файлу `bunfig.toml`, який використовується для перевірки структури, необхідної для використання `linker = "hoisted"` у `bun.mdc`.
+1. Перевіряє наявність файлів-блоків залежностей (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `.yarnrc.yml`) у корені репозиторію. Якщо знайдено, повідомляє про заборонений файл. Якщо не знайдено, підтверджує відсутність.
+2. Перевіряє наявність директорії `.yarn` у корені репозиторію. Якщо знайдено, повідомляє про заборонену директорію. Якщо не знайдено, підтверджує відсутність.
+3. Перевіряє наявність файлу `bun.lock` у корені репозиторію. Якщо знайдено, підтверджує його наявність. Якщо відсутній, повідомляє про необхідність запуску `bun i`.
+4. Перевіряє наявність файлу `bunfig.toml` у корені репозиторію. Якщо знайдено, підтверджує його наявність (структуру перевіряє інструмент `npx @nitra/cursor fix → bun.bunfig` відповідно до (bun.mdc)). Якщо відсутній, повідомляє про необхідність створення з конфігурацією `[install] linker = "hoisted"` (bun.mdc).
+5. Перевіряє наявність файлу `package.json` у корені репозиторію. Якщо відсутній, повідомляє про це.
+6. Повертає код завершення, що вказує на успішне виконання перевірки (0) або на наявність проблем (1).
 
 ## Публічний API
 
-check — перевіряє, чи відповідає проєкт вимогам bun.mdc
+check — перевіряє відповідність проєкту стандартам bun.mdc
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдалої перевірки повертає `false`/`null` замість винятку.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/bun/{fix.mjs → main.mjs}

@@ -2,7 +2,9 @@ import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
  * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
@@ -12,7 +14,7 @@ export function run(ctx) {
 }
 
 if (isRunAsCli(import.meta.url)) {
-  // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
   process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/capacitor/docs/fix.md

@@ -12,17 +12,17 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат.
 2. Запуск у режимі CLI.
-    *   Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених записів.
-    *   Генерує зведену інформацію.
-    *   Використовує `process.exitCode` для визначення виходу.
+   - Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Виконує завантаження конфігурації.
+   - Виконує перевірку дозволених записів.
+   - Генерує зведену інформацію.
+   - Використовує `process.exitCode` для визначення виходу.
 
 ## Публічний API
 

package/rules/capacitor/docs/index.md

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

package/rules/capacitor/docs/main.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/capacitor/main.mjs
+docgen:
+  crc: 762b6875
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль застосовує політику та логіку, визначену в конфігурації meta.json, для валідації. При запуску як CLI ініціюється повний запуск правила, що включає завантаження конфігурацій, застосування білих списків та підбиття підсумків. Модуль є лише для читання (не виконує записів у файлову систему чи базу даних) і використовує кешування даних у межах одного прогону.
+
+## Поведінка
+
+1. Викликається функція `run` для виконання перевірки.
+2. Виконання перевірки включає застосування політики, обробку логіки, пов'язаної з JavaScript, та посилання на MDC.
+3. Якщо код виконується як окрема утиліта (CLI), ініціюється повний запуск правила.
+4. Запуск правила включає завантаження конфігурацій, застосування білих списків та підбиття підсумків.
+
+## Публічний API
+
+run — виконує основну логіку правила: застосовує перевірки JS-зацікавленостей, політики та посилання на MDC.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

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

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

package/rules/capacitor/{fix.mjs → main.mjs}

@@ -2,7 +2,9 @@ import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
- * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
  * Library mode: викликається CLI orchestration через `import + run(ctx)`.
  * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 — OK, 1 — порушення
@@ -12,7 +14,7 @@ export function run(ctx) {
 }
 
 if (isRunAsCli(import.meta.url)) {
-  // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
   process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/changelog/docs/fix.md

@@ -12,18 +12,18 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Приймає контекст прогону.
-    *   Виконує застосування JS-занепокоєних.
-    *   Застосовує політику.
-    *   Генерує посилання MDC.
-    *   Повертає результат прогону.
+   - Приймає контекст прогону.
+   - Виконує застосування JS-занепокоєних.
+   - Застосовує політику.
+   - Генерує посилання MDC.
+   - Повертає результат прогону.
 2. Виконання у режимі CLI.
-    *   Виконується як окремий скрипт.
-    *   Еквівалент команди `npx @nitra/cursor fix <id>`.
-    *   Виконує завантаження конфігурації.
-    *   Виконує перевірку дозволених елементів.
-    *   Генерує зведену інформацію.
-    *   Виконує повний еквівалент `fix.mjs`.
+   - Виконується як окремий скрипт.
+   - Еквівалент команди `npx @nitra/cursor fix <id>`.
+   - Виконує завантаження конфігурації.
+   - Виконує перевірку дозволених елементів.
+   - Генерує зведену інформацію.
+   - Виконує повний еквівалент `fix.mjs`.
 
 ## Публічний API
 

package/rules/changelog/docs/index.md

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

package/rules/changelog/docs/main.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/changelog/main.mjs
+docgen:
+  crc: 762b6875
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль відповідає за виконання політики, використовуючи дані з meta.json. Він забезпечує перевірку та застосування логіки, визначеної в конфігурації. Виклик функції run ініціює процес виконання правила, включаючи кешування даних у межах одного прогону.
+
+## Поведінка
+
+1. Викликається для перевірки. Виконує застосування політики, перевірку JS-зацікавленостей та посилання на MDC.
+2. Якщо код виконується як окрема програма (CLI), запускається повний процес виконання правила, включаючи завантаження конфігурацій та підсумок.
+
+## Публічний API
+
+run — виконує основну логіку правила: застосовує перевірки до коду, аналізує відповідність політикам та посиланням на метадані.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

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

@@ -16,19 +16,19 @@ docgen:
 3. Зчитує всі кореневі каталоги проектів у монорепо.
 4. Класифікує кожен проект як публікувальний (registryPublishable) або локальний.
 5. Для кожного публікувального проекту виконує перевірку:
-    а. Зчитує маніфест проекту.
-    б. Якщо у маніфесті відсутнє ім'я або поле version, фіксує помилку.
-    в. Якщо є change-файл(и) у .changes/, фіксує успіх, оскільки bump зробить CI (n-changelog.mdc), і перевіряє наявність "CHANGELOG.md" у файлах проекту.
-    г. Якщо немає change-файлу, визначає точку порівняння на основі поточної гілки.
-    д. Порівнює версію в маніфесті з опублікованою версією (за допомогою npm view або запиту до https://pypi.org/pypi/).
-    е. Якщо версія в маніфесті випереджає опубліковану, фіксує помилку, оскільки ручний bump поза CI заборонений.
-    ж. Якщо версія в маніфесті позаду опублікованої, фіксує успіх, оскільки це відставання локального репозиторію від реєстру.
-    з. Якщо версії збігаються, перевіряє змінений код відносно точки порівняння. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
+   а. Зчитує маніфест проекту.
+   б. Якщо у маніфесті відсутнє ім'я або поле version, фіксує помилку.
+   в. Якщо є change-файл(и) у .changes/, фіксує успіх, оскільки bump зробить CI (n-changelog.mdc), і перевіряє наявність "CHANGELOG.md" у файлах проекту.
+   г. Якщо немає change-файлу, визначає точку порівняння на основі поточної гілки.
+   д. Порівнює версію в маніфесті з опублікованою версією (за допомогою npm view або запиту до https://pypi.org/pypi/).
+   е. Якщо версія в маніфесті випереджає опубліковану, фіксує помилку, оскільки ручний bump поза CI заборонений.
+   ж. Якщо версія в маніфесті позаду опублікованої, фіксує успіх, оскільки це відставання локального репозиторію від реєстру.
+   з. Якщо версії збігаються, перевіряє змінений код відносно точки порівняння. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
 6. Для кожного локального проекту виконує перевірку:
-    а. Зчитує маніфест проекту.
-    б. Визначає точку порівняння на основі поточної гілки.
-    в. Перевіряє, чи є релевантні зміни у проекті відносно точки порівняння.
-    г. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
+   а. Зчитує маніфест проекту.
+   б. Визначає точку порівняння на основі поточної гілки.
+   в. Перевіряє, чи є релевантні зміни у проекті відносно точки порівняння.
+   г. Якщо зміни є, але немає change-файлу, викликає механізм фіксації або фіксує помилку, надаючи підказку для використання команди `npx @nitra/cursor change`.
 7. Повертає кінцевий код виходу, що відображає результат перевірки.
 
 ## Гарантії поведінки

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

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

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

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

package/rules/changelog/main.mjs

@@ -0,0 +1,20 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+
+/**
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
+ * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

package/rules/ci4/docs/fix.md

@@ -13,12 +13,12 @@ docgen:
 ## Поведінка
 
 1. Запуск правила.
-    *   Виклик runStandardRule з контекстом.
-    *   Повернення результату.
+   - Виклик runStandardRule з контекстом.
+   - Повернення результату.
 
 2. Запуск правила у режимі CLI.
-    *   Виклик runRuleCli з директорією модуля.
-    *   Вихід з процесом залежно від результату.
+   - Виклик runRuleCli з директорією модуля.
+   - Вихід з процесом залежно від результату.
 
 ## Публічний API
 

package/rules/ci4/docs/index.md

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

package/rules/ci4/docs/main.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/ci4/main.mjs
+docgen:
+  crc: 762b6875
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль валідує дані відповідно до правил, використовуючи конфігурацію, визначену в meta.json. Він застосовує білий список та виконує логіку перевірки. При запуску як окрема програма, він повертає код виходу, що інформує про успіх чи виявлені порушення. Модуль є Read-only, тобто не здійснює записів у файлову систему чи бази даних. Кешування даних відбувається у межах одного прогону.
+
+## Поведінка
+
+1. Викликається функція `run` для виконання перевірки.
+2. Виконання `run` застосовує логіку правила, включаючи обробку JS-запитань, політику та посилання на MDC.
+3. Якщо код виконується як окрема програма (CLI), ініціюється повний запуск правила.
+4. Повний запуск правила зчитує конфігурацію з `meta.json`, застосовує білий список та надає зведену інформацію.
+5. Результат виконання визначає код виходу процесу: 0 для успіху або 1 для виявлення порушень.
+
+## Публічний API
+
+run — виконує основну логіку правила: застосовує перевірки, обробляє JS-залежності, застосовує політику та посилання MDC.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

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

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

package/rules/ci4/main.mjs

@@ -0,0 +1,20 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+
+/**
+ * Єдиний entrypoint правила (ADR 2026-06-21). `run()` — check-поверхня: applies →
+ * JS-concerns → policy → mdc-refs (через runStandardRule). Lint-поверхні правило не має
+ * (`meta.json` без `lint`), тож експорту `lint` тут немає.
+ * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`
+  // (config-loading + whitelist + summary): library-роль (run) + standalone-роль (CLI-блок).
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

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

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

package/rules/doc-files/docs/main.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/doc-files/main.mjs
+docgen:
+  crc: 64f215a5
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль перевіряє відповідність коду та документації, спираючись на конфігурацію `meta.json`. Функція `run` перевіряє консистентність між кодом та документацією. Функція `lint` перевіряє застарілі описи документації.
+
+## Поведінка
+
+run виконує перевірку консистентності між кодом та документацією.
+
+lint перевіряє, чи не застаріли описи документації, і може автоматично їх оновлювати, якщо це дозволено конфігурацією `meta.json`.
+
+## Публічний API
+
+run — виконує основну перевірку, яка включає аналіз JS-задач, застосування політик та посилання на MDC.
+lint — сканує файли документації на наявність застарілих елементів, з можливістю автоматичного виправлення за умови активації LLM.
+llmFix — виконує добровільну генерацію виправлень за допомогою LLM, якщо це дозволено в конфігурації.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

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

@@ -74,7 +74,7 @@ const EXT_TYPES = {
   '.ts': 'TS Module',
   '.vue': 'Vue Component',
   '.py': 'Python Module',
-  '.rs': 'Rust Module',
+  '.rs': 'Rust Module'
 }
 
 /**
@@ -86,8 +86,6 @@ function typeForSource(sourcePath) {
   return EXT_TYPES[extname(sourcePath).toLowerCase()] ?? 'Source File'
 }
 
-
-
 /**
  * Нормалізує issues до YAML-безпечних кодів: бере фрагмент до першого пробілу
  * (зрізає людиночитні хвости помилок), відкидає порожні, обмежує кількість.
@@ -112,11 +110,7 @@ function issueCodes(issues) {
  * @returns {string} OKF-сумісний YAML frontmatter
  */
 export function buildDocFrontmatter(source, crc, quality = null, model = null) {
-  const okfLines = [
-    `type: ${typeForSource(source)}`,
-    `title: ${basename(source)}`,
-    `resource: ${source}`,
-  ]
+  const okfLines = [`type: ${typeForSource(source)}`, `title: ${basename(source)}`, `resource: ${source}`]
 
   // docgen namespace: лише CRC-механіка і quality (source перенесено у resource)
   const docgenLines = [`crc: ${crc}`]

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

@@ -48,11 +48,13 @@ const FALSY_RETURN_RE = /catch[\s\S]{0,400}?return\s+(false|null|''|"")/
 // Мережа: окрім явного fetch/http, ловимо абстраговані клієнти (graphql/db/rpc/
 // octokit/.request/.query). Хибний false-negative тут = небезпечна гарантія
 // «без мережі», тож свідомо схиляємось до over-detection (м'якший бік помилки).
-const NETWORK_RE = /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
+const NETWORK_RE =
+  /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
 // Будь-який `throw` назовні → НЕ можна гарантувати «fail-safe / без винятків».
 const THROW_RE = /\bthrow\s/
 // Запис у БД / зовнішню мутацію → НЕ read-only (навіть якщо нема ФС-запису).
-const MUTATION_RE = /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]|[Mm]utation\b|\bmut[A-Z]\w*|\.(save|create|update|delete|insert|destroy|mutate)\(/
+const MUTATION_RE =
+  /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]|[Mm]utation\b|\bmut[A-Z]\w*|\.(save|create|update|delete|insert|destroy|mutate)\(/
 // Кеш — лише за ІМЕНОВАНИМ маркером (`cache`/`Cache`/`memoize`), не за будь-яким
 // `new Map()`: акумулятор (напр. `byPath = new Map()`) — не кеш, а хибна гарантія
 // «Кешує результати» гірша за пропуск (фабрикація > мовчання).
@@ -213,7 +215,7 @@ function extractMarkers(src) {
   return {
     // «Фабрикація > мовчання»: прапорець true лише за high-confidence; інакше
     // guaranteesFromMarkers/factsSummary його ОПУСКАЮТЬ (не стверджують протилежне).
-    readOnly: !WRITE_FS_RE.test(src) && !MUTATION_RE.test(src),                    // ні ФС-запису, ні DB-мутацій
+    readOnly: !WRITE_FS_RE.test(src) && !MUTATION_RE.test(src), // ні ФС-запису, ні DB-мутацій
     catchesErrors: (CATCH_RE.test(src) || TRY_RE.test(src)) && !THROW_RE.test(src), // fail-safe лише якщо НЕ кидає
     returnsFalsyOnFail: FALSY_RETURN_RE.test(src) && !THROW_RE.test(src),
     network: NETWORK_RE.test(src),