@nitra/cursor 12.6.0 → 12.7.0

package/rules/nginx-default-tpl/docs/main.md

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

package/rules/nginx-default-tpl/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/npm-module/docs/index.md

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

package/rules/npm-module/docs/main.md

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

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

@@ -3,31 +3,32 @@ type: JS Module
 title: rule_meta.mjs
 resource: npm/rules/npm-module/js/rule_meta.mjs
 docgen:
-  crc: 8262678c
+  crc: 938ccd0a
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Перевіряє наявність директорії npm/rules у вказаному шляху. Ітерує по всіх директоріях у директорії npm/rules. Для кожної директорії виконує перевірку наявності файлу auto.md та валідність полів auto та lint у конфігурації meta.json. Перевіряє наявність файлу js/lint.mjs у каталозі правила. Збирає результати валідації та повертає код виходу репортера.
+## Огляд
+
+Модуль перевіряє конфігурацію правил, розташованих у каталозі `npm/rules`. Він забезпечує наявність обов'язкового файлу `scripts.mdc` для кожного правила. Крім того, він валідує структуру метаданих у `meta.json`, перевіряючи відповідність полів, таких як `auto` та `lint`, визначеним контрактам. У процесі перевірки використовуються маркери повідомлень (scripts.mdc).
 
 ## Поведінка
 
-1. Перевірка наявності директорії npm/rules у вказаному шляху.
-2. Ітерація по всіх директоріях у директорії npm/rules.
-3. Для кожної директорії виконується перевірка правила.
-4. Перевірка наявності файлу auto.md у директорії правила.
-5. Перевірка валідності поля auto у meta.json правила.
-6. Перевірка наявності поля lint у meta.json правила.
-7. Перевірка валідності поля lint у meta.json правила.
-8. Перевірка наявності файлу js/lint.mjs у каталозі правила.
-9. Збір результатів валідації.
-10. Повернення коду виходу репортера.
+1. Викликати `check` для початку валідації.
+2. Перевірити наявність каталогу `npm/rules` у корені репозиторію. Якщо каталог відсутній, валідація завершується успішно.
+3. Для кожного підкаталогу у `npm/rules` (який представляє правило):
+    а. Перевірити наявність файлу `auto.md`. Якщо він присутній, реєструється помилка, оскільки метадані тепер знаходяться у `meta.json`.
+    б. Перевірити наявність файлу `<id>.mdc` у каталозі правила. Якщо він відсутній, реєструється помилка, оскільки це обов'язковий файл (scripts.mdc).
+    в. Зчитати вміст `meta.json` правила. Якщо файл відсутній або невалідний, реєструється помилка, і перевірка цього правила припиняється.
+    г. Перевірити поле `auto` у `meta.json`. Якщо поле `auto` присутнє, воно повинно бути валідним (відповідати одному з визначених форматів, або бути відсутнім). Якщо поле `auto` містить невідомий предикат, реєструється помилка.
+    ґ. Перевірити поле `lint` у `meta.json`. Якщо поле `lint` присутнє, воно повинно бути валідним (відповідати "per-file" або "full"). Також перевіряється, чи експортує файл `main.mjs` у каталозі правила функцію `lint` відповідно до зазначеного значення `lint`.
+    і. Якщо всі перевірки для правила пройшли успішно, реєструється повідомлення про валідність `meta.json`.
+4. Після обробки всіх правил, повертається код виходу, що відображає загальний статус валідації.
 
 ## Публічний API
 
-check — Валідує всі `npm/rules/<id>/meta.json`.
+check — перевіряє відповідність усіх файлів `npm/rules/<id>/meta.json` встановленим критеріям.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/npm-module/js/rule_meta.mjs

@@ -1,5 +1,5 @@
 /** @see ./docs/rule_meta.md */
