@7n/rules 1.20.1 → 1.21.0

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: не виконує операцій запису (ФС/БД).

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

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

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

@@ -1 +0,0 @@
-export { patterns } from '../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/rust/vscode_extensions/template/extensions.json.snippet.json

@@ -1 +0,0 @@
-{ "recommendations": ["rust-lang.rust-analyzer", "tamasfe.even-better-toml"] }

package/rules/rust/vscode_extensions/vscode_extensions.mdc

@@ -1,9 +0,0 @@
-## Перевірка `.vscode/extensions.json` (Rego-gate)
-
-Rego-пакет: `rust.vscode_extensions`
-
-Цільовий файл: `.vscode/extensions.json`
-
-Семантика `contains`: кожен запис з канону має бути присутнім у `recommendations` — додаткові розширення дозволені. Канон завантажується через `--data` з template-сніпету.
-
-Канонічний template: [extensions.json.snippet.json](./template/extensions.json.snippet.json)

package/rules/rust/vscode_extensions/vscode_extensions.rego

@@ -1,15 +0,0 @@
-# Перевірка `.vscode/extensions.json` для правила rust (rust.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Структура --data сформована з template/extensions.json.snippet.json.
-# Semantics: subset-of для recommendations — кожен з канону має бути присутнім,
-# інші екстеншени дозволені.
-package rust.vscode_extensions
-
-import rego.v1
-
-deny contains msg if {
-	some rec in data.template.snippet.recommendations
-	not rec in {r | some r in object.get(input, "recommendations", [])}
-	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (rust.mdc)", [rec])
-}