@7n/rules 1.20.1 → 1.22.0

package/rules/rust/applies/docs/main.md

@@ -1,30 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/rust/applies/main.mjs
-docgen:
-  crc: 2d2dcbac
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.97
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Функціональність визначає, чи підходить даний каталог для застосування правил. Публічна функція `applies` здійснює цей аналіз, тоді як функція `main` ініціює процес повної перевірки, звітуючи про результати застосування правил до каталогу. Сканування каталогу ігнорує системні та залежностні каталоги, такі як `.git` та `node_modules`, а також конфігураційний файл `Cargo.toml`.
-
-## Поведінка
-
-Поведінка:
-applies визначає, чи є правило застосовним до поточного каталогу, перевіряючи наявність файлу Cargo.toml або його присутності у підкаталогах, і свідомо ігнорує каталоги .git, node_modules та .next.
-main виконує логіку перевірки, ініціалізує репортер та інформує про застосування правил Rust, повертаючи код завершення.
-
-## Публічний API
-
-Будь ласка, надайте код або список елементів коду, які потрібно задокументувати.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Свідомо пропускає шляхи: `.git`, `node_modules`.

package/rules/rust/applies/main.mjs

@@ -1,28 +0,0 @@
-/** @see ./docs/applies.md */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-
-import { hasCargoTomlInTree } from '../lib/has-cargo-toml.mjs'
-
-const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
-
-/**
- * @param {string} [cwd] корінь репозиторію
- * @returns {Promise<boolean>} `true` — правило застосовне; `false` — пропустити
- */
-export function applies(cwd = process.cwd()) {
-  if (existsSync(join(cwd, 'Cargo.toml'))) return Promise.resolve(true)
-  return Promise.resolve(hasCargoTomlInTree(cwd, IGNORED_DIR_NAMES))
-}
-
-/**
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат context-pass
- */
-export function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  reporter.pass('Знайдено Cargo.toml — застосовуємо правила rust.mdc')
-  return Promise.resolve(reporter.result())
-}

package/rules/rust/check/check.mdc

