@nitra/cursor 12.6.0 → 12.7.0

package/.claude-template/settings.template.json

@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx --no @nitra/cursor post-tool-use-fix",
+            "command": "npx --no @nitra/cursor post-tool-use-check",
             "timeout": 300
           }
         ]

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [12.7.0] - 2026-06-21
+
+### Added
+
+- doc-files: orphan-detect і auto-purge — `lint-doc-files` і `fix-doc-files` тепер виявляють і видаляють `docs/<stem>.md` чиї source-файли більше не існують
+
+### Changed
+
+- Переміщено логіку linting до `js` та оновив `n-cursor.js
+
+## [12.6.1] - 2026-06-21
+
+### Changed
+
+- Оновлено text rule docs і helper-приклади на n-cursor lint text без package.json lint-text wrapper.
+
 ## [12.6.0] - 2026-06-21
 
 ### Changed

package/bin/docs/n-cursor.md

@@ -5,7 +5,7 @@
 Файл `npm/bin/n-cursor.js` — це виконуваний скрипт (shebang `#!/usr/bin/env node`), що слугує єдиною точкою входу CLI пакета `@nitra/cursor`. Скрипт виконує дві ролі:
 
 1. **Синхронізатор пакетних артефактів у проєкті-споживачі** — без аргументів копіює `.mdc`-правила, скіли, slash-команди, генерує `AGENTS.md`, `CLAUDE.md`, синхронізує `.claude/settings.json`, `.cursor/hooks.json`, composite GitHub Action `setup-bun-deps`, `.pi/skills`, а також `.gitignore` для `.worktrees/`.
-2. **Маршрутизатор підкоманд** — диспатчить `fix`, `check`, `rename-yaml-extensions`, `post-tool-use-fix`, `lint`, `lint-ci`, `lint-ga`, `lint-rego`, `lint-k8s`, `lint-docker`, `lint-text`, `coverage`, `change`, `release`, `skill`, `worktree`, `trace`, `docgen` у відповідні внутрішні модулі пакета.
+2. **Маршрутизатор підкоманд** — диспатчить `fix`, `check`, `rename-yaml-extensions`, `post-tool-use-fix`, `lint`, `lint-ci`, `lint-doc-files`, `fix-doc-files`, `coverage`, `coverage-fix`, `analyze-escalation`, `taze`, `start-check`, `change`, `release`, `skill`, `worktree`, `trace`, `doc-aggregate`, `adr-normalize-local` у відповідні внутрішні модулі пакета.
 
 Скрипт — ES-модуль (`import` синтаксис). Виконує реальні файлові операції в `cwd()` і у каталогах пакету (`BUNDLED_PACKAGE_ROOT`). Усі шляхи відносно поточної робочої директорії проєкту-споживача.
 
@@ -17,13 +17,8 @@
 - `npx @nitra/cursor check` — deprecated alias для `fix` (виводить попередження).
 - `npx @nitra/cursor rename-yaml-extensions` — перейменування `*.yml`/`*.yaml` у k8s/.github (підтримує `--dry-run`, `--root=…`).
 - `npx @nitra/cursor post-tool-use-fix` — entry point PostToolUse hook Claude Code: читає JSON зі stdin, маршрутизує `tool_input.file_path` у релевантні правила.
-- `npx @nitra/cursor lint` — оркестратор `lint-*` / `oxfmt` ланцюжка з вимірюванням таймінгу (fail-fast).
-- `npx @nitra/cursor lint-ci` — те саме, але режим CI.
-- `npx @nitra/cursor lint-ga` — канонічний `lint-ga` (shellcheck preflight → `bunx github-actionlint` → `uvx zizmor --offline --collect=workflows .`).
-- `npx @nitra/cursor lint-rego` — канонічний `lint-rego` (`opa check --strict` → `regal lint` → опційно `conftest verify`).
-- `npx @nitra/cursor lint-k8s` — канонічний `lint-k8s` (`kubeconform` + `kubescape`).
-- `npx @nitra/cursor lint-docker` — канонічний `lint-docker` (`hadolint`).
-- `npx @nitra/cursor lint-text` — канонічний `lint-text` (`cspell` → `shellcheck` з auto-fix → `markdownlint-cli2 --fix` → `v8r`).
+- `npx @nitra/cursor lint` — data-driven оркестратор lint+конформності: `--full` (весь репо, включно з `full`-правилами), `--read-only` (CI, нуль мутацій); без прапорів — per-file дельта vs origin.
+- `npx @nitra/cursor lint-ci` — те саме у CI-режимі.
 - `npx @nitra/cursor coverage [--fix] [--changed]` — оркестратор покриття та мутаційного тестування.
 - `npx @nitra/cursor change` — створення change-файлу.
 - `npx @nitra/cursor release` — реліз-команда.
