@nitra/cursor 12.6.1 → 12.8.0

package/rules/js-lint/{js/lint.mjs → main.mjs}

@@ -1,8 +1,20 @@
 /** @see ./docs/lint.md */
 import { spawnSync } from 'node:child_process'
 
-import { addedLinesByFile } from '../../../scripts/lib/diff-added-lines.mjs'
-import { classifyFindings, parseEslint, parseOxlint, renderFindings } from './lint-findings.mjs'
+import { addedLinesByFile } from '../../scripts/lib/diff-added-lines.mjs'
+import { classifyFindings, parseEslint, parseOxlint, renderFindings } from './js/lint-findings.mjs'
+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); `lint()` нижче — lint-поверхня (oxlint+eslint), імпл інлайн тут.
+ * @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 JS_EXT_RE = /\.(?:mjs|cjs|js|jsx|ts|tsx|vue)$/u
 
@@ -119,3 +131,8 @@ export function lint(files, cwd = process.cwd(), opts = {}) {
   if (js.length === 0) return Promise.resolve(0)
   return Promise.resolve(lintChangedClassified(js, cwd, readOnly))
 }
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/js-lint/main.mjs — повний еквівалент `npx @nitra/cursor check js-lint`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

package/rules/js-lint-ci/docs/fix.md

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

package/rules/js-lint-ci/docs/index.md

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

package/rules/js-lint-ci/docs/main.md

@@ -0,0 +1,27 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/js-lint-ci/main.mjs
+docgen:
+  crc: 59cd2fd3
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль надає інструменти для глибокого аналізу коду. Функція `run` виконує перевірку коду відповідно до заданого контексту прогону. Функція `lint` порівнює файли репозиторію для виявлення дублікатів та неіспользумого коду.
+
+## Поведінка
+
+run виконує перевірку на основі контексту прогону.
+lint виконує крос-файловий аналіз репозиторію на дублікати та мертвий код.
+
+## Публічний API
+
+run — точка входу для виконання правила, що включає перевірку логіки застосування (JS-занепокложення $\to$ політика $\to$ посилання MDC) та аналіз коду (jscpd + knip) по всьому репозиторію.
+lint — аналіз коду по всьому репозиторію на наявність дублікатів (jscpd) та мертвого коду (knip).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/js-lint-ci/js/docs/index.md

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

package/rules/js-lint-ci/main.mjs

@@ -0,0 +1,33 @@
+import { spawnSync } from 'node:child_process'
+
+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); `lint()` — lint-поверхня (jscpd + knip, крос-файловий аналіз).
+ * @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)
+}
+
+/**
+ * lint-поверхня: jscpd (дублікати) + knip (мертвий код) по всьому репо.
+ * @param {string[] | undefined} _files ігнорується (крос-файловий аналіз)
+ * @param {string} [cwd] корінь репо
+ * @returns {Promise<number>} 0 — OK, ≠0 — порушення
+ */
+export function lint(_files, cwd = process.cwd()) {
+  const jscpd = spawnSync('bunx', ['jscpd', '.'], { cwd, stdio: 'inherit' })
+  const jc = typeof jscpd.status === 'number' ? jscpd.status : 1
+  if (jc !== 0) return Promise.resolve(jc)
+  const knip = spawnSync('bunx', ['knip', '--no-config-hints'], { cwd, stdio: 'inherit' })
+  return Promise.resolve(typeof knip.status === 'number' ? knip.status : 1)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/main.mjs — повний еквівалент `npx @nitra/cursor check <id>`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
+}

package/rules/js-mssql/docs/fix.md

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

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

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

package/rules/js-mssql/docs/main.md

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

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

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

package/rules/js-mssql/lib/docs/index.md

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

package/rules/js-mssql/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/js-run/docs/fix.md

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

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

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

package/rules/js-run/docs/main.md

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

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

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

package/rules/js-run/lib/docs/index.md

@@ -6,11 +6,11 @@ resource: npm/rules/js-run/lib/
 
 # npm/rules/js-run/lib
 
-| Файл | Тип |
-|---|---|
-| [bunyan-imports.mjs](bunyan-imports.md) | JS Module |
-| [check-env-scan.mjs](check-env-scan.md) | JS Module |
-| [conn-file-rules.mjs](conn-file-rules.md) | JS Module |
-| [conn-imports-scan.mjs](conn-imports-scan.md) | JS Module |
+| Файл                                                      | Тип       |
+| --------------------------------------------------------- | --------- |
+| [bunyan-imports.mjs](bunyan-imports.md)                   | JS Module |
+| [check-env-scan.mjs](check-env-scan.md)                   | JS Module |
+| [conn-file-rules.mjs](conn-file-rules.md)                 | JS Module |
+| [conn-imports-scan.mjs](conn-imports-scan.md)             | JS Module |
 | [promise-settimeout-scan.mjs](promise-settimeout-scan.md) | JS Module |
