@nitra/cursor 12.6.1 → 12.8.0

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

@@ -6,18 +6,18 @@ resource: npm/scripts/utils/
 
 # npm/scripts/utils
 
-| Файл | Тип |
-|---|---|
-| [ast-scan-utils.mjs](ast-scan-utils.md) | JS Module |
+| Файл                                                        | Тип       |
+| ----------------------------------------------------------- | --------- |
+| [ast-scan-utils.mjs](ast-scan-utils.md)                     | JS Module |
 | [ensure-gitignore-entries.mjs](ensure-gitignore-entries.md) | JS Module |
-| [find-package-json-paths.mjs](find-package-json-paths.md) | JS Module |
-| [lock-cache-dir.mjs](lock-cache-dir.md) | JS Module |
-| [pass.mjs](pass.md) | JS Module |
-| [resolve-cargo-manifest.mjs](resolve-cargo-manifest.md) | JS Module |
-| [resolve-cmd.mjs](resolve-cmd.md) | JS Module |
-| [resolve-js-root.mjs](resolve-js-root.md) | JS Module |
-| [test-helpers.mjs](test-helpers.md) | JS Module |
-| [walk-cache.mjs](walk-cache.md) | JS Module |
-| [walkDir.mjs](walkDir.md) | JS Module |
-| [with-lock.mjs](with-lock.md) | JS Module |
-| [worktree-fingerprint.mjs](worktree-fingerprint.md) | JS Module |
+| [find-package-json-paths.mjs](find-package-json-paths.md)   | JS Module |
+| [lock-cache-dir.mjs](lock-cache-dir.md)                     | JS Module |
+| [pass.mjs](pass.md)                                         | JS Module |
+| [resolve-cargo-manifest.mjs](resolve-cargo-manifest.md)     | JS Module |
+| [resolve-cmd.mjs](resolve-cmd.md)                           | JS Module |
+| [resolve-js-root.mjs](resolve-js-root.md)                   | JS Module |
+| [test-helpers.mjs](test-helpers.md)                         | JS Module |
+| [walk-cache.mjs](walk-cache.md)                             | JS Module |
+| [walkDir.mjs](walkDir.md)                                   | JS Module |
+| [with-lock.mjs](with-lock.md)                               | JS Module |
+| [worktree-fingerprint.mjs](worktree-fingerprint.md)         | JS Module |

package/skills/doc-aggregate/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/skills/doc-aggregate/js/
 
 # npm/skills/doc-aggregate/js
 
-| Файл | Тип |
-|---|---|
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
 | [docgen-ignore.mjs](docgen-ignore.md) | JS Module |
-| [docgen-scan.mjs](docgen-scan.md) | JS Module |
+| [docgen-scan.mjs](docgen-scan.md)     | JS Module |

package/skills/doc-files/.changes/260612-0002.md

@@ -2,4 +2,5 @@
 bump: minor
 section: Added
 ---
+
 doc-files: підтримка Rust (.rs) — SOURCE_EXTENSIONS, target/-ignore, extractFactsRust, units-rs

package/skills/doc-files/.changes/260612-0006.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Fixed
 ---
+
 мовно-нейтральний текст returnsFalsyOnFail (false/null/Err); units-rs: тести + docs

package/skills/doc-files/.changes/260612-0008.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Added
 ---
+
 Rust .rs: тести units-rs, doc units-rs.md, мовно-нейтральний текст гарантії returnsFalsyOnFail

package/skills/doc-files/.changes/260612-0012.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Added
 ---
+
 Rust (.rs): тести extractFactsRust у docgen-extract.test.mjs — exports, tauri::command, struct/enum, markers, header, desc

package/skills/doc-files/.changes/260612-0031.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Changed
 ---
+
 стале-доки після Rust: оновлено CRC для docgen-prompts, docgen-scan, units-rs; додано units-js.md; тести extractFacts(.rs)

package/skills/doc-files/.changes/260612-0036.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Added
 ---
+
 docs: units.md (docgen для units.mjs — фасад Rust/JS)

package/skills/doc-files/.changes/260612-0114.md

@@ -2,4 +2,5 @@
 bump: patch
 section: Added
 ---
+
 doc-files: регенерація всіх stale doc-файлів; manifests.mjs (303KB) → docgen-ignore

package/skills/start-check/js/docs/index.md

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

