@nitra/cursor 12.6.1 → 12.8.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/.pi-template/extensions/n-cursor-adr/docs/index.md

@@ -17,8 +17,8 @@ docgen:
 4. Запис JSONL файлу. Запис серіалізованого тексту у тимчасову директорію.
 5. Формування вхідного навантаження. Створення JSON об'єкта для передачі у башку.
 6. Передача виконання скриптів. Паралельний запуск двох окремих скриптів.
-    а. Виконання хука capture.
-    б. Виконання хука normalize.
+   а. Виконання хука capture.
+   б. Виконання хука normalize.
 7. Обробка результатів. Очікування завершення обох виконання. Помилки обробляються у загальному режимі.
 
 ## Гарантії поведінки

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [12.8.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.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
@@ -139,7 +159,7 @@
 
 ### Changed
 
-- Конформність-селекція: .n-cursor.json — єдине джерело правди. resolveCheckRuleIds бере активні правила прямо з конфіга (available ∩ enabled), .cursor/rules/*.mdc лишається лише fallback'ом коли конфіга нема. Прибрано дрейф «правило enabled, але .mdc нема → тихо пропущено». Per-rule whitelist-гейт у runRuleCli видалено як дубль — гейтинг живе виключно у селекції.
+- Конформність-селекція: .n-cursor.json — єдине джерело правди. resolveCheckRuleIds бере активні правила прямо з конфіга (available ∩ enabled), .cursor/rules/\*.mdc лишається лише fallback'ом коли конфіга нема. Прибрано дрейф «правило enabled, але .mdc нема → тихо пропущено». Per-rule whitelist-гейт у runRuleCli видалено як дубль — гейтинг живе виключно у селекції.
 
 ## [10.0.1] - 2026-06-14
 
@@ -151,7 +171,7 @@
 
 ### Changed
 
-- Інлайн _fix-check/fix-t0 у прямі функції — видалено внутрішні subcommand'и. runFixCheck (scripts/lib/fix/run-fix-check) + listProjectRulesMdcFiles винесено з bin; orchestrator/t0/PostToolUse-хук/lint-конформність кличуть прямо (без subprocess-обгортки). Per-rule ізоляція збережена
+- Інлайн \_fix-check/fix-t0 у прямі функції — видалено внутрішні subcommand'и. runFixCheck (scripts/lib/fix/run-fix-check) + listProjectRulesMdcFiles винесено з bin; orchestrator/t0/PostToolUse-хук/lint-конформність кличуть прямо (без subprocess-обгортки). Per-rule ізоляція збережена
 
 ## [9.4.0] - 2026-06-14
 
@@ -211,7 +231,7 @@
 
 ### Removed
 
-- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/_fix-check лишаються внутрішніми фазами движка
+- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/\_fix-check лишаються внутрішніми фазами движка
 
 ## [6.0.0] - 2026-06-14
 
@@ -244,7 +264,7 @@
 
 ### Changed
 
-- ✨ feat(npm/skills/doc-files): doc-files: підтримка Rust (.rs) — SOURCE_…
+- ✨ feat(npm/skills/doc-files): doc-files: підтримка Rust (.rs) — SOURCE\_…
 
 ## [5.3.2] - 2026-06-11
 
@@ -280,7 +300,7 @@
 
 ### Fixed
 
-- lint: санація шарів, що ховалися за першим падінням oxlint — повний bun run lint доведено до lint-js/style зелених: JSDoc/regex/sonarjs фікси у ~25 файлах, slow-regex обмежено bounded-квантифікаторами, eslint ignore для згенерованих docs/*.md, jscpd ignore (.git, COVERAGE.md, docs, відомі легасі-клони), knip ignoreBinaries (pi/claude/fix-t0), stylelint/cspell ignore згенерованих артефактів; docgen-ignore у doc-aggregate став re-export з doc-files
+- lint: санація шарів, що ховалися за першим падінням oxlint — повний bun run lint доведено до lint-js/style зелених: JSDoc/regex/sonarjs фікси у ~25 файлах, slow-regex обмежено bounded-квантифікаторами, eslint ignore для згенерованих docs/\*.md, jscpd ignore (.git, COVERAGE.md, docs, відомі легасі-клони), knip ignoreBinaries (pi/claude/fix-t0), stylelint/cspell ignore згенерованих артефактів; docgen-ignore у doc-aggregate став re-export з doc-files
 
 ## [5.1.0] - 2026-06-10
 

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'
@@ -636,7 +623,7 @@ function buildClaudeLintParallelismSectionLines() {
     '',
     '## Лінт і ESLint (паралелізм)',
     '',
-    'Паралельний лінт по **різних** файлах — **дозволено**: диз\'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
+    "Паралельний лінт по **різних** файлах — **дозволено**: диз'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.",
     ''
   ]
 }
@@ -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/index.md

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

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

@@ -6,9 +6,9 @@ resource: npm/lib/
 
 # npm/lib
 
-| Файл | Тип |
-|---|---|
-| [llm.mjs](llm.md) | JS Module |
-| [models.mjs](models.md) | JS Module |
+| Файл                            | Тип       |
+| ------------------------------- | --------- |
+| [llm.mjs](llm.md)               | JS Module |
+| [models.mjs](models.md)         | JS Module |
 | [omlx-trace.mjs](omlx-trace.md) | JS Module |
-| [omlx.mjs](omlx.md) | JS Module |
+| [omlx.mjs](omlx.md)             | JS Module |

package/lib/docs/llm.md

@@ -25,10 +25,10 @@ omlxHealthCheck
 pickBackend — Бекенд для model-id: `omlx` — прямий HTTP, `pi` — CLI.
 callLlm — Універсальний виклик LLM з маршрутизацією за префіксом model-id і постійне відстеження (wire-trace) обох каналів.
 omlxHealthCheck — Перевірка omlx перед масовим прогоном через мінімальний чат-виклик (`max_tokens: 1`). Розрізняє стани:
-  down — Сервер не відповідає (не запущений / не той порт).
-  memory-guard — Модель не влазить у динамічну стелю пам'яті зайнятої машини — відкладає прогін.
-  auth — Сервер вимагає API-ключ — виставляє `N_CURSOR_OMLX_KEY`.
-  error — Інша помилка API.
+down — Сервер не відповідає (не запущений / не той порт).
+memory-guard — Модель не влазить у динамічну стелю пам'яті зайнятої машини — відкладає прогін.
+auth — Сервер вимагає API-ключ — виставляє `N_CURSOR_OMLX_KEY`.
+error — Інша помилка API.
 Порожній контент відповіді — означає, що сервер живий і модель завантажена.
 
 ## Гарантії поведінки

package/package.json

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

package/rules/abie/docs/fix.md

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

package/rules/abie/docs/index.md

@@ -6,6 +6,7 @@ resource: npm/rules/abie/
 
 # npm/rules/abie
 
-| Файл | Тип |
-|---|---|
-| [fix.mjs](fix.md) | JS Module |
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [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/js/docs/index.md

@@ -6,11 +6,11 @@ resource: npm/rules/abie/js/
 
 # npm/rules/abie/js
 
-| Файл | Тип |
-|---|---|
-| [applies.mjs](applies.md) | JS Module |
-| [env_dns.mjs](env_dns.md) | JS Module |
+| Файл                                        | Тип       |
+| ------------------------------------------- | --------- |
+| [applies.mjs](applies.md)                   | JS Module |
+| [env_dns.mjs](env_dns.md)                   | JS Module |
 | [firebase_hosting.mjs](firebase_hosting.md) | JS Module |
-| [hc_pairing.mjs](hc_pairing.md) | JS Module |
-| [ua_http_route.mjs](ua_http_route.md) | JS Module |
+| [hc_pairing.mjs](hc_pairing.md)             | JS Module |
+| [ua_http_route.mjs](ua_http_route.md)       | JS Module |
 | [ua_node_selector.mjs](ua_node_selector.md) | JS Module |

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

@@ -6,13 +6,13 @@ resource: npm/rules/abie/lib/
 
 # npm/rules/abie/lib
 
-| Файл | Тип |
-|---|---|
-| [enabled.mjs](enabled.md) | JS Module |
-| [env-dns.mjs](env-dns.md) | JS Module |
-| [hc-yaml.mjs](hc-yaml.md) | JS Module |
-| [http-route.mjs](http-route.md) | JS Module |
-| [k8s-tree.mjs](k8s-tree.md) | JS Module |
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [enabled.mjs](enabled.md)                             | JS Module |
+| [env-dns.mjs](env-dns.md)                             | JS Module |
+| [hc-yaml.mjs](hc-yaml.md)                             | JS Module |
+| [http-route.mjs](http-route.md)                       | JS Module |
+| [k8s-tree.mjs](k8s-tree.md)                           | JS Module |
 | [kustomization-patches.mjs](kustomization-patches.md) | JS Module |
-| [overlay-paths.mjs](overlay-paths.md) | JS Module |
-| [yaml.mjs](yaml.md) | JS Module |
+| [overlay-paths.mjs](overlay-paths.md)                 | JS Module |
+| [yaml.mjs](yaml.md)                                   | JS Module |

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)
 }