-| [temporal-scan.mjs](temporal-scan.md) | JS Module |
+| [temporal-scan.mjs](temporal-scan.md)                     | JS Module |

package/rules/js-run/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/k8s/docs/fix.md

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

package/rules/k8s/docs/index.md

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

package/rules/k8s/docs/main.md

@@ -0,0 +1,40 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/k8s/main.mjs
+docgen:
+  crc: 1caca447
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 85
+---
+
+## Огляд
+
+Модуль знаходить унікальні корені каталогів із іменем `k8s` за шляхами файлів `*.yaml` у репозиторії. Якщо таких файлів немає, виконання завершується з кодом 0 без виклику зовнішніх CLI. Для знайдених коренів виконується перевірка YAML-маніфестів. `kubeconform` перевіряє маніфести проти OpenAPI-схем Kubernetes (https://github.com/yannh/kubeconform#readme), використовуючи версію, узгоджену з лінією релізу. `kubescape` сканує маніфести на misconfiguration та відповідність стандартам (NSA, MITRE, CIS), використовуючи конфігураційний файл `.kubescape-exceptions.json`. Орієнтир цільового кластера для `kubescape` визначається за тією ж лінією релізу, що й для `kubeconform`. Обидві утиліти (`kubeconform` та `kubescape`) повинні бути доступні в системному PATH.
+
+## Поведінка
+
+run виконує стандартну перевірку правила.
+pathHasK8sSegment визначає, чи містить шлях сегмент директорії `k8s` відносно кореня репозиторію.
+k8sRootFromFile знаходить абсолютний шлях до каталогу `…/k8s`, що містить маніфест, виходячи з абсолютного шляху до YAML-файлу.
+findK8sRoots знаходить унікальні абсолютні шляхи до каталогів `k8s` за наявності файлів `*.yaml`, ігноруючи шляхи, що починаються з `.github/`.
+buildKubescapeExceptionsArgs будує аргументи для `kubescape`, якщо існує файл `.kubescape-exceptions.json` у корені репозиторію.
+findKustomizationDirs знаходить абсолютні шляхи до каталогів, що містять білдабельний `kustomization.yaml` у межах каталогу `…/k8s`, виключаючи компоненти (`kind: Component`).
+runLintK8s виконує повний цикл перевірки Kubernetes-маніфестів за допомогою `kubeconform` та `kubescape`.
+lint делегує виконання повного циклу перевірки Kubernetes-маніфестів функції `runLintK8s`.
+
+## Публічний API
+
+run — виконує перевірку конфігурацій (applies → JS-concerns → policy → mdc-refs) та лінтинг (kubeconform/kubescape).
+pathHasK8sSegment — визначає, чи містить шлях сегмент директорії `k8s`.
+k8sRootFromFile — знаходить каталог `…/k8s`, що містить маніфест, рухаючись від файлу вгору.
+findK8sRoots — збирає список унікальних коренів `k8s`, якщо в поточному каталозі є файли `*.yaml`.
+buildKubescapeExceptionsArgs — створює аргументи `--exceptions <file>` для kubescape, якщо існує `.kubescape-exceptions.json` у корені проєкту.
+findKustomizationDirs — знаходить каталоги, які є точками входу Kustomize (містять `kustomization.yaml` з `kind: Kustomization`).
+runLintK8s — виконує публічну CLI-операцію лінтингу конфігурацій, використовуючи механізм блокування та дедуплікації за станом git-дерева.
+lint — слугує оркестратором, який делегує виконання лінтингу конфігурацій (`n-cursor lint k8s`) функції `runLintK8s`.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Свідомо пропускає шляхи: `.github`, `.git`.

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

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/rules/k8s/js
+resource: npm/rules/k8s/js/
+---
+
+# npm/rules/k8s/js
+
+| Файл                      | Тип         |
+| ------------------------- | ----------- |
+| [lint.mjs](lint.md)       | JS Module   |
+| [manifests](manifests.md) | Source File |

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

@@ -2,14 +2,14 @@
  * Запуск kubeconform та kubescape для каталогів `…/k8s`, де є YAML-маніфести (див. k8s.mdc).
  *
  * Знаходить унікальні корені каталогів із іменем `k8s` за шляхами файлів **`*.yaml`**
- * (той самий принцип сегмента `k8s`, що й у rules/k8s/fix.mjs; розширення **`.yml`** під `k8s` не використовується). Якщо таких файлів немає — вихід 0
+ * (той самий принцип сегмента `k8s`, що й у rules/k8s/check.mjs; розширення **`.yml`** під `k8s` не використовується). Якщо таких файлів немає — вихід 0
  * без виклику зовнішніх CLI.
  *
  * kubeconform перевіряє маніфести проти OpenAPI-схем Kubernetes; kubescape — сканування на
  * misconfiguration / compliance (NSA, MITRE, CIS тощо). Обидві утиліти очікуються в PATH
  * (локально: Homebrew, релізи GitHub; у CI — крок установки з k8s.mdc).
  *
- * Версія `-kubernetes-version` для kubeconform узгоджена з PIN yannh у rules/k8s/fix.mjs / k8s.mdc.
+ * Версія `-kubernetes-version` для kubeconform узгоджена з PIN yannh у rules/k8s/check.mjs / k8s.mdc.
  * Kubescape не має аналога цього прапорця; орієнтир цільового кластера — та сама лінія релізу (див. k8s.mdc).
  *
  * Канон патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`) —
@@ -23,12 +23,24 @@ import { basename, dirname, join, relative } from 'node:path'
 
 import { parse } from 'yaml'
 
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { ensureTool } from '../../../scripts/lib/ensure-tool.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.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 { loadCursorIgnorePaths } from '../../scripts/lib/load-cursor-config.mjs'
+import { resolveCmd } from '../../scripts/utils/resolve-cmd.mjs'
+import { walkDir } from '../../scripts/utils/walkDir.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-поверхня (kubeconform/kubescape), імпл інлайн тут.
+ * @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)
+}
 
 /** Per-project kubescape exceptions file; підмішується через --exceptions, якщо існує в корені. */
 const KUBESCAPE_EXCEPTIONS_FILE = '.kubescape-exceptions.json'
@@ -342,11 +354,21 @@ async function runLintK8sSteps() {
 
 /**
  * Публічна CLI-форма: серіалізує через `withLock('lint-k8s')` + дедуп за станом git-дерева.
- * Експортовано як `runLintK8s` — використовується з `bin/n-cursor.js` як підкоманда `lint-k8s`.
+ * Експортовано як `runLintK8s` — викликається через `n-cursor lint k8s` (оркестраторний адаптер `lint()` делегує сюди); окремої bin-підкоманди `lint-k8s` немає.
  * @returns {Promise<number>} код виходу
  */
 export const runLintK8s = () => runStandardLint(import.meta.dirname, runLintK8sSteps)
 
+/**
+ * Оркестраторний адаптер `n-cursor lint k8s`: делегує у `runLintK8s`.
+ * @param {string[] | undefined} _files ігнорується (whole-repo обхід `.../k8s`)
+ * @returns {Promise<number>} exit code
+ */
+export function lint(_files) {
+  return runLintK8s()
+}
+
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintK8s()
+  // Standalone: bun rules/k8s/main.mjs — повний еквівалент `npx @nitra/cursor check k8s`.
+  process.exitCode = await runRuleCli(import.meta.dirname)
 }

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

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

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

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

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/js/docs/index.md

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

package/rules/nginx-default-tpl/js/docs/template.md

@@ -39,11 +39,11 @@ check
 
 findDefaultConfTemplatePaths — Збирає повні шляхи до **default.conf.template** у репозиторії; виключає будь-який сегмент `fixtures/` (включаючи `tests/fixtures/` та ко-локальні шляхи `rules/<rule>/js/<concern>/fixtures/`).
 migrateDefaultTplConfFiles — Знаходить **default.tpl.conf** у дереві від `root`. Якщо **default.conf.template** відсутній, перейменовує **default.tpl.conf**; якщо він присутній, перезаписує **default.conf.template** вмістом **default.tpl.conf** та видаляє **default.tpl.conf**.
-migrateErrorLogOffDirective — Замінює невалідну директиву `error_log off;` на `error_log /dev/null crit;` у всіх **default.conf.template** від `root**. `error_log off;` трактується як ім'я файлу (`/etc/nginx/off`), що призводить до помилки `readOnlyRootFilesystem`. `/dev/null` — це записуваний пристрій.
+migrateErrorLogOffDirective — Замінює невалідну директиву `error_log off;` на `error_log /dev/null crit;` у всіх **default.conf.template** від `root**. `error_log off;` трактується як ім'я файлу (`/etc/nginx/off`), що призводить до помилки `readOnlyRootFilesystem`. `/dev/null`— це записуваний пристрій.
 parseIniVariableNames — Витягує імена змінних з файлів ini (рядки у форматі KEY=value, без коментарів і порожніх).
 nginxTemplateViolations — Перевіряє вміст **default.conf.template** на відповідність вимогам **nginx-default-tpl.mdc**.
 httpRouteMatchesNginxDefaultTpl — Перевіряє, чи відповідає **HTTPRoute** патерну Exact→RequestRedirect + PathPrefix→backendRefs.
-iniKeysMissingInTemplate — Перевіряє, чи входять усі імена ключів з ini до шаблону у форматі `$KEY` (використовуючи envsubst).
+iniKeysMissingInTemplate — Перевіряє, чи входять усі імена ключів з ini до шаблону у форматі`$KEY` (використовуючи envsubst).
 check — Перевіряє відповідність проєкту правилам **nginx-default-tpl.mdc**.
 
 ## Гарантії поведінки