-import { existsSync, readdirSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
@@ -41,8 +41,12 @@ function checkLintField(id, ruleDir, raw, reporter) {
     reporter.fail(`rules/${id}: meta.json.lint нерозпізнане (очікується "per-file"|"full")`)
     return false
   }
-  if (!existsSync(join(ruleDir, 'js', 'lint.mjs'))) {
-    reporter.fail(`rules/${id}: lint:"${raw.lint}" але немає js/lint.mjs`)
+  const mainPath = join(ruleDir, 'main.mjs')
+  const src = existsSync(mainPath) ? readFileSync(mainPath, 'utf8') : ''
+  // Канон (ADR 2026-06-21): lint-поверхня — це експорт `lint` із `main.mjs` (інлайн або
+  // `export { lint } from './js/…'`), а не окремий `js/lint.mjs`.
+  if (!/export\s+(?:async\s+)?function\s+lint\b|export\s*\{[^}]*\blint\b/u.test(src)) {
+    reporter.fail(`rules/${id}: lint:"${raw.lint}" але main.mjs не експортує lint`)
     return false
   }
   return true
@@ -63,6 +67,12 @@ function checkRule(id, ruleDir, reporter) {
     ruleOk = false
   }
 
+  // Канон (scripts.mdc): {rule}.mdc — ОБОВ'ЯЗКОВИЙ у кожному npm/rules/<id>/.
+  if (!existsSync(join(ruleDir, `${id}.mdc`))) {
+    reporter.fail(`rules/${id}: відсутній ${id}.mdc — обов'язковий (scripts.mdc)`)
+    ruleOk = false
+  }
+
   const raw = readRuleMetaRaw(ruleDir)
   if (!raw) {
     reporter.fail(`rules/${id}: відсутній або невалідний meta.json`)

package/rules/npm-module/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/php/docs/index.md

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

package/rules/php/docs/main.md

@@ -0,0 +1,33 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/php/main.mjs
+docgen:
+  crc: a2c44b0c
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Скрипт виконує перевірку коду відповідно до правила `php.mdc`. Він запускає `composer audit` для перевірки залежностей, а також, якщо встановлені, виконує PHPStan, Psalm, PHP-CS-Fixer (у режимі dry-run) та PHPCS зі стандартом Security. Робота скрипта ґрунтується на конфігурації, визначеній у `composer.json`. Скрипт пропускає запуск інструменту, якщо відповідний виконуваний файл відсутній у `vendor/bin/`. Якщо `composer.json` відсутній у корені, інструменти не запускаються.
+
+## Поведінка
+
+run виконує стандартну перевірку, застосовуючи правила до контексту.
+getPhpcsCodePaths визначає шляхи до каталогів коду для PHPCS, перевіряючи типові директорії (`app`, `src`, `lib`, `public`, `www`) або кореневий каталог.
+runPhpLintSteps виконує послідовність перевірок: `composer audit`, PHP-CS-Fixer (dry-run), phpcs (Security), PHPStan та Psalm, пропускаючи кроки, якщо відповідні інструменти відсутні.
+lint оркеструє виконання кроків PHP-лінтування для всього репозиторію.
+
+## Публічний API
+
+run — головна точка входу для виконання правил (перевірка логіки застосування до JS-задач, політик та посилань MDC).
+getPhpcsCodePaths — Визначає шляхи до коду, які має аналізувати PHPCS.
+runPhpLintSteps — Виконує етапи лінтингу, включаючи аудит `composer`, `php-cs-fixer`, `phpstan` та `psalm`.
+lint — Координує фазу лінтингу, виконуючи аудит `composer`, перевірку стилю коду (`php-cs-fixer`) та аналіз статичних аналізаторів (`phpstan`/`psalm`).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.
+- Свідомо пропускає шляхи: `.git`, `node_modules`.

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

@@ -3,25 +3,25 @@ type: JS Module
 title: tooling.mjs
 resource: npm/rules/php/js/tooling.mjs
 docgen:
-  crc: a3e6a475
-  score: 95
+  crc: 22a05733
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Огляд
-Файл перевіряє наявність конфігураційних файлів для визначення залежностей та робочих потоків. Файл використовується для встановлення наявності певних файлів у репозиторії.
+Модуль перевіряє наявність ключових конфігураційних файлів проєкту, а саме `composer.json` та `package.json`. Перевірка здійснюється за допомогою публічної функції `check`. Мета — підтвердити наявність базових файлів, необхідних для роботи проєкту (php.mdc).
 
 ## Поведінка
 
-1. Перевірити наявність composer.json
-2. Перевірити наявність package.json
-3. Перевірити наявність .github/workflows/lint-php.yml
+1. Перевіряє наявність файлу `composer.json` у корені проєкту. Якщо файл відсутній, повідомляє про відсутність `composer.json` (php.mdc).
+2. Перевіряє наявність файлу `package.json` у корені проєкту. Якщо файл відсутній, повідомляє про відсутність `package.json` (php.mdc).
+3. Перевіряє наявність файлу `.github/workflows/lint-php.yml`. Якщо файл відсутній, повідомляє про необхідність створити його згідно з `php.mdc`.
+4. Повертає код виходу, який вказує на успішне виконання (0) або наявність проблем (1).
 
 ## Публічний API
 
-check — Перевіряє відповідність проєкту правилам php.mdc.
+check — перевіряє відповідність проєкту стандартам php.mdc.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Свідомо пропускає шляхи: `.github`, `.git`.
-- Не звертається до мережі.

package/rules/php/{lint/lint.mjs → main.mjs}

@@ -12,9 +12,22 @@ import { spawnSync } from 'node:child_process'
 import { existsSync, statSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { isRunAsCli } from '../../scripts/cli-entry.mjs'
+import { createCheckReporter } from '../../scripts/lib/check-reporter.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
+import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+import { 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); `lint()` нижче — lint-поверхня (composer/phpstan/psalm), імпл інлайн тут.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
 
 const PHPCS_CODE_DIR_CANDIDATES = ['app', 'src', 'lib', 'public', 'www']
 
@@ -62,11 +75,11 @@ function runTool(label, abs, args, pass, fail) {
 }
 
 /**
- * Запускає `lint-php`.
+ * Запускає кроки `lint-php` (composer audit + php-cs-fixer/phpcs/phpstan/psalm).
  * @param {string} [cwd] корінь репозиторію
  * @returns {number} 0 — OK, 1 — є помилки
  */
-export function run(cwd = process.cwd()) {
+export function runPhpLintSteps(cwd = process.cwd()) {
   const reporter = createCheckReporter()
   const { pass, fail } = reporter
 
@@ -121,6 +134,19 @@ export function run(cwd = process.cwd()) {
   return reporter.getExitCode()
 }
 
+/**
+ * Оркестраторний адаптер `n-cursor lint php` (лінтер-фаза): composer audit + php-cs-fixer
+ * (`--dry-run`) + phpstan/psalm через `run` у `runStandardLint` (лок). Read-only — мутацій
+ * немає, тож `opts` ігнорується. Структурні php.mdc-перевірки — у конформність-фазі.
+ * @param {string[] | undefined} _files ігнорується (whole-repo обхід)
+ * @param {string} [cwd] корінь
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files, cwd = process.cwd()) {
+  return runStandardLint(import.meta.dirname, () => runPhpLintSteps(cwd))
+}
+
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = run()
+  // Standalone: bun rules/php/main.mjs — повний еквівалент `npx @nitra/cursor check php`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/python/docs/index.md

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

package/rules/python/docs/main.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/python/main.mjs
+docgen:
+  crc: 8ceba96a
+  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`.
+
+## Поведінка
+
+run виконує стандартну перевірку на основі контексту.
+runLintPythonSteps виконує послідовність кроків лінтування Python, включаючи перевірку `pyproject.toml`, виконання `uv lock --check` та `uv sync --frozen`, а також запуск опціональних лінтерів (`ruff`, `mypy`) через `uv run`.
+runLintPython запускає послідовність кроків лінтування Python, використовуючи механізм стандартного лінтування.
+lint оркеструє запуск `runLintPython` для аналізу всього проєкту.
+
+## Публічний API
+
+run — Основна точка входу для виконання правил, що включає перевірку логіки застосування (JS-concerns → policy → mdc-refs) та виконання лінтингу.
+runLintPythonSteps — Виконує внутрішні етапи лінтингу для Python без збереження логів.
+runLintPython — Публічний інтерфейс для запуску лінтингу Python, що забезпечує унікальність виконання через блокування та аналіз стану репозиторію.
+lint — Координатор, який ініціює запуск лінтингу Python, делегуючи це `runLintPython`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -3,32 +3,32 @@ type: JS Module
 title: tooling.mjs
 resource: npm/rules/python/js/tooling.mjs
 docgen:
-  crc: f4dc22e2
-  score: 95
+  crc: fcabec1d
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Файл виконує перевірку наявності конфігураційних та залежностей у кореневому каталозі репозиторію. Він перевіряє структуру проекту відповідно до вимог, визначених у package.json.
+Модуль перевіряє відповідність структури проєкту вимогам, визначеним у `python.mdc`. Він перевіряє наявність ключових файлів конфігурації, таких як `pyproject.toml`, `uv.lock` та `package.json`, у корені репозиторію. Мета — підтвердити відповідність проєкту встановленим стандартам, зокрема щодо використання `uv` замість Poetry.
+
+Поведінка
+Виконує перевірку за допомогою публічної функції `check`. Ігнорує шляхи `.github` та `.git`. Не виконує операцій запису у файлову систему чи бази даних (Read-only). (python.mdc)
 
 ## Поведінка
 
-1. Перевірити наявність `pyproject.toml` у корені репозиторію.
-2. Перевірити наявність `uv.lock` у корені репозиторію.
-3. Якщо `uv.lock` відсутній, повернути код виходу.
-4. Перевірити наявність `poetry.lock` у корені репозиторію.
-5. Якщо `poetry.lock` знайдено, повернути помилку.
-6. Якщо `poetry.lock` відсутній, пропустити.
-7. Перевірити наявність `package.json` у корені репозиторію.
-8. Якщо `package.json` відсутній, повернути помилку.
-9. Перевірити наявність файлу `.github/workflows/lint-python.yml` у корені репозиторію.
-10. Якщо файлу `.github/workflows/lint-python.yml` немає, повернути помилку.
-11. Повернути код виходу.
+1. Перевіряє відповідність проєкту правилам (python.mdc) у вказаному корені репозиторію.
+2. Якщо файл `pyproject.toml` відсутній у корені, повертає код виходу, що вказує на відсутність конфігурації.
+3. Перевіряє наявність файлу `uv.lock`. Якщо він відсутній, повідомляє про необхідність згенерувати його за допомогою `uv lock` (python.mdc).
+4. Перевіряє відсутність файлів `poetry.lock` та `poetry.toml`. Якщо будь-який із них знайдено, повідомляє про необхідність відмови від Poetry та міграції на `uv` (python.mdc).
+5. Перевіряє наявність файлу `package.json` у корені. Якщо він відсутній, повідомляє про необхідність його додавання (python.mdc).
+6. Перевіряє наявність файлу `.github/workflows/lint-python.yml` у корені. Якщо він відсутній, повідомляє про необхідність його створення згідно з документацією (python.mdc).
+7. Повертає код виходу, що відображає загальний стан перевірки.
+8. Не перевіряє шляхи, що містять `.github` або `.git`.
 
 ## Публічний API
 
-check — Перевіряє відповідність проєкту правилам python.mdc.
+check — перевіряє відповідність проєкту стандартам python.mdc.
 
 ## Гарантії поведінки
 
-- Read-only: файл не виконує операцій запису у файлову систему.
+- Read-only: не виконує операцій запису (ФС/БД).
 - Свідомо пропускає шляхи: `.github`, `.git`.
-- Не звертається до мережі.

package/rules/python/{lint/lint.mjs → main.mjs}

@@ -24,10 +24,22 @@ import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
+import { isRunAsCli } from '../../scripts/cli-entry.mjs'
+import { createCheckReporter } from '../../scripts/lib/check-reporter.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
+import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+import { 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); `lint()` нижче — lint-поверхня (uv/ruff/mypy), імпл інлайн тут.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
 
 /**
  * Запускає CLI-крок і репортить результат.
@@ -117,6 +129,18 @@ export function runLintPythonSteps(cwd = process.cwd(), opts = {}) {
 export const runLintPython = (opts = {}) =>
   runStandardLint(import.meta.dirname, () => runLintPythonSteps(process.cwd(), opts))
 
+/**
+ * Оркестраторний адаптер `n-cursor lint python`: делегує у `runLintPython`.
+ * @param {string[] | undefined} _files ігнорується (whole-project аналіз)
+ * @param {string} [_cwd] корінь (CLI бере process.cwd())
+ * @param {{ readOnly?: boolean }} [opts] readOnly → ruff без `--fix`, format `--check`
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files, _cwd, opts = {}) {
+  return runLintPython({ readOnly: opts.readOnly === true })
+}
+
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintPython({ readOnly: process.argv.includes('--read-only') })
+  // Standalone: bun rules/python/main.mjs — повний еквівалент `npx @nitra/cursor check python`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/rego/docs/index.md

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

package/rules/rego/docs/main.md

@@ -0,0 +1,37 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/rego/main.mjs
+docgen:
+  crc: e58082a1
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+---
+
+## Огляд
+
+Файл реалізує конвеєр для лінтування Rego-полісів, що знаходяться у каталозі `npm/rules/` (де живуть Rego-полісі пакета `@nitra/cursor`). Конвеєр послідовно виконує три етапи перевірки: строгу компіляцію за допомогою `opa check --strict`, яка виявляє помилки компіляції, незадекларовані змінні та інші проблеми, які ігнорує `regal`; статичне лінтування за допомогою `regal lint` (згідно з https://docs.styra.com/regal), що перевіряє відповідність стилю та ідіоматичності Rego v1; та опціональний запуск юніт-тестів за допомогою `conftest verify` (як описано на https://www.conftest.dev/install/). Резолюція інструментів (`opa`, `regal`) здійснюється через механізм `ensureTool`, що забезпечує їх доступність у середовищі. Усі операції керуються конфігурацією, визначеною у `target.json`.
+
+## Поведінка
+
+run виконує стандартну перевірку політики, застосовуючи логіку, пов'язану з JS-контекстами та посиланнями на MDC.
+
+runLintRegoSteps запускає послідовні кроки лінтування Rego-полісі: `opa check --strict`, `regal lint` та опціонально `conftest verify` для файлів-тестів, якщо `conftest` доступний у PATH.
+
+runLintRego серіалізує виконання кроків лінтування Rego, забезпечуючи дедуплікацію на основі стану git-дерева.
+
+lint делегує виконання повного аналізу Rego-полісі функції runLintRego.
+
+## Публічний API
+
+run — Основна точка входу правила, яка застосовує логіку до JS-зацікавлень, політики та посилання на MDC.
+
+runLintRegoSteps — Виконує перевірку за допомогою `opa check --strict` та лінтинг за допомогою `regal lint` для визначених цілей. Зупиняє виконання з кодом 1, якщо попередні перевірки не пройшли.
+
+runLintRego — Публічний інтерфейс для запуску лінтінгу Rego, що забезпечує дедуплікацію на основі стану репозиторію.
+
+lint — Адаптер, що керує запуском лінтінгу Rego, делегуючи це `runLintRego`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/rego/{lint/lint.mjs → main.mjs}

@@ -30,10 +30,22 @@ import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { resolve } from 'node:path'
 
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { ensureTool } from '../../../scripts/lib/ensure-tool.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
+import { isRunAsCli } from '../../scripts/cli-entry.mjs'
+import { ensureTool } from '../../scripts/lib/ensure-tool.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
+import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
+import { 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. `lint()` нижче — lint-поверхня (opa/regal/conftest), імпл інлайн тут.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
 
 /** Шляхи з Rego-полісі (відносно cwd). Існують не всі на ранніх стадіях — фільтруємо нижче. */
 const LINT_TARGETS = ['npm/rules']
@@ -98,6 +110,16 @@ export function runLintRegoSteps(cwd = process.cwd()) {
  */
 export const runLintRego = () => runStandardLint(import.meta.dirname, () => runLintRegoSteps())
 
+/**
+ * Оркестраторний адаптер `n-cursor lint rego`: делегує у `runLintRego`.
+ * @param {string[] | undefined} _files ігнорується (whole-repo аналіз)
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files) {
+  return runLintRego()
+}
+
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintRego()
+  // Standalone: bun rules/rego/main.mjs — повний еквівалент `npx @nitra/cursor check rego`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
 }

package/rules/release/docs/index.md

@@ -10,4 +10,5 @@ resource: npm/rules/release/
 |---|---|
 | [change.mjs](change.md) | JS Module |
 | [fix.mjs](fix.md) | JS Module |
+| [main.mjs](main.md) | JS Module |
 | [release.mjs](release.md) | JS Module |

package/rules/release/docs/main.md

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