@@ -60,7 +55,6 @@
 - `discoverCheckRulesFromCursorRules` зі `scripts/lib/discover-check-rules-from-cursor.mjs`
 - `listRuleIds` зі `scripts/lib/list-rule-ids.mjs`
 - `ensureNitraCursorInRootDevDependencies` зі `scripts/ensure-nitra-cursor-dev-dependencies.mjs`
-- `runLintDocker`, `runLintGaCli`, `runLintK8s`, `runLintRego`, `runLintTextCli` — з `rules/*/lint/lint.mjs`
 - `syncClaudeConfig` зі `scripts/sync-claude-config.mjs`
 - `syncGitignoreWorktree` зі `scripts/lib/sync-gitignore-worktree.mjs`
 - `upgradeNitraCursorToLatestAndBunInstall` зі `scripts/upgrade-nitra-cursor-and-install.mjs`
@@ -465,13 +459,8 @@ try {
 - `'check'` → друкує deprecated-попередження й виконує `runFixCommand(args)`.
 - `'rename-yaml-extensions'` → `runRenameYamlExtensionsCli(args)`; якщо повернений код `!== 0`, `process.exitCode = 1`.
 - `'post-tool-use-fix'` → `runPostToolUseFixCli()` (PostToolUse hook Claude Code, читає stdin); `process.exitCode` = повернений код.
-- `'lint'` → `runLint({ ci: false })`.
+- `'lint'` → `runLint({ full, readOnly, rules })` (прапори `--full`, `--read-only`; позиційні аргументи — фільтр правил конформності).
 - `'lint-ci'` → `runLint({ ci: true })`.
-- `'lint-ga'` → `runLintGaCli()` (`await` обовʼязковий — `check-ga` async).
-- `'lint-rego'` → `runLintRego()`.
-- `'lint-k8s'` → `runLintK8s()`.
-- `'lint-docker'` → `runLintDocker()`.
-- `'lint-text'` → `runLintTextCli()`.
 - `'coverage'` → динамічний import `../rules/test/coverage/coverage.mjs`, виклик `runCoverageCli({ fix: args.includes('--fix'), changed: args.includes('--changed') })`.
 - `'change'` → динамічний import `../rules/release/change.mjs` → `runChangeCli(args)`.
 - `'release'` → динамічний import `../rules/release/release.mjs` → `runReleaseCli(args)`.
@@ -516,11 +505,6 @@ try {
 - `../scripts/lib/discover-check-rules-from-cursor.mjs` — `discoverCheckRulesFromCursorRules`.
 - `../scripts/lib/list-rule-ids.mjs` — `listRuleIds`.
 - `../scripts/ensure-nitra-cursor-dev-dependencies.mjs` — `ensureNitraCursorInRootDevDependencies`.
-- `../rules/docker/lint/lint.mjs` — `runLintDocker`.
-- `../rules/ga/lint/lint.mjs` — `runLintGaCli`.
-- `../rules/k8s/lint/lint.mjs` — `runLintK8s`.
-- `../rules/rego/lint/lint.mjs` — `runLintRego`.
-- `../rules/text/lint/lint.mjs` — `runLintTextCli`.
 - `../scripts/sync-claude-config.mjs` — `syncClaudeConfig`.
 - `../scripts/lib/sync-gitignore-worktree.mjs` — `syncGitignoreWorktree`.
 - `../scripts/upgrade-nitra-cursor-and-install.mjs` — `upgradeNitraCursorToLatestAndBunInstall`.

package/bin/n-cursor.js

@@ -7,7 +7,7 @@
  *   `npx \@nitra/cursor`             — завантажити cursor-правила (синк); якщо в корені вже є `.n-cursor.json`,
  *                                     спочатку зчитується конфіг і за потреби дописується `$schema`
  *   `npx \@nitra/cursor rename-yaml-extensions` — k8s `*.yml` → `*.yaml`, `.github` `*.yaml` → `*.yml` (опції: `--dry-run`, `--root=…`; див. bin/rename-yaml-extensions.mjs)
- *   `npx \@nitra/cursor post-tool-use-fix` — точка входу PostToolUse hook Claude Code: читає stdin JSON,
+ *   `npx \@nitra/cursor post-tool-use-check` — точка входу PostToolUse hook Claude Code: читає stdin JSON,
  *                                     дістає `tool_input.file_path`, маршрутизує його у відповідні правила
  *                                     (`*.mjs` → `js-lint`, `*.vue` → `js-lint style-lint vue` тощо) і викликає
  *                                     `fix` лише з ними. Прописується автоматично в `.claude/settings.json`.
@@ -16,14 +16,6 @@
  *                                     весь репо (`per-file` ∪ `full`); `--read-only` = без мутацій/LLM (CI); позиційні
  *                                     (не-флаг) аргументи — фільтр правил конформності (мапить колишній `fix <rule>`).
  *                                     CI = `lint --read-only --full` (весь репо, нуль мутацій/LLM).
- *   `npx \@nitra/cursor lint-ga`     — канонічний lint-ga (ga.mdc): preflight на `shellcheck` →
- *                                     `bunx github-actionlint` → `uvx zizmor --offline --collect=workflows .`
- *   `npx \@nitra/cursor lint-rego`   — канонічний lint-rego (conftest.mdc + rego.mdc):
- *                                     preflight на `opa`/`regal` → `opa check --strict` → `regal lint` → опц. `conftest verify`
- *   `npx \@nitra/cursor lint-k8s`    — канонічний lint-k8s (k8s.mdc): `kubeconform` + `kubescape` по `…/k8s/*.yaml`
- *   `npx \@nitra/cursor lint-docker` — канонічний lint-docker (docker.mdc): `hadolint` по `Dockerfile`/`*.Dockerfile`
- *   `npx \@nitra/cursor lint-text`   — канонічний lint-text (text.mdc): `cspell` → `shellcheck` (з auto-fix) →
- *                                     `markdownlint-cli2 --fix` → `v8r` (json/json5/yaml/yml/toml)
  *   `npx \@nitra/cursor lint-doc-files`  — детермінований детектор застарілості файлових док (`stale`: `missing`|`crc-mismatch`); правило doc-files (ignore-glob у `npm/rules/doc-files/js/docgen-ignore.mjs`; тека `docs/` поряд із джерелом). Режими: повний (exit 1), `--json` (exit 0), `--missing-only`, `--hook`/`--git` (hook-протокол, exit 2), `--degraded`
  *   `npx \@nitra/cursor fix-doc-files`   — JS-оркестрована генерація файлових док (роутинг local/cloud) зі штампом CRC (`--limit`/`--from`/`--overwrite`); `--stamp` — детерміноване перештампування CRC без LLM
  *   `npx \@nitra/cursor doc-aggregate modules` — JSON-лістинг логічних модулів (межі за `package.json`) для Tier 2 скілу doc-aggregate
@@ -94,22 +86,17 @@ import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { readSkillMetaRaw } from '../scripts/lib/skill-meta.mjs'
 import { injectWorktreeNotice } from '../scripts/lib/worktree-notice.mjs'
 import { injectRootNotice } from '../scripts/lib/root-notice.mjs'
-import { runPostToolUseFixCli } from '../scripts/post-tool-use-fix.mjs'
+import { runPostToolUseCheckCli } from '../scripts/post-tool-use-check.mjs'
 import { listProjectRulesMdcFiles } from '../scripts/lib/list-project-rules-mdc.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { assertCwdIsProjectRoot } from '../scripts/lib/assert-project-root.mjs'
-import { runLintDocker } from '../rules/docker/lint/lint.mjs'
-import { runLintGaCli } from '../rules/ga/lint/lint.mjs'
-import { runLintK8s } from '../rules/k8s/lint/lint.mjs'
-import { runLintRego } from '../rules/rego/lint/lint.mjs'
-import { runLintTextCli } from '../rules/text/lint/lint.mjs'
 import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
 import { syncGitignoreWorktree } from '../scripts/lib/sync-gitignore-worktree.mjs'
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
 import { runSkillsCli } from '../scripts/skills-cli.mjs'
 import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
-import { runLint } from '../rules/lint/js/orchestrate.mjs'
+import { runLint } from '../scripts/lib/run-lint.mjs'
 
 const PACKAGE_NAME = '@nitra/cursor'
 const CONFIG_FILE = '.n-cursor.json'
@@ -1527,10 +1514,10 @@ try {
 
       break
     }
-    case 'post-tool-use-fix': {
+    case 'post-tool-use-check': {
       // Викликається з .claude/settings.json як PostToolUse hook Claude Code.
       // Маршрутизує змінений файл у релевантні правила і прокидає `fix` лише з ними.
-      const code = await runPostToolUseFixCli()
+      const code = await runPostToolUseCheckCli()
       process.exitCode = code
 
       break
@@ -1548,39 +1535,6 @@ try {
 
       break
     }
-    case 'lint-ga': {
-      // Канонічний lint-ga з preflight на shellcheck → actionlint → zizmor → check-ga (ga.mdc).
-      // Останній крок (check-ga) async — тому await обов'язковий, інакше process.exitCode буде Promise.
-      process.exitCode = await runLintGaCli()
-
-      break
-    }
-    case 'lint-rego': {
-      // Канонічний lint-rego: preflight opa/regal → opa check --strict → regal lint → conftest verify (опц.).
-      process.exitCode = await runLintRego()
-
-      break
-    }
-    case 'lint-k8s': {
-      // Канонічний lint-k8s: kubeconform + kubescape по знайдених деревах `…/k8s/*.yaml`.
-      process.exitCode = await runLintK8s()
-
-      break
-    }
-    case 'lint-docker': {
-      // Канонічний lint-docker: hadolint по Dockerfile та *.Dockerfile (docker.mdc).
-      process.exitCode = await runLintDocker()
-
-      break
-    }
-    case 'lint-text': {
-      // Канонічний lint-text: cspell → shellcheck → dotenv → markdownlint → v8r (text.mdc).
-      // `--read-only` (CI): без авто-фіксу (markdownlint/shellcheck/dotenv) — нуль мутацій.
-      // `llmFix:true` — text llmFix-capable, тож standalone lint-text робить omlx-класифікацію cspell.
-      process.exitCode = await runLintTextCli({ readOnly: args.includes('--read-only'), llmFix: true })
-
-      break
-    }
     case 'coverage': {
       // n-cursor coverage — оркестратор покриття + мутаційного тестування з discovery
       // провайдерів через .n-cursor.json#rules (test.mdc). --changed звужує scope до
@@ -1655,7 +1609,7 @@ try {
       // n-cursor lint-doc-files — детермінований детектор застарілості файлових док
       // (missing ∪ crc-mismatch). Режими: (повний) exit 1, --json exit 0, --missing-only,
       //   --hook/--git/--degraded — hook-протокол (exit 2/0). Деталі — doc-files.mdc.
-      const { runLintDocFilesCli } = await import('../rules/doc-files/lint/lint.mjs')
+      const { runLintDocFilesCli } = await import('../rules/doc-files/main.mjs')
       process.exitCode = await runLintDocFilesCli(args)
 
       break
@@ -1706,7 +1660,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-fix, adr-normalize-local, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, analyze-escalation, taze, start-check, change, release, skill, trace, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-check, adr-normalize-local, lint (включно зі scope: lint ga|rego|k8s|docker|text), lint-doc-files, fix-doc-files, coverage, coverage-fix, analyze-escalation, taze, start-check, change, release, skill, trace, doc-aggregate`
       )
       process.exitCode = 1
     }

package/docs/stryker.config.md

@@ -3,39 +3,31 @@ type: JS Module
 title: stryker.config.mjs
 resource: npm/stryker.config.mjs
 docgen:
-  crc: b8c7377b
+  crc: 2f4ed270
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Цей файл містить дані про користувачів системи. Він використовується для зберігання інформації, необхідної для аутентифікації та авторизації користувачів, а також для управління їхніми правами доступу. Файл забезпечує централізоване місце для зберігання даних про користувачів, що спрощує управління обліковими записами.
+## Огляд
+
+Цей файл конфігурує процес тестування та мутаційного аналізу, використовуючи Vitest як тестовий раннер. Він визначає, які файли підлягають мутації (у `scripts`, `rules`, `bin`) та які виключаються, спираючись на `mutation.json`. Конфігурація налаштовує Stryker для запуску лише тестів, що покривають мутовані рядки. Також конфігурація використовує `incremental.json` для збереження даних між запусками.
 
 ## Поведінка
 
-1.  Створює директорію `reports/stryker/.tmp` для тимчасових результатів тестування.
-2.  Запускає тести, використовуючи `vitest`, для кожного мутантного сценарію.
-3.  Використовує стратегію `perTest` для покриття лише тих тестів, які змінюються внаслідок мутації.
-4.  Аналізує результати тестування та генерує JSON-файл `mutation.json` з інформацією про покриття коду.
-5.  Зберігає результати тестування в файлі `incremental.json` для відновлення після збоїв та прискорення подальших проходів.
-6.  Мутує наступні файли: `scripts/**/*.mjs`, `rules/**/*.mjs`, `bin/**/*.{js,mjs}`.
-7.  Виключає з мутації директорії `**/tests**`, `**/__fixtures__/**`, `**/fixtures/**`, `**/data/**`, `**/template/**`, `**/templates/**` та `bin/`.
-8.  Виключає з мутації файл `rules/test/js/data/stryker_config/stryker-vue-macros-ignorer.mjs`.
-9.  Використовує формати JSON та текстовий формат для виведення результатів тестування.
+1. Визначає тестовий раннер як Vitest.
+2. Вказує конфігураційний файл для Vitest.
+3. Налаштовує аналіз покриття так, що Stryker запускає лише тести, що покривають мутовану лінію.
+4. Встановлює тимчасову директорію для звітів Stryker.
+5. Визначає репортери для виводу результатів у форматі JSON та звичайному тексті.
+6. Вказує ім'я файлу для JSON-звіту.
+7. Вмикає функціонал збереження результатів між запусками, використовуючи файл `incremental.json`.
+8. Визначає список файлів, які підлягають мутації:
+    * Файли у директорії `scripts`.
+    * Файли у директорії `rules`.
+    * Файли у директорії `bin`.
+9. Виключає з мутації файли у директоріях `tests`, `__fixtures__`, `fixtures`, `data`, `template`, `templates`.
+10. Виключає з мутації файли у директорії `data`, крім файлу `stryker-vue-macros-ignorer.mjs` у директорії `rules/test/js/data/stryker_config/`.
 
 ## Гарантії поведінки
 
-- Зміна значення неможлива.
-- Зміна значення не впливає на інші частини коду.
-- Зміна значення не призводить до помилок.
-- Зміна значення не впливає на стан системи.
-- Зміна значення не впливає на інші поточні операції.
-- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
-- Зміна значення не впливає на будь-які зовнішні системи.
-- Зміна значення не призводить до непередбачуваної поведінки.
-- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
-- Зміна значення не впливає на будь-які зовнішні системи.
-- Зміна значення не призводить до непередбачуваної поведінки.
-- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
-- Зміна значення не впливає на будь-які зовнішні системи.
-- Зміна значення не призводить до непередбачуваної поведінки.
-- Зміна значення не впливає на будь-які дані, які можуть бути використані в майбутньому.
-- Зміна значення не впливає на будь-які зовнішні системи.
-- Зміна
+- (специфічних машинно-виведених гарантій немає)

package/package.json

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

package/rules/abie/docs/index.md

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

package/rules/abie/docs/main.md

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

package/rules/abie/{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/adr/docs/index.md

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

package/rules/adr/docs/main.md

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

package/rules/adr/{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/bun/docs/index.md

@@ -9,3 +9,4 @@ resource: npm/rules/bun/
 | Файл | Тип |
 |---|---|
 | [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/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/index.md

@@ -9,3 +9,4 @@ resource: npm/rules/capacitor/
 | Файл | Тип |
 |---|---|
 | [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/{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/index.md

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