@7n/rules 1.0.0

package/rules/style/tooling/concern.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full",
+    "glob": [
+      "package.json",
+      ".stylelintrc.{json,js,cjs,mjs}",
+      "stylelint.config.{js,cjs,mjs}",
+      ".stylelintignore",
+      ".github/workflows/lint-style.yml"
+    ]
+  }
+}

package/rules/style/tooling/docs/fix-tooling.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: fix-tooling.mjs
+resource: npm/rules/style/tooling/fix-tooling.mjs
+docgen:
+  crc: a25e47d2
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Виконую завдання як технічний письменник.
+
+Файл забезпечує детерміновані виправлення файлової системи для автоматичного налаштування інструменту Stylelint. Публічна функція `patterns` виконує перехоплення помилок (fail-safe), не генеруючи винятків. Код спирається на конфігурацію `package.json` і гарантує, що директорія `dist/` виключена з перевірки Stylelint через створення або доповнення `.stylelintignore`, а також додає необхідну конфігурацію Stylelint до `package.json`.
+
+## Поведінка
+
+Поведінка:
+
+1. Перевіряється наявність файлу `.stylelintignore`. Якщо він відсутній, створюється з вмістом `dist/`.
+2. Якщо файл `.stylelintignore` існує, перевіряється, чи містить він рядок `dist/`. Якщо ні, до файлу додається рядок `dist/`.
+3. Перевіряється, чи міститься конфігурація `stylelint` у файлі `package.json`. Якщо конфігурація відсутня, вона додається до `package.json` з посиланням на `@nitra/stylelint-config`.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/style/tooling/docs/index.md

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

package/rules/style/tooling/docs/main.md

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/style/tooling/main.mjs
+docgen:
+  crc: 4333b971
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+  issues: anchor-miss:extensions.json,anchor-miss:settings.json,judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Please provide the code file you want me to document. I will then generate the "Огляд" section based on the provided "Поведінка" and the file's content, adhering to all specified rules.
+
+## Поведінка
+
+Поведінка:
+
+1. main: Перевіряє наявність конфігурації stylelint. Конфігурація може бути визначена у пакеті `package.json` або у зовнішніх файлах конфігурації, зокрема `.stylelintrc.json`, `.stylelintrc.js`, `.stylelintrc.cjs`, `.stylelintrc.mjs`, `stylelint.config.js`, `stylelint.config.cjs`, `stylelint.config.mjs`. Якщо жоден із цих варіантів відсутній, видається помилка, і пропонується додати конфігурацію до `package.json` з посиланням на `@nitra/stylelint-config` (згадка (js.mdc)).
+2. main: Перевіряє існування файлу `.stylelintignore`. Якщо він не існує, видається помилка, і пропонується створити його з вмістом `dist/`.
+3. main: Якщо `.stylelintignore` існує, він перевіряє, чи містить він рядок `dist/`. Якщо цього рядка немає, видається помилка з проханням додати його (згадка (style.mdc)).
+4. main: Перевіряє існування файлу `.github/workflows/lint-style.yml`. Якщо він відсутній, видається помилка з проханням його створити.
+5. Робота ігнорує шляхи в каталозі `.github` та `.git` під час перевірки.
+
+## Публічний API
+
+main — забезпечує дотримання стандартів стилізації проєкту відповідно до правил style.mdc
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/style/tooling/fix-tooling.mjs