package/skills/taze/js/docs/index.md

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

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export {}

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 |

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

@@ -1,200 +0,0 @@
----
-type: JS Module
-title: lint.mjs
-resource: npm/rules/docker/lint/lint.mjs
-docgen:
-  crc: 98a98d10
----
-
-Модуль `npm/rules/docker/lint/lint.mjs` реалізує підкоманду `lint-docker` інструмента `n-cursor`. Її задача — знайти у дереві репозиторію канонічні Dockerfile-и та пропустити їх через `hadolint`, фіксуючи результат у форматі звіту `check-reporter` і виставляючи числовий код виходу.
-
-Особливості, що визначають поведінку:
-
-- Перевіряються **лише** файли з іменем, що рівне `Dockerfile` (регістр не важливий) та файли, ім’я яких закінчується на суфікс `.dockerfile` (наприклад, `app.Dockerfile`, `worker.dockerfile`). Файли виду `Dockerfile.dev`, `Containerfile` й інші варіанти, які бере `check-docker`, тут навмисно **не** обробляються.
-- Обхід дерева виконується тим самим `walkDir`, що й у `check-docker`, з тими самими пропусками каталогів (на основі `.cursorignore`/конфігу Cursor).
-- Виклик `hadolint` йде через `lintDockerfileWithHadolint` із `../lib/docker-hadolint.mjs` — інструмент шукається у `PATH` або запускається в Docker (`docker run`).
-- Серіалізація важкої CLI-команди (тільки один паралельний прогін на репозиторій і дедуплікація за станом git-дерева) виконана через `runStandardLint` — це канонічний патерн для `lint-*` команд згідно з `.cursor/rules/scripts.mdc`, секція «Серіалізація важких CLI-команд». Прямий `withLock` тут не використовується.
-- Запуск файла напряму через Node (`node lint.mjs`) працює як CLI: модуль ставить `process.exitCode` у код, повернений `runLintDocker`.
-
-## Експорти / API
-
-| Експорт                   | Вид                     | Призначення                                                                                    |
-| ------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------- |
-| `isLintDockerfileName`    | `function`              | Перевіряє basename файла: чи входить він до набору `lint-docker`.                              |
-| `findLintDockerfilePaths` | `async function`        | Збирає відсортований список абсолютних шляхів придатних для `lint-docker` файлів.              |
-| `runLintDocker`           | `() => Promise<number>` | Публічна CLI-форма команди `lint-docker`: серіалізований прогон з кешуванням за станом дерева. |
-
-Внутрішня (не експортована) функція:
-
-- `runLintDockerSteps()` — самі кроки lint-у без обгортки локу й дедупу. Викликається `runStandardLint`.
-
-CLI-режим (`if (isRunAsCli(import.meta.url))`) при прямому запуску файла ставить `process.exitCode = await runLintDocker()`.
-
-## Функції
-
-### `isLintDockerfileName(name)`
-
-```js
-export function isLintDockerfileName(name): boolean
-```
-
-- **Параметри:**
-  - `name: string` — basename шляху (тобто лише ім’я файла, без каталогів).
-- **Повертає:** `boolean` — `true`, якщо файл підходить під набір `lint-docker`, інакше `false`.
-- **Логіка:**
-  1. Зводить ім’я до нижнього регістру (`n`).
-  2. Якщо `n === 'dockerfile'` — повертає `true`.
-  3. Інакше повертає `true`, лише якщо `n` закінчується на `.dockerfile` **і** довжина `n` строго більша за довжину суфікса `.dockerfile`. Завдяки цій додатковій умові саме `.dockerfile` (без префікса) — не валідний кейс.
-- **Side effects:** немає.
-- **Приклади:**
-  - `isLintDockerfileName('Dockerfile')` → `true`
-  - `isLintDockerfileName('dockerfile')` → `true`
-  - `isLintDockerfileName('app.Dockerfile')` → `true`
-  - `isLintDockerfileName('worker.dockerfile')` → `true`
-  - `isLintDockerfileName('.dockerfile')` → `false`
-  - `isLintDockerfileName('Dockerfile.dev')` → `false`
-  - `isLintDockerfileName('Containerfile')` → `false`
-
-### `findLintDockerfilePaths(root, ignorePaths = [])`
-
-```js
-export async function findLintDockerfilePaths(root, ignorePaths = []): Promise<string[]>
-```
-
-- **Параметри:**
-  - `root: string` — корінь обходу (зазвичай корінь репозиторію).
-  - `ignorePaths?: string[]` — абсолютні шляхи каталогів, повністю виключених з обходу (за замовчуванням пустий масив).
-- **Повертає:** `Promise<string[]>` — масив абсолютних шляхів придатних файлів, відсортований за `String.prototype.localeCompare` через `Array.prototype.toSorted` (не мутує проміжний масив).
-- **Логіка:**
-  1. Створює локальний акумулятор `out`.
-  2. Викликає `walkDir(root, visit, ignorePaths)`, де `visit(p)` додає `p` до `out`, якщо `isLintDockerfileName(basename(p))` істинне.
-  3. Повертає `out.toSorted((a, b) => a.localeCompare(b))`.
-- **Side effects:** виконує асинхронний обхід файлової системи через `walkDir`. Не пише нічого на диск і нічого не виводить у stdout/stderr.
-
-### `runLintDockerSteps()` _(internal)_
-
-```js
-async function runLintDockerSteps(): Promise<number>
-```
-
-- **Параметри:** немає.
-- **Повертає:** `Promise<number>` — `reporter.getExitCode()`: `0`, якщо помилок не зафіксовано, `1`, якщо хоча б один `fail`.
-- **Логіка:**
-  1. Створює репортер: `const reporter = createCheckReporter(); const { pass, fail } = reporter`.
-  2. Бере `root = process.cwd()`.
-  3. Завантажує `ignorePaths` через `await loadCursorIgnorePaths(root)`.
-  4. Шукає кандидатів: `files = await findLintDockerfilePaths(root, ignorePaths)`.
-  5. Якщо `files.length === 0` — викликає `pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')` і повертає `reporter.getExitCode()`.
-  6. Інакше повідомляє `pass(\`lint-docker: файлів для hadolint: ${files.length}\`)`.
-  7. Для кожного абсолютного шляху `abs`:
-     - Обчислює відносний шлях `rel = posixRel(root, abs) || basename(abs)` — якщо `posixRel` повернула порожній рядок, береться лише basename.
-     - Викликає `const { ok, stdout, stderr, via } = lintDockerfileWithHadolint(root, abs)` (синхронний виклик, як видно з відсутності `await`).
-     - Об’єднує `stdout + stderr`, тримує (`trim()`) у `tail`.
-     - Якщо `ok` — `pass(\`${rel} (${via})\`)`.
-     - Якщо ні — формує `detail = tail ? \`:\n${tail}\` : ''` і викликає `fail(\`${rel} (${via})${detail}\`)`.
-  8. Повертає `reporter.getExitCode()`.
-- **Side effects:**
-  - Читає поточну робочу директорію (`process.cwd()`).
-  - Читає файлову систему репозиторію через `walkDir`/`loadCursorIgnorePaths`.
-  - Запускає зовнішній процес `hadolint` (через `PATH` або через `docker run`) для кожного знайденого Dockerfile.
-  - Пише повідомлення у консоль/звіт через `pass`/`fail` репортера.
-
-### `runLintDocker`
-
-```js
-export const runLintDocker = (): Promise<number> =>
-  runStandardLint(import.meta.dirname, runLintDockerSteps)
-```
-
-- **Параметри:** немає.
-- **Повертає:** `Promise<number>` — фінальний код виходу команди.
-- **Логіка:** делегує виконання у `runStandardLint`, передаючи:
-  - `import.meta.dirname` — каталог цього модуля (`npm/rules/docker/lint`); `runStandardLint` використовує його як ідентифікатор/корінь для серіалізації та для дедуплікації запусків за станом git-дерева;
-  - `runLintDockerSteps` — асинхронну функцію з фактичними кроками lint-у.
-- **Side effects:** усі побічні ефекти `runStandardLint` (взяття локу `lint-docker`, перевірка попереднього стану git, можливе пропускання запуску при ідентичному стані тощо) + усі ефекти `runLintDockerSteps`.
-
-### CLI-ентрі
-
-```js
-if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintDocker()
-}
-```
-
-- **Поведінка:** при прямому запуску модуля як Node-скрипта (`node npm/rules/docker/lint/lint.mjs` або у вигляді ESM bin) встановлює `process.exitCode` у значення, повернене `runLintDocker()`. Імпорт як модуля з іншого файла не активує цю гілку.
-- **Side effects:** мутує `process.exitCode`.
-
-## Залежності
-
-### Зовнішні (Node API)
-
-- `node:path` — використовується лише `basename` для виділення імені файла зі шляху.
-
-### Внутрішні модулі репозиторію
-
-| Імпорт                                        | Що з нього береться                      | Роль у цьому модулі                                                                         |
-| --------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------- |
-| `../../../scripts/cli-entry.mjs`              | `isRunAsCli`                             | Визначення, чи модуль запущено як CLI напряму.                                              |
-| `../lib/docker-hadolint.mjs`                  | `lintDockerfileWithHadolint`, `posixRel` | Власне виклик `hadolint` (через PATH або `docker run`) і обчислення POSIX-відносного шляху. |
-| `../../../scripts/lib/check-reporter.mjs`     | `createCheckReporter`                    | Створення репортера з методами `pass`/`fail` і фінальним `getExitCode`.                     |
-| `../../../scripts/lib/load-cursor-config.mjs` | `loadCursorIgnorePaths`                  | Завантаження списку каталогів, які потрібно ігнорувати під час обходу.                      |
-| `../../../scripts/utils/walkDir.mjs`          | `walkDir`                                | Асинхронний обхід дерева файлів з підтримкою списку ігнорувань.                             |
-| `../../../scripts/lib/run-standard-lint.mjs`  | `runStandardLint`                        | Канонічна обгортка `lint-*`-команд: лок, дедуп за станом git-дерева, уніфікований запуск.   |
-
-### Зовнішні CLI/інструменти, що викликаються опосередковано
-
-- `hadolint` — або з `PATH`, або через `docker run` (визначається в `lintDockerfileWithHadolint`).
-- Опосередковано — `git` (для обчислення стану дерева всередині `runStandardLint`), `docker` (якщо `hadolint` запускається в контейнері).
-
-## Потік виконання / Використання
-
-### Послідовність дій при `n-cursor lint docker`
-
-1. `bin/n-cursor.js` диспатчить правило `docker` на `npm/rules/docker/js/lint.mjs`, яке використовує `runLintDocker` із цього модуля.
-2. `runLintDocker` → `runStandardLint(import.meta.dirname, runLintDockerSteps)`:
-   - бере серіалізаційний лок на ім’я `lint-docker`;
-   - перевіряє стан git-дерева; якщо стан збігається з попереднім успішним прогоном — крок може бути пропущено (дедуп);
-   - інакше викликає `runLintDockerSteps`.
-3. `runLintDockerSteps`:
-   - читає `cwd`;
-   - завантажує `ignorePaths`;
-   - обходить дерево і збирає Dockerfile-кандидатів (тільки `Dockerfile` і `*.Dockerfile`/`*.dockerfile`);
-   - якщо нічого не знайдено — фіксує `pass` про пропуск і виходить;
-   - інакше повідомляє кількість файлів і по кожному викликає `lintDockerfileWithHadolint`;
-   - кожен результат маркується як `pass` або `fail` (з прикладеним хвостом `stdout`+`stderr`).
-4. Підсумковий `reporter.getExitCode()` повертається у `runStandardLint`, а той — у `runLintDocker`.
-5. При прямому запуску файла Node — код виходу пишеться у `process.exitCode`.
-
-### Як це використовується ззовні
-
-- **CLI:** `n-cursor lint docker` — основний сценарій.
-- **Програмно з інших скриптів:**
-
-  ```js
-  import { runLintDocker } from 'npm/rules/docker/lint/lint.mjs'
-
-  const code = await runLintDocker() // 0 — OK, 1 — є зауваження/помилки
-  ```
-
-- **Тести/допоміжний код:**
-
-  ```js
-  import { isLintDockerfileName, findLintDockerfilePaths } from 'npm/rules/docker/lint/lint.mjs'
-
-  isLintDockerfileName('Dockerfile') // true
-  isLintDockerfileName('app.Dockerfile') // true
-  isLintDockerfileName('Dockerfile.dev') // false
-
-  const files = await findLintDockerfilePaths(process.cwd(), [])
-  ```
-
-### Контракт коду виходу
-
-- `0` — або не знайдено Dockerfile-ів, або всі знайдені пройшли `hadolint`.
-- `1` — хоча б один файл не пройшов `hadolint` (або зафіксована інша помилка через `fail`).
-
-### Відмінності від `check-docker`
-
-- `check-docker` працює з ширшим набором імен (зокрема `Dockerfile.*`, `Containerfile` тощо).
-- `lint-docker` свідомо звужений до канонічного `Dockerfile` та суфікса `.dockerfile`, що відповідає правилу `docker.mdc` для самого hadolint-кроку.
-- Серіалізація `lint-docker` — через `runStandardLint`, а не через прямий `withLock`, як того вимагає `scripts.mdc`.

