@nitra/cursor 12.6.0 → 12.7.0

package/scripts/lib/read-n-cursor-config-lite.mjs

@@ -1,12 +1,12 @@
 /**
- * Light read-only `.n-cursor.json` reader для standalone `fix.mjs` invocation.
+ * Light read-only `.n-cursor.json` reader для standalone `check.mjs` invocation.
  *
  * НЕ робить auto-rules detection, merge, schema sync — це справа повного `readConfig` у CLI.
  * Тут лише: прочитати файл (якщо є), повернути `{ rules: string[], disableRules: string[] }`.
  *
  * Спостереження whitelist:
  *   - якщо `.n-cursor.json` НЕМАЄ → правило вважається enabled (поведінка "open by default"),
- *     щоб `bun rules/<id>/fix.mjs` з будь-якої тимчасової директорії працювало для debug.
+ *     щоб `bun rules/<id>/check.mjs` з будь-якої тимчасової директорії працювало для debug.
  *   - якщо файл є з `rules:[…]`, але правила там немає → правило не enabled.
  *   - якщо правило в `disable-rules` → не enabled, навіть якщо у `rules:[…]`.
  */

package/scripts/lib/run-lint-step.mjs

@@ -3,7 +3,7 @@
  * команди і прокидає stdout/stderr на користувацькі stream-и (`stdio: 'inherit'`), щоб виглядало
  * як прямий виклик у shell.
  *
- * Використовується з `n-cursor lint-ga`, `n-cursor lint-text` та інших підкоманд, щоб не дублювати
+ * Використовується з rule-адаптерів `n-cursor lint <rule>`, щоб не дублювати
  * одну й ту саму обгортку у кожному `rules/<id>/js/lint.mjs` (jscpd-clone).
  */
 import { spawnSync } from 'node:child_process'

package/{rules/lint/js/orchestrate.mjs → scripts/lib/run-lint.mjs}