@@ -1,16 +0,0 @@
-## Лінт Rust: rustfmt + clippy + cargo-deny
-
-**rustfmt** ([rust-lang/rustfmt](https://github.com/rust-lang/rustfmt)) — форматер; **clippy** ([rust-lang/rust-clippy](https://github.com/rust-lang/rust-clippy)) — лінтер; **cargo-deny** — перевірка ліцензій залежностей. Запуск — через **`n-rules lint rust`** (detector `npm/rules/rust/check/main.mjs`, autofix `npm/rules/rust/check/fix-check.mjs`):
-
-- **read-only (детект, CI):** `cargo fmt --all -- --check` → `cargo clippy --all-targets --all-features -- -D warnings` → (за наявності `deny.toml` і встановленого `cargo-deny`) `cargo deny check licenses`.
-- **`fix` (локально):** `cargo fmt --all` (реальне форматування) і, якщо `deny.toml` відсутній та `cargo-deny` встановлено, `cargo deny init` для генерації канонічного файлу.
-
-`clippy` **не** автофіксимо (`--fix` потенційно небезпечний і може прибрати навмисний код) — clippy-порушення йдуть у LLM-ladder, а не в детермінований autofix.
-
-Без `Cargo.toml` у cwd — no-op (exit 0). Окремого `package.json`-скрипта немає.
-
-`cargo`, `rustfmt`, `clippy`, `cargo-deny` **не додавай** у `devDependencies` — це Rust toolchain, ставиться через `rustup`/`cargo install` локально або через `dtolnay/rust-toolchain@stable` у CI.
-
-### Канон CI workflow `.github/workflows/lint-rust.yml`
-
-Канонічний workflow, drift-safe перевірка (`rust.lint_rust_yml`) і вимога `Swatinem/rust-cache@v2` — `npm/rules/rust/lint_rust_yml/lint_rust_yml.mdc`. Тут лише сам лінт-скрипт; CI-канон workflow **не дублюється**.

package/rules/rust/check/concern.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "lint": {
-    "scope": "full",
-    "glob": ["**/*.rs", "Cargo.toml", "Cargo.lock"]
-  }
-}

package/rules/rust/check/docs/fix-check.md

@@ -1,30 +0,0 @@
----
-type: JS Module
-title: fix-check.mjs
-resource: npm/rules/rust/check/fix-check.mjs
-docgen:
-  crc: 3bd2ccd0
----
-
-## Огляд
-
-T0-autofix для `rust/check`: детермінований `cargo fmt --all` (детектор ганяє його лише з
-`--check`) і канонічна генерація `deny.toml` через `cargo deny init`. Форматує Rust-код перед
-LLM-ладдером. clippy не автофіксимо (його `--fix` потенційно небезпечний) — ці порушення й
-далі йдуть у LLM-ladder. Запис незворотний. Відсутній `cargo`/`cargo-deny` → no-op.
-
-## Поведінка
-
-- Перелічує tracked \*.rs через git, застосовує `cargo fmt --all`. До списку змінених — лише
-  файли з фактичною зміною.
-- За наявності порушення `deny-config-missing` і встановленого `cargo-deny` викликає
-  `cargo deny init`, що створює канонічний `deny.toml` у корені проєкту.
-
-## Публічний API
-
-- `patterns` — `rust-cargo-fmt` спрацьовує на reason `cargo-fmt-violation`;
-  `rust-cargo-deny-init` спрацьовує на reason `deny-config-missing`.
-
-## Гарантії поведінки
-
-- Записуються лише фактично змінені/створені файли; кожен реєструється через `recordWrite`.

package/rules/rust/check/docs/index.md

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

package/rules/rust/check/docs/main.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/rust/check/main.mjs
-docgen:
-  crc: 71821b75
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Файл реалізує lint-поверхню для Rust, використовуючи команди `cargo fmt`, `clippy` та `deny` для автоматизованої перевірки та форматування коду в робочому каталозі. Поведінка супроводжується повідомленнями, описаними в `rust.mdc`.
-
-## Поведінка
-
-Поведінка:
-
-1. Якщо в робочому каталозі відсутній файл `Cargo.toml`, операція лінту для Rust пропускається.
-2. Якщо інструмент `cargo` не знайдено в системному PATH, операція лінту завершується з помилкою.
-3. Виконується форматування коду за допомогою `cargo fmt`. Якщо режим `readOnly` активовано, перевіряється лише відповідність формату; інакше, застосовується форматування.
-4. Якщо режим `readOnly` не активовано, запускається автоматичне виправлення стильових проблем за допомогою `cargo clippy --fix`.
-5. Після виправлення стилів, виконується перевірка на наявність попереджень за допомогою `cargo clippy -D warnings`.
-6. Перевіряється наявність файлу `deny.toml`.
-7. Якщо `deny.toml` відсутній і режим `readOnly` активовано, фіксується помилка, вказуючи на необхідність ручного запуску для його генерації (rust.mdc).
-8. Якщо `deny.toml` відсутній і режим `readOnly` не активовано, він створюється з дефолтним списком дозволених ліцензій.
-9. Якщо `deny.toml` присутній і інструмент `cargo deny` встановлений, виконується перевірка ліцензій за допомогою `cargo deny check licenses`.
-10. Якщо інструмент `cargo deny` не встановлений, перевірка ліцензій пропускається.
-
-## Публічний API
-
-lint — забезпечує відповідність коду специфічним стандартам поверхні Rust.
-
-## Гарантії поведінки
-
-- (специфічних машинно-виведених гарантій немає)

package/rules/rust/check/fix-check.mjs

@@ -1,80 +0,0 @@
-/** @see ./docs/fix-check.md */
-
-/**
- * T0-autofix для `rust/check` — детермінований `cargo fmt --all`, що його read-only детектор
- * виконує лише з `--check`, плюс канонічна генерація `deny.toml` через `cargo deny init`
- * (`deny-config-missing`). clippy не автофіксимо (його `--fix` потенційно небезпечний) — ці
- * порушення й далі йдуть у LLM-ladder. Запис permanent. Відсутній `cargo`/`cargo-deny` → no-op.
- */
-import { existsSync, readFileSync } from 'node:fs'
-import { join, resolve } from 'node:path'
-
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-
-/**
- * Вміст файлу або null, якщо не читається.
- * @param {string} abs абсолютний шлях
- * @returns {string|null} вміст або null
- */
-function readOrNull(abs) {
-  try {
-    return readFileSync(abs, 'utf8')
-  } catch {
-    return null
-  }
-}
-
-/**
- * Tracked *.rs файли проєкту (через git). Async (не блокує event loop, ADR 260716-1354).
- * @param {string} cwd корінь
- * @returns {Promise<string[]>} posix-relative шляхи
- */
-async function listRsFiles(cwd) {
-  const r = await spawnAsync('git', ['ls-files', '-z', '--', '*.rs'], { cwd })
-  if (r.exitCode !== 0) return []
-  return (r.stdout ?? '').split('\0').filter(Boolean)
-}
-
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
-export const patterns = [
-  {
-    id: 'rust-cargo-fmt',
-    standalone: true, // §8 Phase 2: apply самостійно перелічує *.rs (git ls-files), cargo fmt сам ре-аналізує
-    test: violations => violations.some(v => v.reason === 'cargo-fmt-violation'),
-    apply: async (violations, ctx) => {
-      const cargo = resolveCmd('cargo')
-      if (!cargo) return { touchedFiles: [] }
-      const files = await listRsFiles(ctx.cwd)
-      if (files.length === 0) return { touchedFiles: [] }
-
-      const abs = files.map(f => resolve(ctx.cwd, f))
-      const before = new Map(abs.map(a => [a, readOrNull(a)]))
-      await spawnAsync(cargo, ['fmt', '--all'], { cwd: ctx.cwd })
-
-      const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
-      for (const a of touchedFiles) ctx.recordWrite?.(a)
-      return touchedFiles.length > 0
-        ? { touchedFiles, message: `cargo fmt: ${touchedFiles.length} файл(ів)` }
-        : { touchedFiles: [] }
-    }
-  },
-  {
-    id: 'rust-cargo-deny-init',
-    test: violations => violations.some(v => v.reason === 'deny-config-missing'),
-    apply: async (violations, ctx) => {
-      const cargo = resolveCmd('cargo')
-      if (!cargo) return { touchedFiles: [] }
-      const denyVersionResult = await spawnAsync(cargo, ['deny', '--version'])
-      const hasDeny = denyVersionResult.exitCode === 0
-      if (!hasDeny) return { touchedFiles: [] }
-
-      const denyConfigPath = join(ctx.cwd, 'deny.toml')
-      await spawnAsync(cargo, ['deny', 'init'], { cwd: ctx.cwd })
-      if (!existsSync(denyConfigPath)) return { touchedFiles: [] }
-
-      ctx.recordWrite?.(denyConfigPath)
-      return { touchedFiles: [denyConfigPath], message: 'cargo deny init: deny.toml' }
-    }
-  }
-]

package/rules/rust/check/main.mjs

@@ -1,87 +0,0 @@
-/**
- * lint-поверхня rust: read-only detector (cargo fmt --check + clippy -D warnings +
- * cargo deny check licenses). Генерація deny.toml — окремий T0-fix, не в detector-і.
- */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-
-/**
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} label назва кроку.
- * @param {string} cargo шлях до бінарника cargo.
- * @param {string[]} args аргументи cargo.
- * @param {string} cwd робочий каталог.
- * @param {(msg: string, reason: string) => void} fail колбек реєстрації порушення.
- * @param {string} reason машиночитна причина порушення.
- * @returns {Promise<boolean>} true якщо OK
- */
-async function runCargo(label, cargo, args, cwd, fail, reason) {
-  const r = await spawnAsync(cargo, args, { cwd })
-  if (r.exitCode === 0) return true
-  const code = typeof r.exitCode === 'number' ? r.exitCode : 1
-  const out = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim().slice(0, 2000)
-  const outTail = out ? `\n${out}` : ''
-  fail(`lint-rust: ${label} — помилка (код ${code}, rust.mdc)${outTail}`, reason)
-  return false
-}
-
-/**
- * Detector rust/check (read-only). Async (не блокує event loop) — детектор може виконуватись
- * у parallel lane `detectAll()` (ADR 260716-1354).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
- */
-export async function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  const { fail } = reporter
-  const cwd = ctx.cwd
-
-  if (!existsSync(join(cwd, 'Cargo.toml'))) {
-    // немає Cargo.toml → кроки Rust пропущено
-    return reporter.result()
-  }
-
-  const cargo = resolveCmd('cargo')
-  if (!cargo) {
-    fail('lint-rust: `cargo` не знайдено в PATH (Rust toolchain через rustup, rust.mdc)', 'cargo-missing')
-    return reporter.result()
-  }
-
-  if (
-    !(await runCargo('cargo fmt --check', cargo, ['fmt', '--all', '--', '--check'], cwd, fail, 'cargo-fmt-violation'))
-  ) {
-    return reporter.result()
-  }
-
-  await runCargo(
-    'cargo clippy -D warnings',
-    cargo,
-    ['clippy', '--all-targets', '--all-features', '--', '-D', 'warnings'],
-    cwd,
-    fail,
-    'cargo-clippy-violation'
-  )
-
-  const denyConfigPath = join(cwd, 'deny.toml')
-  if (!existsSync(denyConfigPath)) {
-    fail(
-      'lint-rust: cargo deny — немає deny.toml; запустіть `npx @7n/rules fix rust` локально для генерації (rust.mdc)',
-      'deny-config-missing'
-    )
-    return reporter.result()
-  }
-
-  const denyVersionResult = await spawnAsync(cargo, ['deny', '--version'])
-  const hasDeny = denyVersionResult.exitCode === 0
-  if (hasDeny) {
-    await runCargo('cargo deny check licenses', cargo, ['deny', 'check', 'licenses'], cwd, fail, 'cargo-deny-violation')
-  }
-  // cargo-deny не встановлено → перевірку ліцензій пропущено (старий код — pass)
-
-  return reporter.result()
-}