@@ -0,0 +1,58 @@
+/**
+ * T0-autofix паттерни для `style/tooling` — детерміновані FS-виправлення:
+ * створення або доповнення `.stylelintignore` та додавання `stylelint` до `package.json`.
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Тип порушення визначається за `v.message`, не за агрегованим output-рядком.
+ */
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const STYLELINTIGNORE_MISSING_RE = /\.stylelintignore не існує/u
+const STYLELINTIGNORE_NO_DIST_RE = /\.stylelintignore не містить рядка dist\//u
+const NO_STYLELINT_CONFIG_RE = /Немає конфігу stylelint/u
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'style-stylelintignore-create',
+    test: violations => violations.some(v => STYLELINTIGNORE_MISSING_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, '.stylelintignore')
+      ctx.recordWrite?.(target)
+      writeFileSync(target, 'dist/\n', 'utf8')
+      return { touchedFiles: [target], message: 'створено .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-stylelintignore-dist-add',
+    test: violations => violations.some(v => STYLELINTIGNORE_NO_DIST_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const target = join(ctx.cwd, '.stylelintignore')
+      ctx.recordWrite?.(target)
+      appendFileSync(target, '\ndist/\n', 'utf8')
+      return { touchedFiles: [target], message: 'додано dist/ до .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-pkg-stylelint-add',
+    test: violations => violations.some(v => NO_STYLELINT_CONFIG_RE.test(v.message)),
+    apply: (_violations, ctx) => {
+      const pkgPath = join(ctx.cwd, 'package.json')
+      if (!existsSync(pkgPath)) return { touchedFiles: [] }
+      let pkg
+      try {
+        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+      } catch {
+        return { touchedFiles: [] }
+      }
+      if (pkg.stylelint) return { touchedFiles: [] }
+      ctx.recordWrite?.(pkgPath)
+      pkg.stylelint = { extends: '@nitra/stylelint-config' }
+      writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8')
+      return { touchedFiles: [pkgPath], message: 'додано stylelint до package.json' }
+    }
+  }
+]

package/rules/style/tooling/main.mjs

@@ -0,0 +1,78 @@
+/** @see ./docs/tooling.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+
+// Зовнішні файли конфігу stylelint, які підхоплює cosmiconfig. Канон нових
+// JS-конфігів — `.mjs`/`.cjs` (js.mdc), legacy `.js` лишається валідним.
+const STYLELINT_CONFIG_FILES = [
+  '.stylelintrc.json',
+  '.stylelintrc.js',
+  '.stylelintrc.cjs',
+  '.stylelintrc.mjs',
+  'stylelint.config.js',
+  'stylelint.config.cjs',
+  'stylelint.config.mjs'
+]
+
+/**
+ * Альтернатива полю `stylelint` у `package.json` — зовнішній файл конфігу. Якщо
+ * поля немає і файлу немає, фейлимося; якщо є хоч щось — пропускаємо. Поле
+ * `stylelint.extends == "@nitra/stylelint-config"` сам формат — у Rego.
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер
+ * @param {string} cwd корінь репозиторію
+ */
+async function checkStylelintConfigPresence(reporter, cwd) {
+  const { pass, fail } = reporter
+  const pkgPath = join(cwd, 'package.json')
+  if (!existsSync(pkgPath)) return
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  const hasField = pkg.stylelint && typeof pkg.stylelint === 'object'
+  const hasExternalCfg = STYLELINT_CONFIG_FILES.some(name => existsSync(join(cwd, name)))
+  if (hasField || hasExternalCfg) {
+    pass('Конфіг stylelint є — у package.json або окремим файлом')
+  } else {
+    fail('Немає конфігу stylelint — додай "stylelint": { "extends": "@nitra/stylelint-config" } до package.json')
+  }
+}
+
+// `.vscode/extensions.json` (`stylelint.vscode-stylelint`) і `.vscode/settings.json`
+// (`css.validate`/`scss.validate`/`less.validate: false`) — у rego-пакетах
+// `style_lint.vscode_extensions` і `style_lint.vscode_settings`, прогоняє
+// `npx @7n/rules fix`. JS-копії видалено, щоб не було двох джерел істини.
+
+/**
+ * Перевіряє відповідність проєкту правилам style.mdc
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd тощо)
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  await checkStylelintConfigPresence(reporter, cwd)
+
+  const ignorePath = join(cwd, '.stylelintignore')
+  if (existsSync(ignorePath)) {
+    const ignoreContent = await readFile(ignorePath, 'utf8')
+    if (ignoreContent.split('\n').some(line => line.trim() === 'dist/')) {
+      pass('.stylelintignore існує і містить dist/')
+    } else {
+      fail('.stylelintignore не містить рядка dist/ — додай його (style.mdc)')
+    }
+  } else {
+    fail('.stylelintignore не існує — створи з вмістом: dist/')
+  }
+
+  const wfPath = '.github/workflows/lint-style.yml'
+  if (existsSync(join(cwd, wfPath))) {
+    pass(`${wfPath} є (структуру перевіряє npx @7n/rules fix → style_lint.lint_style_yml)`)
+  } else {
+    fail(`${wfPath} не існує — створи його`)
+  }
+
+  return reporter.result()
+}

package/rules/style/tooling/tooling.mdc

@@ -0,0 +1,85 @@
+## Генерація та редагування стилів (Cursor і інші агенти)
+
+- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам'яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
+- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
+- **Запуск stylelint:** лише через **`n-rules lint style`** (локально — з auto-fix; у CI — `--no-fix`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-rules lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-rules lint --full`.
+- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
+
+## Канон налаштувань
+
+### `package.json`
+
+- `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
+
+Окремого `lint-style` скрипта немає — запуск через **`n-rules lint style`** (CI — `--no-fix`).
+
+```json title="package.json"
+  "devDependencies": {
+    "@nitra/stylelint-config": "^1.4.0"
+  },
+  "stylelint": {
+    "extends": "@nitra/stylelint-config"
+  },
+```
+
+У корені проєкту має бути **`.stylelintignore`**:
+
+```text title=".stylelintignore"
+dist/
+```
+
+### `.vscode/extensions.json`
+
+- Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
+
+### `.vscode/settings.json`
+
+- Вимкнення вбудованої CSS-валідації VS Code: [settings.json.snippet.json](./policy/vscode_settings/template/settings.json.snippet.json)
+
+### CI: `.github/workflows/lint-style.yml`
+
+- Канон: [lint-style.yml.snippet.yml](./policy/lint_style_yml/template/lint-style.yml.snippet.yml)
+
+Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-rules lint style --no-fix` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
+
+```yaml title=".github/workflows/lint-style.yml"
+name: StyleLint
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  stylelint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-bun-deps
+
+      - name: StyleLint
+        run: npx stylelint '**/*.{css,scss,vue}'
+```

package/rules/style/vscode_extensions/concern.json

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

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

@@ -0,0 +1,25 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/style/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.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл ініціює процес інтеграції визначених шаблонів у розширення VS Code шляхом запуску зовнішнього скрипта. Цей скрипт забезпечує впровадження архітектурних патернів у ці розширення.
+
+## Поведінка
+
+1. Ініціює процес застосування визначених шаблонів до розширень VS Code.
+2. Використовує зовнішній скрипт для додавання необхідних патернів до розширень.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

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

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

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

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

@@ -0,0 +1 @@
+{ "recommendations": ["stylelint.vscode-stylelint"] }

package/rules/style/vscode_extensions/vscode_extensions.mdc

@@ -0,0 +1,13 @@
+## .vscode/extensions.json: розширення для stylelint
+
+Rego-пакет: `style_lint.vscode_extensions`
+
+Цільовий файл: `.vscode/extensions.json`
+
+Перевіряє, що масив `recommendations` містить усі записи з канонічного template (subset-check). Додаткові розширення поза списком — дозволені.
+
+Канонічний template: [extensions.json.snippet.json](./template/extensions.json.snippet.json)
+
+**✓ Правильно** — `recommendations` містить `"stylelint.vscode-stylelint"` (може бути і більше елементів).
+
+**✗ Неправильно** — `recommendations` відсутній або не містить `"stylelint.vscode-stylelint"`.

package/rules/style/vscode_extensions/vscode_extensions.rego

@@ -0,0 +1,13 @@
+# Перевірка `.vscode/extensions.json` для style (style.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/extensions.json.snippet.json.
+package style.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 (style.mdc)", [rec])
+}

package/rules/style/vscode_settings/concern.json

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

package/rules/style/vscode_settings/template/settings.json.snippet.json

@@ -0,0 +1,5 @@
+{
+  "css.validate": false,
+  "less.validate": false,
+  "scss.validate": false
+}

package/rules/style/vscode_settings/vscode_settings.mdc

@@ -0,0 +1,19 @@
+## .vscode/settings.json: вимкнення вбудованих CSS/SCSS/Less валідаторів
+
+Rego-пакет: `style_lint.vscode_settings`
+
+Цільовий файл: `.vscode/settings.json`
+
+Leaf-by-leaf walker: перевіряє кожен ключ з template — його значення у `settings.json` має точно збігатися. Додаткові ключі у файлі — дозволені.
+
+Канонічний template: [settings.json.snippet.json](./template/settings.json.snippet.json)
+
+Обов'язкові значення:
+
+- `"css.validate": false`
+- `"less.validate": false`
+- `"scss.validate": false`
+
+**✓ Правильно** — усі три ключі присутні зі значенням `false`; можуть бути й інші ключі.
+
+**✗ Неправильно** — будь-який з ключів відсутній, має значення `true` або рядок (`"off"`).

package/rules/style/vscode_settings/vscode_settings.rego

@@ -0,0 +1,15 @@
+# Перевірка `.vscode/settings.json` для style (style.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/settings.json.snippet.json.
+# Top-level літеральні keys — leaf-by-leaf walker.
+package style.vscode_settings
+
+import rego.v1
+
+deny contains msg if {
+	some key, expected_value in data.template.snippet
+	actual := object.get(input, key, null)
+	actual != expected_value
+	msg := sprintf(".vscode/settings.json: \"%s\" має бути %v (style.mdc)", [key, expected_value])
+}

package/rules/tauri/cargo_mutants_config/cargo_mutants_config.mdc

@@ -0,0 +1,39 @@
+## Mutation-testing: семантика app shell та platform bridge
+
+`tauri` rule володіє Tauri-specific семантикою mutation-testing для каталога `src-tauri/`. Концерн `js/cargo_mutants_config.mjs` без дублювання додає у `<ws>/src-tauri/.cargo/mutants.toml` такі канонічні ключі:
+
+```toml title="<ws>/src-tauri/.cargo/mutants.toml"
+additional_cargo_test_args = ["--lib", "--tests"]
+
+exclude_globs = [
+  "src/main.rs",
+  "src/lib.rs",
+  "src/**/android.rs",
+  "src/**/ios.rs",
+  "src/**/mobile.rs",
+  "src/**/desktop.rs",
+  "src/**/macos.rs",
+  "src/**/windows.rs",
+  "src/**/linux.rs"
+]
+```
+
+Семантика (фіксована між Tauri-проєктами):
+
+- **`src/main.rs`** — binary shell entrypoint: запускає Tauri runtime, реєструє plugins/handlers і повертає управління циклу подій. Тестується smoke/e2e (запуск бінарника), не mutation unit;
+- **`src/lib.rs`** — Tauri runtime entrypoint (`pub fn run`): піднімає весь app shell. Один мутант там тримає весь Tauri runtime, тому ділить sandbox-фейл з `src/main.rs` і тестується smoke/e2e, а не mutation unit;
+- **`*android.rs`, `*ios.rs`, `*mobile.rs`** — mobile plugin bridge / platform glue: тонка обгортка над JNI/Objective-C виклики, mapping platform errors, виклики Tauri AppHandle і native API;
+- **`*macos.rs`, `*windows.rs`, `*linux.rs`, `*desktop.rs`** — desktop platform bridge / OS integration glue: opener/window APIs, OS-specific I/O, mapping platform errors.
+
+Ці файли мають містити **тільки platform boundary**: виклик plugin/native API, Tauri AppHandle, opener/window APIs, OS-specific I/O, mapping platform errors. Якщо у bridge-файлі з'являється pure/business logic — її потрібно винести у platform-neutral модуль (`src/auth/oauth.rs`, `src/gmail/message.rs`, …) і тестувати mutation-testing там.
+
+Це створює фіксовану семантику: `*android.rs`/`*macos.rs` — boundary-файли, а не місце для бізнес-логіки.
+
+### Ідемпотентність і взаємодія з `test`-rule
+
+- `test` rule створює універсальний нейтральний `.cargo/mutants.toml` (порожній з коментарем) для кожного Cargo.toml-manifest-файла — без framework-specific exclude'ів. Це наш baseline.
+- `tauri` rule додає Tauri-канонічні ключі **поверх** того, що вже є у `<ws>/src-tauri/.cargo/mutants.toml`:
+  - якщо файла немає — створює з повного Tauri-baseline;
+  - якщо обидва канонічні ключі (`additional_cargo_test_args`, `exclude_globs`) вже присутні — `manual cargo-mutants config preserved`, нічого не зміниться;
+  - якщо якийсь канонічний ключ відсутній — додається окремим блоком у кінці файла, без зміни існуючих значень.
+- Послідовний `fix test` → `fix tauri` створює Tauri-config; повторний `fix tauri` не дублює секцій; повторний `fix test` не перетирає Tauri-tuning.

package/rules/tauri/cargo_mutants_config/concern.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": { "scope": "full", "glob": ["**/src-tauri/Cargo.toml", "**/src-tauri/.cargo/mutants.toml"] }
+}

package/rules/tauri/cargo_mutants_config/docs/fix-cargo_mutants_config.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: fix-cargo_mutants_config.mjs
+resource: npm/rules/tauri/cargo_mutants_config/fix-cargo_mutants_config.mjs
+docgen:
+  crc: 61e1779c
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min-retry
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл відповідає за детерміноване формування або доповнення файлів `.cargo/mutants.toml` у директорії `src-tauri`. Він ініціалізує або канонізує Tauri-ключі в цих файлах, забезпечуючи коректність конфігурації. Логіка формування була перенесена сюди з попереднього detector-а, який лише реєстрував дефекти (`mutants-config-missing` / `mutants-keys-missing`). Механізм реалізовано через єдину поверхню лінту (`structured violations (test/apply)`). При роботі з цільовими каталогами здійснюється повторне сканування `src-tauri` з `ctx.cwd`, а статус кожного файлу перевіряється для забезпечення ідемпотентності (вже завершені стани ігноруються).
+
+## Поведінка
+
+1. `patterns` визначає логіку автоматичного виправлення конфігурацій `tauri/cargo_mutants_config`.
+2. Якщо виявлено відсутність конфігурації або необхідних ключів у файлах `<ws>/src-tauri/.cargo/mutants.toml`, ініціюється процес виправлення.
+3. Система сканує каталоги `src-tauri` з поточного робочого каталогу.
+4. Для кожного знайденого каталогу перевіряється наявність цільового файлу `.cargo/mutants.toml`.
+5. Якщо файл відсутній, він створюється з базовою конфігурацією.
+6. Якщо файл існує, перевіряються відсутні ключі у конфігурації.
+7. Якщо ключі відсутні, файл доповнюється за допомогою канонічних Tauri-ключів.
+8. Результати змін у файлах фіксуються у відповіді системи.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/tauri/cargo_mutants_config/docs/index.md

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

package/rules/tauri/cargo_mutants_config/docs/main.md

@@ -0,0 +1,30 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/tauri/cargo_mutants_config/main.mjs
+docgen:
+  crc: ae1727a0
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Ініціалізує процес через функцію `main`, а потім сканує робочу директорію для виявлення всіх каталогів з конфігурацією Tauri (`src-tauri/`). Для кожного знайденого каталогу перевіряє наявність файлу `.cargo/mutants.toml`, забезпечуючи його створення з канонічними налаштуваннями Tauri у разі відсутності. Якщо файл існує, він реєструє та додає відсутні канонічні ключі у конфігураційний файл, зберігаючи при цьому оригінальний вміст, і повідомляє про це через (tauri.mdc).
+
+## Поведінка
+
+Поведінка:
+
+1. Викликає `main` для ініціалізації процесу.
+2. Визначає всі каталоги, що містять конфігурацію Tauri (`src-tauri/`) у робочому просторі.
+3. Для кожного знайденого каталогу перевіряє наявність файлу `.cargo/mutants.toml`.
+4. Якщо файл відсутній, створює його, заповнюючи канонічними налаштуваннями Tauri. Повідомляє про створення файлу з маркером (tauri.mdc).
+5. Якщо файл присутній, виявляє та реєструє відсутні канонічні ключі в конфігурації.
+6. Якщо знайдені ключі відсутні, додає їх до існуючого файлу, зберігаючи原有 вміст. Повідомляє про додавання ключів з маркером (tauri.mdc).
+7. Якщо ключі присутні, зберігає існуючу конфігурацію без змін.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/tauri/cargo_mutants_config/fix-cargo_mutants_config.mjs

@@ -0,0 +1,53 @@
+/**
+ * T0-autofix для `tauri/cargo_mutants_config` — детерміноване створення або
+ * без-дублювання augment `<ws>/src-tauri/.cargo/mutants.toml` канонічними
+ * Tauri-ключами. Логіку перенесено з detector-а (read-only contract: detector
+ * лише звітує `mutants-config-missing` / `mutants-keys-missing`, запис — тут).
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Цільові каталоги резолвимо повторним скануванням src-tauri від `ctx.cwd`;
+ * стан кожного перевіряємо наново (idempotent — already-complete пропускаємо).
+ */
+import { existsSync } from 'node:fs'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+
+import {
+  MUTANTS_CONFIG_MISSING,
+  MUTANTS_KEYS_MISSING,
+  buildAppended,
+  buildBaseline,
+  detectMissingKeys,
+  findSrcTauriDirs
+} from './main.mjs'
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'tauri-cargo-mutants-config-create',
+    test: violations => violations.some(v => v.reason === MUTANTS_CONFIG_MISSING || v.reason === MUTANTS_KEYS_MISSING),
+    apply: async (violations, ctx) => {
+      const cwd = ctx.cwd
+      const srcTauriDirs = await findSrcTauriDirs(cwd)
+      const touchedFiles = []
+      for (const srcTauriDir of srcTauriDirs) {
+        const target = join(srcTauriDir, '.cargo', 'mutants.toml')
+        if (!existsSync(target)) {
+          ctx.recordWrite?.(target)
+          await mkdir(dirname(target), { recursive: true })
+          await writeFile(target, buildBaseline())
+          touchedFiles.push(target)
+          continue
+        }
+        const missing = await detectMissingKeys(target)
+        if (missing.length === 0) continue
+        ctx.recordWrite?.(target)
+        const existing = await readFile(target, 'utf8')
+        await writeFile(target, buildAppended(existing, missing))
+        touchedFiles.push(target)
+      }
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `створено/доповнено Tauri .cargo/mutants.toml: ${touchedFiles.join(', ')}` }
+    }
+  }
+]