@@ -1,19 +1,40 @@
-/** @see ./docs/orchestrate.md */
+/** @see ./docs/run-lint.md */
 import { existsSync, readdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { cwd as processCwd } from 'node:process'
 import { spawnSync } from 'node:child_process'
 
-import { parseRuleLintSpec, readRuleMetaRaw } from '../../../scripts/lib/rule-meta.mjs'
-import { collectChangedFilesSince, resolveChangedBase } from '../../../scripts/lib/changed-files.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { isRuleEnabled, readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { parseRuleLintSpec, readRuleMetaRaw } from './rule-meta.mjs'
+import { collectChangedFilesSince, resolveChangedBase } from './changed-files.mjs'
+import { resolveCmd } from '../utils/resolve-cmd.mjs'
+import { isRuleEnabled, readNCursorConfigLite } from './read-n-cursor-config-lite.mjs'
 
-// Цей файл: npm/rules/lint/js/orchestrate.mjs → PACKAGE_ROOT = npm (чотири dirname угору).
-const PACKAGE_ROOT = dirname(dirname(dirname(dirname(fileURLToPath(import.meta.url)))))
+// Цей файл: npm/scripts/lib/run-lint.mjs → PACKAGE_ROOT = npm (два dirname угору).
+const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 const RULES_DIR = join(PACKAGE_ROOT, 'rules')
 
+/**
+ * Чи має правило лінт-поверхню — `meta.json#lint` задано (`per-file`/`full`).
+ * Канонічний сигнал (ADR 2026-06-21): gate за meta, не за наявністю файлу.
+ * @param {Record<string, unknown> | undefined} raw meta-обʼєкт правила
+ * @returns {boolean} true — правило лінтить
+ */
+function hasLintSurface(raw) {
+  return parseRuleLintSpec(raw?.lint) !== null
+}
+
+/**
+ * Резолвить лінт-entrypoint правила: `main.mjs` з експортом `lint` (канон, ADR 2026-06-21).
+ * @param {string} rulesDir каталог rules
+ * @param {string} id rule-id
+ * @returns {string | null} шлях до `main.mjs`, або null якщо файлу нема
+ */
+function resolveLintEntrypoint(rulesDir, id) {
+  const main = join(rulesDir, id, 'main.mjs')
+  return existsSync(main) ? main : null
+}
+
 /**
  * Конформність-фаза lint (whole-repo: config/file/workflow conformance — те, що раніше робив `fix`).
  * Per-file декомпозиції немає, тож виконується лише у `--full`.
@@ -27,11 +48,11 @@ const RULES_DIR = join(PACKAGE_ROOT, 'rules')
  */
 async function runConformance(cwd, readOnly, log, filter = []) {
   if (!readOnly) {
-    const { runOrchestratorCli } = await import('../../../scripts/lib/fix/orchestrator.mjs')
+    const { runOrchestratorCli } = await import('./fix/orchestrator.mjs')
     return runOrchestratorCli(filter, cwd)
   }
-  const { runFixCheck } = await import('../../../scripts/lib/fix/run-fix-check.mjs')
-  const { rules } = await runFixCheck(filter, cwd)
+  const { runConformanceCheck } = await import('./fix/run-conformance-check.mjs')
+  const { rules } = await runConformanceCheck(filter, cwd)
   const failed = rules.filter(x => !x.ok)
   if (failed.length === 0) return 0
   log(`❌ lint: конформність — ${failed.length} порушень: ${failed.map(x => x.ruleId).join(', ')}\n`)
@@ -97,9 +118,9 @@ async function runPerFileRules(ids, ctx) {
   const { rulesDir, changed, cwd, readOnly, metaById, log } = ctx
   let worst = 0
   for (const id of ids) {
-    const lintPath = join(rulesDir, id, 'js', 'lint.mjs')
-    if (!existsSync(lintPath)) {
-      log(`⚠️  lint: правило ${id} має lint-фазу, але немає js/lint.mjs — пропускаю.\n`)
+    const lintPath = resolveLintEntrypoint(rulesDir, id)
+    if (!lintPath) {
+      log(`⚠️  lint: правило ${id} має lint-фазу (meta.lint), але немає main.mjs — пропускаю.\n`)
       continue
     }
     // lintPath = join(rulesDir, id, …) — суто package-internal (rulesDir пакета + id зі
@@ -128,7 +149,7 @@ async function runPerFileRules(ids, ctx) {
  */
 async function runFullConformancePhase(cwd, readOnly, log) {
   const { escalationLogSize, maybeAnalyzeEscalation, reportRunStats } = await import(
-    '../../../scripts/lib/fix/analyze-escalation.mjs'
+    './fix/analyze-escalation.mjs'
   )
   const escOffset = readOnly ? 0 : escalationLogSize()
   const conformanceCode = await runConformance(cwd, readOnly, log)
@@ -160,11 +181,12 @@ function runFormat(cwd, log) {
 }
 
 /**
- * Scoped-режим (`lint <rule…>`): повний прогін НАЗВАНИХ правил — їх лінтер (`js/lint.mjs`,
- * whole-repo) для тих, що його мають, + конформність для всіх названих. Дзеркалить `--full`,
- * але звужено до правил, тож `lint ga` ≡ standalone `lint-ga`. Конформність-only правила
- * (напр. `changelog` із hk) не мають `js/lint.mjs` → проганяється лише їх конформність
- * (зворотна сумісність із колишнім `fix <rule>`). oxfmt у scoped НЕ запускається — це
+ * Scoped-режим (`lint <rule…>`): повний прогін НАЗВАНИХ правил — їх лінтер (entrypoint
+ * `main.mjs::lint`, whole-repo) для тих, що мають лінт-поверхню
+ * (`meta.json#lint`), + конформність для всіх названих. Дзеркалить `--full`, але звужено
+ * до правил, тож `lint ga` ≡ standalone `lint-ga`. Конформність-only правила (напр.
+ * `changelog` із hk) без `meta.lint` → проганяється лише їх конформність (зворотна
+ * сумісність із колишнім `fix <rule>`). oxfmt у scoped НЕ запускається — це
  * таргетований прогін правил, а не глобальне форматування.
  * @param {string[]} rules id названих правил
  * @param {{ cwd: string, readOnly: boolean, rulesDir: string, conformance: boolean, log: (s: string) => void }} ctx контекст (`conformance` — чи запускати конформність; false для юніт-тестів із кастомним rulesDir, де реальний пакет недоступний)
@@ -173,7 +195,7 @@ function runFormat(cwd, log) {
 async function runScopedRules(rules, ctx) {
   const { cwd, readOnly, rulesDir, conformance, log } = ctx
   const metaById = readAllMeta(rulesDir)
-  const linterIds = rules.filter(id => existsSync(join(rulesDir, id, 'js', 'lint.mjs')))
+  const linterIds = rules.filter(id => hasLintSurface(metaById[id]))
   let worst = 0
   if (linterIds.length > 0) {
     const perFile = await runPerFileRules(linterIds, { rulesDir, changed: undefined, cwd, readOnly, metaById, log })

package/scripts/lib/run-rule-cli.mjs

@@ -1,10 +1,10 @@
 /**
- * Standalone CLI runner для одного правила. Викликається з `rules/<id>/fix.mjs`
- * у блоці `if (import.meta.main)` — це робить `bun rules/<id>/fix.mjs` повним
+ * Standalone CLI runner для одного правила. Викликається з `rules/<id>/check.mjs`
+ * у блоці `if (import.meta.main)` — це робить `bun rules/<id>/check.mjs` повним
  * еквівалентом `npx \@nitra/cursor fix <id>`: друкує summary, повертає aggregated exit-code.
  *
  * **Без whitelist-гейту.** Гейтинг активних правил — єдине джерело: `resolveCheckRuleIds`
- * (`scripts/lib/fix/run-fix-check.mjs`) за `.n-cursor.json`. Прямий `bun rules/<id>/fix.mjs` —
+ * (`scripts/lib/fix/run-conformance-check.mjs`) за `.n-cursor.json`. Прямий `bun rules/<id>/check.mjs` —
  * свідомий запуск саме цього правила (debug / override), тож виконується беззастережно;
  * усі автоматичні шляхи (lint-конформність, orchestrator, t0, hook) уже спавнять лише активні.
  *
@@ -15,7 +15,7 @@ import { basename } from 'node:path'
 import { runStandardRule } from './run-standard-rule.mjs'
 import { getOrCreateWalkCache } from '../utils/walk-cache.mjs'
 
-// Re-export для зворотної сумісності: уся `rules/<id>/fix.mjs` уже імпортує `isRunAsCli`
+// Re-export для зворотної сумісності: уся `rules/<id>/check.mjs` уже імпортує `isRunAsCli`
 // саме звідси. Канонічна реалізація — у `scripts/cli-entry.mjs`. Caller передає
 // `import.meta.url`: `if (isRunAsCli(import.meta.url)) …`.
 export { isRunAsCli } from '../cli-entry.mjs'

package/scripts/lib/run-standard-lint.mjs

@@ -7,29 +7,42 @@
  * патчилися в кожному `rules/<rule>/lint/lint.mjs`.
  *
  * Зараз робить рівно одне: серіалізує + дедуплікує запуски через `withLock('lint-<ruleId>')`.
- * `ruleId` виводиться зі шляху: `import.meta.dirname` у `rules/<id>/lint/lint.mjs` → `<id>`.
+ * `ruleId` виводиться зі шляху незалежно від глибини виклику: `rules/<id>` (з `main.mjs`),
+ * `rules/<id>/js` або `rules/<id>/lint` → `<id>` (сегмент одразу після `rules/`).
  *
  * Інтеграція з боку правила:
  *
  * ```js
- * import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
+ * import { runStandardLint } from '../../scripts/lib/run-standard-lint.mjs'
  *
  * async function runLintFooSteps() { ... }
  *
- * export const runLintFooCli = () => runStandardLint(import.meta.dirname, runLintFooSteps)
+ * export function lint(_files) { return runStandardLint(import.meta.dirname, runLintFooSteps) }
  * ```
  */
-import { basename, dirname } from 'node:path'
+import { basename } from 'node:path'
 
 import { withLock } from '../utils/with-lock.mjs'
 
 /**
- * @param {string} lintDir абсолютний шлях до `rules/<id>/lint/` (передавай `import.meta.dirname`)
+ * Виводить `<id>` зі шляху каталогу правила незалежно від глибини: сегмент одразу після
+ * останнього `rules/`. Fallback — `basename(dir)`, якщо `rules/` у шляху немає.
+ * @param {string} dir абсолютний шлях каталогу (`rules/<id>`, `rules/<id>/js`, …)
+ * @returns {string} rule-id
+ */
+function ruleIdFromDir(dir) {
+  const parts = dir.split(/[/\\]/u)
+  const i = parts.lastIndexOf('rules')
+  return i !== -1 && parts[i + 1] ? parts[i + 1] : basename(dir)
+}
+
+/**
+ * @param {string} lintDir абсолютний шлях до каталогу правила (передавай `import.meta.dirname`)
  * @param {() => number | Promise<number>} stepsFn реальна робота лінту; повертає код виходу
  * @param {{ttl?:number, staleThreshold?:number, waitTimeout?:number, pollInterval?:number, cacheDir?:string, getFingerprint?:() => string | null}} [opts] прокидаються у `withLock`
  * @returns {Promise<number>} код виходу
  */
 export function runStandardLint(lintDir, stepsFn, opts) {
-  const ruleId = basename(dirname(lintDir))
+  const ruleId = ruleIdFromDir(lintDir)
   return withLock(`lint-${ruleId}`, stepsFn, opts)
 }

package/scripts/lib/run-standard-rule.mjs

@@ -1,14 +1,14 @@
 /**
- * Public API per-rule orchestration. Викликається з `rules/<id>/fix.mjs`.
+ * Public API per-rule orchestration. Викликається з `rules/<id>/check.mjs`.
  *
  * Інкапсулює: `discoverOneRule` → `runRule(applies → JS → policy → mdc-refs)`.
  * Локальна логіка в правилах заборонена; розширення поведінки — через `ctx`-опції.
  *
  * Серіалізація: загортає виконання у `withLock('fix-<ruleId>')` — паралельні запуски
- * того самого правила (через `npx \@nitra/cursor fix`, прямий `bun rules/<id>/fix.mjs`
+ * того самого правила (через `npx \@nitra/cursor fix`, прямий `bun rules/<id>/check.mjs`
  * чи `run(ctx)`-композицію) дедупляться за станом git-дерева; різні правила можуть
  * виконуватись паралельно. Точка інтеграції — тут, щоб не дублювати лок у кожному
- * `fix.mjs`.
+ * `check.mjs`.
  */
 import { basename, dirname } from 'node:path'
 
@@ -24,7 +24,7 @@ import { withLock } from '../utils/with-lock.mjs'
  * Зарезервовано на майбутнє (поки не реалізовано — додається, коли з'явиться потреба):
  *   - `skipMdcRefs`, `skipApplies`, `onlyConcerns`.
  * Розширення поведінки правила робиться лише через нові поля тут, не через локальну
- * логіку в `rules/<id>/fix.mjs`.
+ * логіку в `rules/<id>/check.mjs`.
  */
 
 /**

package/scripts/lib/timing-summary.mjs

@@ -2,7 +2,7 @@
  * Формат таблиці-резюме часу виконання для orchestrator `fix` / `lint`.
  *
  * Дві спільні точки використання:
- *  - `runFixCommand` у `bin/n-cursor.js` — після прогону всіх `rules/<id>/fix.mjs`.
+ *  - `runFixCommand` у `bin/n-cursor.js` — після прогону всіх `rules/<id>/check.mjs`.
  *  - `runLintCli` у `scripts/lib/run-lint-cli.mjs` — після прогону `lint-*` скриптів з кореневого `package.json`.
  *
  * Чиста функція без I/O — повертає готовий рядок (з фінальним `\n`), друк — на стороні виклику.

package/scripts/{post-tool-use-fix.mjs → post-tool-use-check.mjs}

@@ -4,17 +4,17 @@
  *
  * Раніше хук маршрутизував змінений файл у релевантні правила й ганяв повний `fix` (автофікс
  * + LLM) — дорого, тож звужували. Тепер хук — **детект** (нуль мутацій, нуль LLM), тож роутинг
- * зайвий: один виклик `_fix-check` (per-rule `fix.mjs run()` = перевірка) по всіх правилах.
+ * зайвий: один виклик `_fix-check` (per-rule `check.mjs run()` = перевірка) по всіх правилах.
  *
  * Контракт:
  * - stdin Claude Code: JSON із `tool_input.file_path`; якщо файлу немає (напр. Bash) — exit 0 (skip);
- * - інакше пряма `runFixCheck` (детект усіх правил, без subprocess-обгортки), exit-код прозоро:
+ * - інакше пряма `runConformanceCheck` (детект усіх правил, без subprocess-обгортки), exit-код прозоро:
  *   1 — є порушення конформності (PostToolUse не блокує turn, але код лишаємо інформативним).
  */
 import { once } from 'node:events'
 import { cwd as processCwd } from 'node:process'
 
-import { runFixCheck } from './lib/fix/run-fix-check.mjs'
+import { runConformanceCheck } from './lib/fix/run-conformance-check.mjs'
 
 /**
  * Зчитує stdin до EOF як utf8 рядок. На TTY — повертає `''` одразу.
@@ -57,20 +57,20 @@ export function extractFilePath(stdinJson) {
 }
 
 /**
- * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-fix`.
+ * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-check`.
  * Параметри доступні для інʼєкції для тестів: `stdinJson` обходить read від `process.stdin`,
- * `runFixCheckFn` — заміна `runFixCheck`.
- * @param {{ stdinJson?: string, runFixCheckFn?: typeof runFixCheck }} [options] параметри для тестів
+ * `runConformanceCheckFn` — заміна `runConformanceCheck`.
+ * @param {{ stdinJson?: string, runConformanceCheckFn?: typeof runConformanceCheck }} [options] параметри для тестів
  * @returns {Promise<number>} exit code (0 — пропущено / конформність ОК; 1 — є порушення)
  */
-export async function runPostToolUseFixCli(options = {}) {
+export async function runPostToolUseCheckCli(options = {}) {
   const stdinJson = options.stdinJson ?? (await readStdin())
   const filePath = extractFilePath(stdinJson)
   // Тільки після редагування файлу (Edit/Write/MultiEdit мають file_path); Bash тощо — skip.
   if (filePath === null) {
     return 0
   }
-  const check = options.runFixCheckFn ?? runFixCheck
+  const check = options.runConformanceCheckFn ?? runConformanceCheck
   // Один read-only детект конформності всіх активованих правил (пряма функція, без subprocess).
   try {
     const { failed, rules } = await check([], processCwd())
@@ -80,7 +80,7 @@ export async function runPostToolUseFixCli(options = {}) {
     }
     return 1
   } catch (error) {
-    process.stderr.write(`post-tool-use-fix: не вдалося запустити детект конформності — ${error.message}\n`)
+    process.stderr.write(`post-tool-use-check: не вдалося запустити детект конформності — ${error.message}\n`)
     return 1
   }
 }

package/scripts/sync-claude-config.mjs

@@ -30,8 +30,8 @@ import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
-/** Маркер PostToolUse fix-hook'а (`npx --no \@nitra/cursor post-tool-use-fix`). */
-export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-fix'
+/** Маркер PostToolUse fix-hook'а (`npx --no \@nitra/cursor post-tool-use-check`). */
+export const MANAGED_HOOK_COMMAND_MARKER = '@nitra/cursor post-tool-use-check'
 /** Маркер doc-files staleness-hook'ів (PostToolUse `--hook` і Stop-гейт `--git`). */
 export const DOC_FILES_HOOK_COMMAND_MARKER = '@nitra/cursor lint-doc-files'
 /** Legacy-маркер старих doc-files hook'ів (`doc-files check`) — cleanup при ресинку наявних інсталяцій. */

package/rules/changelog/fix.mjs

@@ -1,18 +0,0 @@
-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).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/ci4/fix.mjs

@@ -1,18 +0,0 @@
-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).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/doc-files/fix.mjs

@@ -1,19 +0,0 @@
-import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
-import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
-
-/**
- * Запускає правило doc-files: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
- * Структурні concerns (наявність workflow lint-doc-files.yml, скрипт у package.json) закриває
- * policy-канал; контентні порушення (відсутні/застарілі доки) — поза `n-cursor fix`, їх закриває
- * `fix-doc-files` (генерація). Library mode: викликається через `import + run(ctx)`.
- * @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)
-}
-
-if (isRunAsCli(import.meta.url)) {
-  // Standalone: bun rules/doc-files/fix.mjs — еквівалент `npx @nitra/cursor fix doc-files`.
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/doc-files/js/docs/lint.md

@@ -1,34 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/doc-files/js/lint.mjs
-docgen:
-  crc: ca055f8f
-  score: 100
----
-
-Адаптер правила doc-files до агрегатора `n-cursor lint`. Дає агрегатору відповідь на одне
-питання: чи має кожен дотичний кодовий файл актуальну файлову документацію поряд із собою.
-
-## Поведінка
-
-У quick-фазі отримує список змінених файлів і зводить його до набору джерел для перевірки в
-**обидва** боки: змінене джерело перевіряється проти своєї доки, а змінена або видалена дока
-(`<dir>/docs/<stem>.md`) повертається до відповідного джерела з тим самим іменем у каталозі над
-`docs/`. У ci-фазі (списку немає) обходить усе дерево.
-
-Порушенням вважається відсутня дока (`missing`) або розбіжність контрольної суми джерела з тією,
-що записана у frontmatter доки (`crc-mismatch`). Документ із низькою якістю, але свіжою сумою —
-не порушення.
-
-## Публічний API
-
-`lint` — перевіряє документацію для переданого набору змінених файлів (або всього репозиторію,
-якщо набір не задано); повертає код виходу `1`, якщо є застарілі чи відсутні доки, інакше `0`.
-Список проблемних файлів друкується у stderr із підказкою регенерувати.
-
-## Гарантії поведінки
-
-- Детермінованість: жодного виклику мовної моделі, рішення лише за контрольною сумою.
-- Реверс-мапінг доки до джерела перебирає лише кодові розширення і повертає наявний файл-кандидат.
-- Порожній набір змінених файлів дає код `0` без обходу дерева.

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

@@ -1,11 +0,0 @@
----
-type: Directory Index
-title: npm/rules/doc-files/lint
-resource: npm/rules/doc-files/lint/
----
-
-# npm/rules/doc-files/lint
-
-| Файл | Тип |
-|---|---|
-| [lint.mjs](lint.md) | JS Module |

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

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/doc-files/lint/lint.mjs
-docgen:
-  crc: a30dd81f
-  score: 100
----
-
-CLI-команда `lint-doc-files` — детермінований детектор застарілості файлових док. Працює без
-мовної моделі скрізь: локально, в hook'ах і в CI.
-
-## Поведінка
-
-Без прапорців або з переліком шляхів робить повний чи точковий детект і повертає код `1`, якщо є
-застарілі/відсутні доки. `--missing-only` звужує до самих відсутніх. `--json` друкує машинний
-лістинг усіх кандидатів зі станом і завершується кодом `0`. Режими `--hook`, `--git` і
-`--degraded` делегуються детектору hook-протоколу (PostToolUse за одним файлом зі stdin, Stop-гейт
-за зміненими у задачі джерелами з порогом, інформаційний звіт про доки нижчої якості).
-
-Повний прогін серіалізується спільним локом під ключем, виведеним зі шляху каталогу, тож паралельні
-запуски не накладаються; hook-форми навмисно виконуються без локу заради завжди-свіжого вердикту.
-
-## Публічний API
-
-`runLintDocFilesCli` — точка входу команди: маршрутизує між делегатом hook-протоколу, JSON-лістингом
-і повним/точковим детектом; повертає код виходу.
-`runLintDocFilesSteps` — сама робота повного чи точкового детекту, придатна для прямого виклику з
-тестів без локу; повертає `1` за наявності застарілих док, інакше `0`.
-
-## Гарантії поведінки
-
-- Неіснуючий корінь дає зрозумілу помилку і код `1`.
-- Повний прогін — код `1` (конвенція `lint-*`); hook/git — код `2` (blocking feedback для Claude Code).
-- Жодних викликів мовної моделі.

package/rules/docker/fix.mjs

@@ -1,18 +0,0 @@
-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).
- * 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>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
-  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
-  process.exitCode = await runRuleCli(import.meta.dirname)
-}

package/rules/docker/lint/docs/index.md

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