package/rules/rust/docs/index.md

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

package/rules/rust/lib/docs/has-cargo-toml.md

@@ -1,134 +0,0 @@
----
-type: JS Module
-title: has-cargo-toml.mjs
-resource: npm/rules/rust/lib/has-cargo-toml.mjs
-docgen:
-  crc: f55fc57e
----
-
-Модуль `has-cargo-toml.mjs` — rule-local утиліта для правил Rust, що визначає наявність маніфесту Cargo (`Cargo.toml`) у дереві файлової системи, починаючи з заданого кореневого каталогу. Використовується як applies-walker на рівні правила: дозволяє правилу Rust динамічно вирішувати, чи варто застосовуватися до конкретного workspace/cwd, шукаючи `Cargo.toml` у поточному каталозі або в будь-якому з підкаталогів.
-
-Реалізація — синхронний рекурсивний обхід каталогів з раннім поверненням (`early return`) при першому ж знайденому `Cargo.toml`, без читання вмісту файлів. Імена директорій, у які заходити не треба (наприклад, `node_modules`, `.git`, `.next`, `.turbo`), передаються ззовні через `Set<string>` — модуль свідомо не містить власного списку, щоб список ігнорувань був єдиним з тим, що в `npm/scripts/auto-rules.mjs` (на рівні виклику).
-
-Утиліта навмисно тримається rule-local (у каталозі правила `rust/lib/`), оскільки на момент написання її єдиний споживач — правило `rust`. У документуючому коментарі модуля зазначено: якщо з'явиться другий споживач — утиліту слід підняти у спільний `npm/scripts/lib/`.
-
-## Експорти / API
-
-Модуль експортує одну іменовану функцію:
-
-- `hasCargoTomlInTree(root, ignoredDirNames)` — `function`, named export.
-
-Інших експортів (default, типів, констант) у модулі немає.
-
-## Функції
-
-### `hasCargoTomlInTree(root, ignoredDirNames)`
-
-**Сигнатура:**
-
-```js
-export function hasCargoTomlInTree(root: string, ignoredDirNames: Set<string>): boolean
-```
-
-**Параметри:**
-
-- `root` — `string`. Абсолютний шлях до кореневого каталогу, з якого починається пошук. Передається у внутрішню функцію `walk` як стартова точка обходу.
-- `ignoredDirNames` — `Set<string>`. Множина імен директорій (саме базових імен — не шляхів), у які НЕ слід заходити під час обходу. Перевірка виконується через `ignoredDirNames.has(entry.name)`. Типові значення, які формує викликова сторона: `'node_modules'`, `'.git'`, `'.next'`, `'.turbo'`.
-
-**Повертає:**
-
-- `boolean` — `true`, якщо в піддереві з коренем `root` (включно з самим `root`) знайдено хоча б один файл з ім'ям `Cargo.toml`. `false` — якщо такого файла немає, або якщо корінь недоступний для читання.
-
-**Алгоритм:**
-
-1. Викликається внутрішня функція `walk(root)`.
-2. Усередині `walk(dir)` робиться спроба отримати вміст каталогу через `readdirSync(dir, { withFileTypes: true })`, що повертає масив об'єктів `Dirent`.
-3. Якщо `readdirSync` кидає виключення (наприклад, `EACCES`, `ENOENT`, `ENOTDIR`) — воно мовчки ловиться `catch {}` і функція повертає `false` для цього каталогу (обхід продовжується для інших гілок, якщо вони є).
-4. Виконується ітерація по `entries`:
-   - Якщо запис — це файл і його ім'я дорівнює рівно `'Cargo.toml'`, негайно повертається `true` (early return).
-   - Якщо запис — це каталог і його ім'я не входить у `ignoredDirNames`, рекурсивно викликається `walk(join(dir, entry.name))`; при `true` від рекурсії — негайно повертається `true`.
-5. Якщо жоден запис не дав `true`, повертається `false`.
-
-Порядок обходу — детерміністичний у межах одного запуску і визначається порядком, який повертає `readdirSync` (як правило, залежить від ФС/ОС). Це означає, що логічний результат (boolean) детерміністичний, але швидкість виявлення `Cargo.toml` залежить від порядку записів.
-
-Алгоритм має властивість «depth-first з раннім return»: знайшовши `Cargo.toml` у першій же підгілці, функція не обходить решту дерева.
-
-**Side effects:**
-
-- Виключно синхронні I/O-операції читання вмісту директорій через `readdirSync` із Node.js `fs`. Не читає вміст файлів, не пише на диск, не звертається до мережі, не змінює глобальний стан.
-- При помилках доступу до окремого каталогу не пробрасує виключення назовні — глушить їх через `try/catch` і повертає `false` лише для проблемної гілки.
-- Блокує event loop на час обходу (синхронне API). Для дуже великих дерев це може бути помітним; ризик частково мітигує ранній return і список `ignoredDirNames`, що відсікає типові важкі директорії на кшталт `node_modules`.
-
-**Внутрішня функція `walk(dir)`:**
-
-- `dir` — `string`, абсолютний шлях каталогу для обходу.
-- Повертає `boolean` — `true`, якщо в піддереві `dir` є `Cargo.toml`.
-- Замикається на параметр `ignoredDirNames` зовнішньої функції (тобто множина передається один раз і використовується на всіх рівнях рекурсії без повторної параметризації).
-
-## Залежності
-
-Зовнішні npm-залежності — відсутні. Модуль працює виключно на стандартній бібліотеці Node.js:
-
-- `node:fs` — імпортується `readdirSync` для синхронного читання вмісту каталогу з опцією `withFileTypes: true`, що повертає `Dirent[]` (для уникнення додаткових `statSync` на кожен запис).
-- `node:path` — імпортується `join` для безпечного склеювання шляхів `dir + entry.name` із врахуванням розділювача ОС.
-
-Імпорти використовують префікс `node:` (`node:fs`, `node:path`) — це канонічна форма посилання на вбудовані модулі Node.js, що відрізняє їх від npm-пакунків.
-
-Модуль написаний як ES Module (`.mjs`): використовуються `import` та `export`.
-
-Внутрішніх залежностей від інших файлів проєкту немає — модуль повністю самодостатній.
-
-## Потік виконання / Використання
-
-### Контекст застосування
-
-Функція проектована як applies-walker для правил Rust: правило викликає її, щоб дізнатися, чи має воно сенс у поточному репозиторії/workspace. Якщо `Cargo.toml` ніде не знайдено — правило застосовувати не треба.
-
-### Типовий виклик
-
-```js
-import { hasCargoTomlInTree } from './lib/has-cargo-toml.mjs'
-
-const IGNORED = new Set(['node_modules', '.git', '.next', '.turbo'])
-
-if (hasCargoTomlInTree(process.cwd(), IGNORED)) {
-  // правило Rust застосовується: десь у дереві є Cargo.toml
-} else {
-  // Rust-проєкту не виявлено — правило пропускається
-}
-```
-
-Список ігнорованих директорій формується викликовою стороною й має співпадати зі списком, який використовує `npm/scripts/auto-rules.mjs` (це вимога з заголовного коментаря модуля — щоб поведінка обходу була узгоджена між скриптом авто-правил і rule-local утилітою).
-
-### Розгортання потоку виконання
-
-1. Споживач (правило Rust) формує `Set<string>` ігнорованих імен директорій.
-2. Споживач викликає `hasCargoTomlInTree(root, ignoredDirNames)` із кореневим шляхом (зазвичай — поточний workspace або репозиторій).
-3. Усередині функції стартує `walk(root)`:
-   - Якщо `root` сам містить `Cargo.toml` як файл першого рівня — повертається `true` без рекурсії далі по цьому ж рівню (інші записи не перевіряються після першого ж `Cargo.toml`).
-   - Якщо `Cargo.toml` на першому рівні немає — обхід заглиблюється у кожен підкаталог, якого немає в `ignoredDirNames`.
-   - Перший же `true` із рекурсії припиняє обхід і пробрасує `true` нагору.
-4. Якщо все дерево пройдене без знахідки — повертається `false`.
-5. Споживач використовує boolean-результат для прийняття рішення про застосування правила.
-
-### Граничні випадки
-
-- **Порожній `ignoredDirNames`** (`new Set()`): функція обходить геть усе дерево, включно з `node_modules` тощо — це коректно, але повільно.
-- **Неіснуючий `root`**: `readdirSync` кидає `ENOENT`, помилка ловиться, функція повертає `false`.
-- **`root` не є директорією** (наприклад, шлях до файлу): `readdirSync` кидає `ENOTDIR`, ловиться `catch`, повертається `false`.
-- **Cargo.toml як директорія**: пропускається, бо перевірка йде через `entry.isFile() && entry.name === 'Cargo.toml'` — потрібен саме файл.
-- **Симлінки**: `withFileTypes: true` повертає `Dirent` з власними методами; `entry.isFile()` для симлінка поверне `false`, `entry.isDirectory()` — теж `false` (метод `isSymbolicLink()` тут не перевіряється), тож симлінки фактично не переходяться. Це свідомий вибір — захист від циклів через симлінки.
-- **Cargo.toml у самому корені**: знаходиться на першому ж рівні без рекурсії.
-- **Cargo.toml виключно всередині `node_modules`** (за умови, що `node_modules` у `ignoredDirNames`): не знаходиться, функція повертає `false`. Це навмисна поведінка: ні правила, ні авто-обхід не повинні «бачити» вендоровані Rust-маніфести з npm-залежностей.
-
-### Контекст у проєкті
-
-Згідно з заголовним коментарем файлу:
-
-- Утиліта живе у `npm/rules/rust/lib/` як rule-local — лише `rust`-правило її використовує.
-- Список ігнорованих директорій має узгоджуватися зі списком у `npm/scripts/auto-rules.mjs`.
-- Інваріант масштабування: при появі другого споживача — підняти модуль у спільний `npm/scripts/lib/`.
-
-## Rebuild Test
-
-За цією документацією модуль можна відтворити: один ES-модуль з імпортами `readdirSync` із `node:fs` та `join` із `node:path`, що експортує іменовану функцію `hasCargoTomlInTree(root, ignoredDirNames)`. Усередині — внутрішня рекурсивна функція `walk(dir)` із синхронним `readdirSync(dir, { withFileTypes: true })`, обгорнутим у `try/catch`, ітерацією по `Dirent`-записах, перевіркою `isFile() && name === 'Cargo.toml'` для негайного `true`, та рекурсією у підкаталоги через `join(dir, entry.name)` за умови `isDirectory() && !ignoredDirNames.has(name)`. Поведінкові інваріанти: ранній return при знахідці; повернення `false` при помилці читання каталогу; пропуск ігнорованих директорій; обхід не йде у симлінки (бо `isDirectory()` для симлінка повертає `false`); жодних побічних ефектів окрім читання структури директорій. Сигнатура: `(string, Set<string>) => boolean`.

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

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