package/rules/docker/lint/lint.mjs

@@ -1,95 +0,0 @@
-/**
- * run-docker (скрипт lint-docker): hadolint лише для файлів з іменем Dockerfile та суфіксом .dockerfile (див. docker.mdc).
- *
- * Обхід дерева як у check-docker (walkDir, ті самі пропуски каталогів). На відміну від
- * check docker, не обробляються Dockerfile.*, Containerfile тощо — лише канонічне ім’я
- * Dockerfile та варіанти виду app.Dockerfile (регістр суфікса не важливий).
- *
- * Виклик hadolint — через ../js/lint/docker-hadolint.mjs (PATH або docker run).
- *
- * Канон патерну `lint-*` (серіалізація через `runStandardLint`, без прямого `withLock`) —
- * `.cursor/rules/scripts.mdc`, секція «Серіалізація важких CLI-команд».
- */
-import { basename } from 'node:path'
-
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { lintDockerfileWithHadolint, posixRel } from '../lib/docker-hadolint.mjs'
-import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-import { runStandardLint } from '../../../scripts/lib/run-standard-lint.mjs'
-
-/**
- * Чи входить файл до набору lint-docker: Dockerfile або *.Dockerfile (*.dockerfile).
- * @param {string} name basename шляху
- * @returns {boolean} true, якщо ім’я підходить під lint-docker
- */
-export function isLintDockerfileName(name) {
-  const n = name.toLowerCase()
-  if (n === 'dockerfile') return true
-  return n.endsWith('.dockerfile') && n.length > '.dockerfile'.length
-}
-
-/**
- * Збирає абсолютні шляхи для lint-docker.
- * @param {string} root корінь репозиторію
- * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
- * @returns {Promise<string[]>} відсортовані абсолютні шляхи
- */
-export async function findLintDockerfilePaths(root, ignorePaths = []) {
-  /** @type {string[]} */
-  const out = []
-  await walkDir(
-    root,
-    p => {
-      if (isLintDockerfileName(basename(p))) out.push(p)
-    },
-    ignorePaths
-  )
-  return out.toSorted((a, b) => a.localeCompare(b))
-}
-
-/**
- * Внутрішні кроки `lint-docker` без локу: hadolint по Dockerfile та *.Dockerfile.
- * @returns {Promise<number>} 0 — OK, 1 — зауваження або помилка
- */
-async function runLintDockerSteps() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
-
-  const root = process.cwd()
-  const ignorePaths = await loadCursorIgnorePaths(root)
-  const files = await findLintDockerfilePaths(root, ignorePaths)
-
-  if (files.length === 0) {
-    pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')
-    return reporter.getExitCode()
-  }
-
-  pass(`lint-docker: файлів для hadolint: ${files.length}`)
-
-  for (const abs of files) {
-    const rel = posixRel(root, abs) || basename(abs)
-    const { ok, stdout, stderr, via } = lintDockerfileWithHadolint(root, abs)
-    const tail = (stdout + stderr).trim()
-    if (ok) {
-      pass(`${rel} (${via})`)
-    } else {
-      const detail = tail ? `:\n${tail}` : ''
-      fail(`${rel} (${via})${detail}`)
-    }
-  }
-
-  return reporter.getExitCode()
-}
-
-/**
- * Публічна CLI-форма: серіалізує через `withLock('lint-docker')` + дедуп за станом git-дерева.
- * Експортовано як `runLintDocker` — використовується з `bin/n-cursor.js` як підкоманда `lint-docker`.
- * @returns {Promise<number>} код виходу
- */
-export const runLintDocker = () => runStandardLint(import.meta.dirname, runLintDockerSteps)
-
-if (isRunAsCli(import.meta.url)) {
-  process.exitCode = await runLintDocker()
-}

package/rules/efes/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)
-}