package/rules/rust/lib/has-cargo-toml.mjs

@@ -1,37 +0,0 @@
-/**
- * Rule-level applies-walker правила rust: рекурсивно шукає Cargo.toml у
- * cwd або будь-якому workspace-підкаталозі. Пропускає `node_modules`, `.git`,
- * `.next`, `.turbo` за тим самим списком, що `npm/scripts/auto-rules.mjs`.
- *
- * Утиліта rule-local, бо лише `rust` потребує "знайти Cargo.toml у дереві";
- * якщо з'явиться другий споживач — підняти у `npm/scripts/lib/`.
- */
-import { readdirSync } from 'node:fs'
-import { join } from 'node:path'
-
-/**
- * Чи присутній хоч один Cargo.toml у дереві `root` (синхронно, з раннім return).
- * @param {string} root абсолютний шлях кореня
- * @param {Set<string>} ignoredDirNames імена директорій, в які НЕ заходимо
- * @returns {boolean} true, якщо знайдено Cargo.toml
- */
-export function hasCargoTomlInTree(root, ignoredDirNames) {
-  /**
-   * @param {string} dir абсолютний шлях каталогу для обходу
-   * @returns {boolean} true якщо в піддереві є Cargo.toml
-   */
-  function walk(dir) {
-    let entries
-    try {
-      entries = readdirSync(dir, { withFileTypes: true })
-    } catch {
-      return false
-    }
-    for (const entry of entries) {
-      if (entry.isFile() && entry.name === 'Cargo.toml') return true
-      if (entry.isDirectory() && !ignoredDirNames.has(entry.name) && walk(join(dir, entry.name))) return true
-    }
-    return false
-  }
-  return walk(root)
-}

package/rules/rust/main.json

@@ -1 +0,0 @@
-{ "auto": { "glob": ["**/Cargo.toml", "deny.toml"] } }

package/rules/rust/main.mdc

@@ -1,8 +0,0 @@
----
-description: Перевірка Rust коду
-globs: "**/{Cargo.toml,Cargo.lock,rustfmt.toml,clippy.toml,.vscode/extensions.json,package.json},**/*.rs"
-alwaysApply: false
-version: '1.4'
----
-
-Правило забезпечує форматування (rustfmt), лінт (clippy), CI workflow та покриття для Rust-проєктів.

package/rules/rust/package_json/concern.json

@@ -1,10 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "policy": {
-    "files": {
-      "single": "package.json",
-      "required": false
-    }
-  }
-}

package/rules/rust/package_json/package_json.mdc

@@ -1,12 +0,0 @@
-## Rego-gate: `cargo`, `rustfmt`, `clippy` заборонені у `package.json`
-
-Rego-пакет: `rust.package_json`
-
-Цільовий файл: `package.json`
-
-`cargo`, `rustfmt` і `clippy` — це частина **Rust toolchain**, а не npm-пакети. Вони **не додаються** у `dependencies`, `devDependencies` або `peerDependencies`. Встановлення:
-
-- **локально** — через `rustup` (`rustup component add rustfmt clippy`);
-- **у CI** — через крок `dtolnay/rust-toolchain@stable` із `with.components: rustfmt, clippy`.
-
-Gate видає deny, якщо `cargo`, `rustfmt` або `clippy` з'являється у будь-якій секції залежностей `package.json`.

package/rules/rust/package_json/package_json.rego

@@ -1,20 +0,0 @@
-# Перевірка `package.json` для Rust-проєктів (rust.mdc / lint.mdc).
-#
-# `cargo`, `rustfmt`, `clippy` — частина Rust toolchain (rustup), не npm-залежностей.
-# Вони мають бути у PATH через `rustup` локально або `dtolnay/rust-toolchain@stable` у CI.
-package rust.package_json
-
-import rego.v1
-
-banned_rust_tools := {"cargo", "rustfmt", "clippy"}
-
-deny contains msg if {
-	some field in {"dependencies", "devDependencies", "peerDependencies"}
-	deps := object.get(input, field, {})
-	some name, _ in deps
-	name in banned_rust_tools
-	msg := sprintf(
-		"package.json: %s.%s заборонений — Rust toolchain встановлюється через rustup / dtolnay/rust-toolchain@stable, не через npm (rust.mdc)",
-		[field, name],
-	)
-}

package/rules/rust/vscode_extensions/concern.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "policy": {
-    "files": {
-      "single": ".vscode/extensions.json",
-      "required": true
-    },
-    "missingMessage": ".vscode/extensions.json не існує — створи з recommendations \"rust-lang.rust-analyzer\" і \"tamasfe.even-better-toml\" (rust.mdc)"
-  }
-}

package/rules/rust/vscode_extensions/docs/fix-vscode_extensions.md

@@ -1,25 +0,0 @@
----
-type: JS Module
-title: fix-vscode_extensions.mjs
-resource: npm/rules/rust/vscode_extensions/fix-vscode_extensions.mjs
-docgen:
-  crc: 3353fe17
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Надайте мені чорнетку секції "overview", яку потрібно переписати, щоб я міг застосувати ваші інструкції.
-
-## Поведінка
-
-1. Ініціалізує логіку для виправлення VS Code Extensions.
-2. Імпортує шаблони логіки для додавання до VS Code Extensions з файлу `../../../scripts/lib/fix/vscode-ext-add.mjs`.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).