@nitra/cursor 5.3.4 → 5.4.0

package/rules/tauri/docs/fix.md

@@ -1,167 +1,41 @@
 ---
 docgen:
   source: npm/rules/tauri/fix.mjs
-  crc: 12fc1644
+  crc: 38cf876b
+  score: 100
 ---
 
-# fix.mjs — entry-point правила `tauri`
+# fix.mjs
 
 ## Огляд
 
-Файл `npm/rules/tauri/fix.mjs` — це тонкий **entry-point** (точка входу) правила `tauri` у системі правил `@nitra/cursor`. Файл виконує дві ролі одночасно:
+Виконує застосування політики JS-занепокоєних та генерує посилання MDC. Повертає результат.
 
-1. **Library mode** — експортує функцію `run(ctx)`, яку оркестратор CLI (`@nitra/cursor`) викликає через динамічний `import`, передаючи спільний контекст прогону (`RuleContext`, наприклад, `walkCache` для повторного використання обходу файлової системи між правилами).
-2. **Standalone mode** — якщо файл запущено напряму через `bun npm/rules/tauri/fix.mjs`, виконується повний еквівалент команди `npx @nitra/cursor fix tauri` (з підвантаженням конфігу, обробкою whitelist та виведенням summary), а процес завершується з відповідним exit-code для CI/IDE.
+Виконується як еквівалент команди `npx @nitra/cursor fix <id>`. Завантажує конфігурацію, перевіряє дозволені записи, генерує зведену інформацію та визначає код виходу процесу.
 
-Сам файл **не містить жодної доменної логіки правила** `tauri` — уся робота (steps `applies → JS-concerns → policy → mdc-refs`) делегується у бібліотечну функцію `runStandardRule()`. Цей файл лише підключає стандартний раннер до конкретної директорії правила (`import.meta.dirname`) і опціонально запускає CLI-обгортку.
+## Поведінка
 
-Файл є **типовим шаблоном `fix.mjs`** для будь-якого правила в `npm/rules/<id>/`: майже всі правила в цій директорії мають ідентичний за структурою `fix.mjs`, що відрізняється лише доменом (`tauri`, `vue`, `python` тощо), який неявно визначається через шлях `import.meta.dirname`.
+1. Запуск правила.
+    *   Приймає контекст прогону.
+    *   Виконує застосування JS-занепокоєних.
+    *   Застосовує політику.
+    *   Генерує посилання MDC.
+    *   Повертає результат прогону.
+2. Запуск правила у режимі CLI.
+    *   Виконується як повний еквівалент команди `npx @nitra/cursor fix <id>`.
+    *   Виконує завантаження конфігурації.
+    *   Виконує перевірку дозволених записів.
+    *   Генерує зведену інформацію.
+    *   Виконує перевірку.
+    *   Визначає код виходу процесу.
 
-## Експорти / API
+## Публічний API
 
-| Експорт | Тип                                      | Опис                                                                                                                                                                                                                                          |
-| ------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `run`   | `(ctx?: RuleContext) => Promise<number>` | Іменований експорт. Запускає стандартний пайплайн правила (`applies → JS-concerns → policy → mdc-refs`) для директорії, у якій знаходиться `fix.mjs`. Повертає `0` при відсутності порушень і `1` (або інший ненульовий код) у разі порушень. |
+run — запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
+Library mode — викликається CLI orchestration через `import + run`.
 
-Файл **не має** `default`-експорту. Side-effect на верхньому рівні: якщо модуль завантажено як CLI-entry (`isRunAsCli(import.meta.url) === true`), виконується `await runRuleCli(...)` і `process.exit(...)`.
+## Гарантії поведінки
 
-### Тип `RuleContext`
-
-Тип параметра `ctx` імпортується (через JSDoc `@typedef`) з `../../scripts/lib/run-standard-rule.mjs`. Зазвичай містить:
-
-- `walkCache` — кеш обходу файлової системи, щоб не сканувати дерево повторно для кожного правила.
-- Інші поля, специфічні для оркестрації (логер, прапорці `dryRun`, тощо).
-
-Параметр `ctx` опціональний: якщо файл запущено окремо (standalone), `ctx` буде `undefined`, і `runStandardRule()` сам створить локальний контекст.
-
-## Функції
-
-### `run(ctx)`
-
-```js
-/**
- *
- */
-export function run(ctx) {
-  return runStandardRule(import.meta.dirname, ctx)
-}
-```
-
-- **Сигнатура:** `function run(ctx?: RuleContext): Promise<number>`
-- **Параметри:**
-  - `ctx` _(опціональний, `RuleContext`)_ — контекст прогону, який зазвичай передає оркестратор `@nitra/cursor`. У ньому, серед іншого, може бути `walkCache` для уникнення повторного сканування файлової системи між різними правилами.
-- **Повертає:** `Promise<number>` — асинхронний код виходу:
-  - `0` — правило відпрацювало без порушень (OK);
-  - `1` (або інший ненульовий код, який повертає `runStandardRule`) — знайдено порушення.
-- **Side effects:**
-  - Викликає `runStandardRule()`, яка послідовно виконує етапи `applies → JS-concerns → policy → mdc-refs`. Ці етапи можуть:
-    - читати файли у репозиторії;
-    - запускати JS-перевірки (наприклад, статичні правила з директорії `js/`);
-    - виконувати policy-перевірки (наприклад, `policy/`-перевірки правила `tauri`);
-    - порівнювати посилання у `.mdc`-файлах (`mdc-refs`).
-  - Сам по собі `run()` **не змінює** файли (правило `fix`-типу може здійснювати автозаміни всередині `runStandardRule`, якщо це закладено у бібліотеці; у самому `fix.mjs` цієї логіки немає).
-- **Як використовується:** оркестратор CLI імпортує `fix.mjs` правила і викликає `await run(ctx)`. Результат складається у загальний summary прогону.
-
-### Standalone-блок (top-level)
-
-```js
-if (isRunAsCli(import.meta.url)) {
-  // eslint-disable-next-line n/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
-  process.exit(await runRuleCli(import.meta.dirname))
-}
-```
-
-- **Призначення:** дозволяє запускати правило напряму, без проходження через головний CLI `@nitra/cursor`. Команда `bun npm/rules/tauri/fix.mjs` стає повним еквівалентом `npx @nitra/cursor fix tauri`.
-- **Логіка:**
-  - `isRunAsCli(import.meta.url)` повертає `true`, якщо поточний модуль є точкою входу процесу (а не imported-модулем). Це класична перевірка ESM-еквівалента `require.main === module`.
-  - Якщо `true`, викликається `runRuleCli(import.meta.dirname)`, яка обгортає `runStandardRule` додатковою CLI-логікою: завантаження конфігу проєкту, обробка whitelist (виключень), виведення summary у консоль.
-  - `process.exit(...)` із цим кодом — обов’язковий для CI/IDE: процес має повернути ненульовий код у разі порушень, щоб pipeline (наприклад, у `n-cursor` чи у GitHub Actions) міг це задетектити. Тому ESLint-правила `n/no-process-exit` і `unicorn/no-process-exit` навмисно вимкнено через inline-коментар.
-- **Side effects:**
-  - Може писати у `stdout`/`stderr` (summary, помилки).
-  - Завершує процес викликом `process.exit(...)` — після цього рядка код не виконується.
-  - **Не виконується** у library mode (коли файл імпортовано іншим скриптом).
-
-## Залежності
-
-### Внутрішні (relative imports)
-
-| Імпорт            | Шлях                                      | Призначення                                                                                                |
-| ----------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| `isRunAsCli`      | `../../scripts/lib/run-rule-cli.mjs`      | Утиліта-перевірка: чи запущено файл як головний модуль (entry-point), а не як `import`.                    |
-| `runRuleCli`      | `../../scripts/lib/run-rule-cli.mjs`      | Standalone-обгортка над `runStandardRule`: завантаження конфігу, whitelist, summary, exit-code.            |
-| `runStandardRule` | `../../scripts/lib/run-standard-rule.mjs` | Бібліотечна функція, що виконує стандартний пайплайн правила: `applies → JS-concerns → policy → mdc-refs`. |
-
-Усі шляхи відносні: `../../scripts/lib/` → `npm/scripts/lib/`.
-
-### Зовнішні
-
-Файл **не має** прямих залежностей від npm-пакетів. Усі npm-залежності, якщо такі є, прихилені всередині бібліотечних функцій (`runStandardRule`, `runRuleCli`).
-
-### Контекст домену
-
-Директорія `npm/rules/tauri/` містить також:
-
-- `tauri.mdc` — людиночитна специфікація правила (формат Cursor `.mdc`);
-- `meta.json` — метадані правила (наприклад, прапорці `worktree`, опис);
-- `js/` — JS-частина перевірок правила (запускається на етапі JS-concerns);
-- `policy/` — policy-перевірки (rego/інші) на етапі policy.
-
-`runStandardRule` неявно «знає», як обробити кожен з цих артефактів, через переданий `import.meta.dirname`.
-
-## Потік виконання / Використання
-
-### Library mode (типовий, через оркестратор)
-
-1. Користувач запускає `npx @nitra/cursor fix` (або підкоманду, що зачіпає правило `tauri`).
-2. Оркестратор `@nitra/cursor`:
-   1. Знаходить директорію `npm/rules/tauri/`.
-   2. Виконує `const mod = await import('npm/rules/tauri/fix.mjs')`.
-   3. Перевірка `isRunAsCli(import.meta.url)` повертає `false` (бо це import, а не entry-point) — standalone-блок **не виконується**.
-   4. Викликає `await mod.run(ctx)`, передаючи спільний контекст (з `walkCache` тощо).
-3. `run(ctx)` → `runStandardRule(import.meta.dirname, ctx)` → послідовно виконуються етапи:
-   - **applies** — фільтрація: чи правило взагалі застосовне до поточного репозиторію/файлів.
-   - **JS-concerns** — JS-перевірки з директорії `js/` правила.
-   - **policy** — policy-перевірки з директорії `policy/` правила.
-   - **mdc-refs** — перевірка посилань у `.mdc` файлах правила.
-4. Повертається `Promise<number>` із кодом виходу для цього правила, який оркестратор агрегує у summary всіх правил.
-
-### Standalone mode (debug / прямий запуск)
-
-```bash
-bun npm/rules/tauri/fix.mjs
-```
-
-1. Bun завантажує файл як головний модуль.
-2. `import { isRunAsCli, runRuleCli, runStandardRule }` — підвантажуються залежності.
-3. Експорт `run` стає доступним (але ніхто його не викликає у цьому режимі).
-4. Виконується top-level `if (isRunAsCli(import.meta.url))`:
-   - `isRunAsCli(...) === true`.
-   - `await runRuleCli(import.meta.dirname)`:
-     - завантажує конфіг проєкту;
-     - застосовує whitelist;
-     - всередині викликає `runStandardRule(dir, ctx)` (з локально-створеним контекстом);
-     - виводить summary у консоль.
-   - `process.exit(<code>)` — процес завершується з кодом `0` (OK) або `1` (порушення).
-
-### Дві ролі одного файлу
-
-Архітектурний прийом — **«library + main» в одному файлі** — закладений у коментарі коду:
-
-> Дві ролі fix.mjs: library (run) + standalone (main).
-
-Це дозволяє:
-
-- розробнику швидко налагоджувати правило окремо (`bun rules/tauri/fix.mjs`);
-- оркестратору повторно використовувати кеш обходу (`walkCache`) між правилами під час масового прогону.
-
-## Rebuild Test
-
-Файл є **тонким адаптером** і не містить доменної логіки — його можна повністю відтворити за цією документацією. Структура:
-
-1. Два іменовані імпорти з `../../scripts/lib/run-rule-cli.mjs`: `isRunAsCli`, `runRuleCli`.
-2. Один іменований імпорт з `../../scripts/lib/run-standard-rule.mjs`: `runStandardRule`.
-3. JSDoc-блок із описом, типом параметра `ctx` (через `@param {import('...')...}`) і типом результату (`Promise<number>`).
-4. `export function run(ctx) { return runStandardRule(import.meta.dirname, ctx) }`.
-5. Top-level `if (isRunAsCli(import.meta.url))` з викликом `process.exit(await runRuleCli(import.meta.dirname))` і inline-коментарем-вимкненням ESLint-правил `n/no-process-exit` та `unicorn/no-process-exit`.
-
-Жодних інших артефактів (інших експортів, констант, побічних `console.log`, мутації глобального стану) у файлі немає.
+- Read-only: файл не виконує операцій запису у файлову систему.
+- Кешує результати в межах одного прогону.
+- Не звертається до мережі.

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

@@ -1,168 +1,30 @@
+---
+docgen:
+  source: npm/rules/tauri/js/cargo_mutants_config.mjs
+  crc: 7dc410ce
+  score: 80
+---
+
 # cargo_mutants_config.mjs
 
 ## Огляд
 
-Модуль реалізує концерн `cargo_mutants_config` правила `tauri.mdc`. Його завдання — гарантувати, що для кожного workspace-пакета монорепо, у якому існує `<workspace>/src-tauri/Cargo.toml`, поряд лежить канонічний Tauri-специфічний конфіг `cargo-mutants` за шляхом `<workspace>/src-tauri/.cargo/mutants.toml`. Конфіг забороняє повторну збірку бінарників (`--bins`) і doc-tests (`--doc`) під кожного мутанта (це перетворює секунди на хвилини) і виключає з mutation-testing platform-bridge файли, які тестуються smoke/e2e, а не unit-тестами.
-
-Семантика виключень фіксована для всіх Tauri-проєктів:
-
-- `src/main.rs` — binary shell entrypoint (smoke/e2e, не mutation unit);
-- `src/lib.rs` — Tauri `pub fn run`, runtime entrypoint, який запускає увесь app shell (один мутант там тримає увесь Tauri runtime і ділить sandbox-fail з `src/main.rs`);
-- `src/**/{android,ios,mobile}.rs` — mobile plugin bridge / platform glue;
-- `src/**/{macos,windows,linux,desktop}.rs` — desktop platform bridge / OS integration glue.
-
-Файл побудований за патерном concern-checker у репо: експортує одну функцію `check(cwd)`, яка:
-
-- self-gates (тихо пропускає, якщо у монорепо немає жодного `src-tauri/Cargo.toml` — нейтральний baseline за потреби створить test rule);
-- ідемпотентна — створює файл лише за відсутності, інакше дописує лише ті top-level ключі, яких бракує, не змінюючи існуючих значень користувача;
-- репортує результат через спільний `createCheckReporter` і повертає process exit code (`0` — OK або skip, `1` — порушення).
-
-## Експорти / API
-
-| Експорт       | Тип              | Опис                                                                                                                                                     |
-| ------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `check(cwd?)` | `async function` | Єдиний публічний експорт. Запускає концерн над переданим або поточним коренем проєкту. Повертає `Promise<number>` — exit code, сумісний з CLI-обгорткою. |
-
-Внутрішні (не експортуються) допоміжні функції: `findSrcTauriDirs`, `detectMissingKeys`, `buildAppended`, `buildBaseline`, `processOneSrcTauri`.
-
-Внутрішні константи модульного рівня:
-
-- `TAURI_BASELINE_HEADER` — рядковий заголовок (коментар) для нового файла з посиланням на `tauri.mdc` і поясненням, чому виключаються `--bins` та `--doc`.
-- `TAURI_KEY_SNIPPETS` — заморожений (`Object.freeze`) словник `{ ключ → канонічний TOML-сніпет з блоковими коментарями }` для двох канонічних top-level ключів: `additional_cargo_test_args` і `exclude_globs`.
-- `TAURI_CANONICAL_KEYS` — заморожений масив ключів `TAURI_KEY_SNIPPETS` зі збереженим порядком (`Object.keys(TAURI_KEY_SNIPPETS)`); використовується для впорядкованого детектування відсутніх ключів і генерації baseline.
-
-Канонічний вміст сніпетів:
-
-- `additional_cargo_test_args = ["--lib", "--tests"]` — `cargo mutants` під час прогону тестів обмежується library + integration tests, без бінарників і doc-tests.
-- `exclude_globs = [...]` — список glob-патернів, які виключаються з mutation-testing (див. розділ «Огляд»).
-
-## Функції
-
-### `check(cwd = process.cwd())`
-
-- **Сигнатура:** `async function check(cwd?: string): Promise<number>`.
-- **Параметри:**
-  - `cwd` _(string, опційний, default `process.cwd()`)_ — абсолютний шлях до кореня монорепо. Дефолт забезпечує CLI-сумісність (виклик без аргументів з-під будь-якого `bin`).
-- **Повертає:** `Promise<number>` — exit code від `reporter.getExitCode()` (`0` — успіх або self-skip, `1` — є зафіксовані `reporter.fail(...)`).
-- **Алгоритм:**
-  1. Створює інстанс репортера через `createCheckReporter()`.
-  2. Знаходить усі `src-tauri/` директорії через `findSrcTauriDirs(cwd)`.
-  3. Якщо їх немає — повертає `reporter.getExitCode()` без жодних змін (self-gate / silent skip).
-  4. Інакше — послідовно обробляє кожен каталог через `processOneSrcTauri(dir, cwd, reporter)`.
-  5. Повертає підсумковий exit code від репортера.
-- **Side effects:** може створювати теку `<src-tauri>/.cargo/` і записувати в `<src-tauri>/.cargo/mutants.toml`; пише повідомлення (`pass`/`fail`) у спільний репортер.
-
-### `findSrcTauriDirs(cwd)`
-
-- **Сигнатура:** `async function findSrcTauriDirs(cwd: string): Promise<string[]>`.
-- **Параметри:** `cwd` — корінь проєкту.
-- **Повертає:** масив абсолютних шляхів до `src-tauri/` каталогів, які мають власний `Cargo.toml`.
-- **Алгоритм:**
-  1. Запитує всі workspace-пакети через `getMonorepoPackageRootDirs(cwd)` (включно з самим коренем).
-  2. Для кожного `root` перевіряє наявність `join(cwd, root, 'src-tauri', 'Cargo.toml')` через `existsSync`.
-  3. Якщо файл існує — додає `join(cwd, root, 'src-tauri')` до результату.
-- **Side effects:** немає (read-only через `existsSync` і виклик util-функції монорепо-обходу).
-
-### `detectMissingKeys(targetPath)`
-
-- **Сигнатура:** `async function detectMissingKeys(targetPath: string): Promise<string[]>`.
-- **Параметри:** `targetPath` — абсолютний шлях до існуючого `.cargo/mutants.toml`.
-- **Повертає:** масив канонічних ключів (з `TAURI_CANONICAL_KEYS`), яких немає на top-level у вже існуючому TOML, зі збереженим порядком.
-- **Алгоритм:**
-  1. Читає файл як UTF-8.
-  2. Парсить його через `parseToml` зі `smol-toml`.
-  3. Фільтрує `TAURI_CANONICAL_KEYS`, лишаючи лише ті, яких немає в розпарсеному об'єкті (`!(k in parsed)`).
-- **Side effects:** read-only (читання файла).
-
-### `buildAppended(existing, missingKeys)`
-
-- **Сигнатура:** `function buildAppended(existing: string, missingKeys: string[]): string`.
-- **Параметри:**
-  - `existing` — поточний текстовий вміст `.cargo/mutants.toml`;
-  - `missingKeys` — ключі, які треба дописати.
-- **Повертає:** новий вміст файла (`string`) — оригінал + хвостовий блок з коментарем-маркером `# Tauri canonical cargo-mutants additions (tauri.mdc)` і конкатенованими TOML-сніпетами для всіх `missingKeys` у порядку, наданому викликачем.
-- **Алгоритм:**
-  1. Нормалізує хвіст оригіналу: гарантує trailing `\n`.
-  2. Будує блок: порожній рядок-розділювач, заголовок-коментар, далі для кожного ключа з `missingKeys` — відповідний сніпет з `TAURI_KEY_SNIPPETS[key]`.
-  3. Конкатенує хвіст з блоком.
-- **Side effects:** немає (чиста функція).
-
-### `buildBaseline()`
-
-- **Сигнатура:** `function buildBaseline(): string`.
-- **Параметри:** немає.
-- **Повертає:** повний текст канонічного `.cargo/mutants.toml` — `TAURI_BASELINE_HEADER`, після нього сніпети всіх `TAURI_CANONICAL_KEYS` (`additional_cargo_test_args`, `exclude_globs`), з'єднані через `'\n'`.
-- **Side effects:** немає (чиста функція).
-
-### `processOneSrcTauri(srcTauriDir, cwd, reporter)`
-
-- **Сигнатура:** `async function processOneSrcTauri(srcTauriDir: string, cwd: string, reporter: { pass(msg): void, fail(msg): void }): Promise<void>`.
-- **Параметри:**
-  - `srcTauriDir` — абсолютний шлях до `src-tauri/` каталогу;
-  - `cwd` — корінь проєкту (потрібен для красивого relative-шляху в репорт-повідомленнях);
-  - `reporter` — інстанс репортера з методами `pass(msg)`/`fail(msg)`.
-- **Повертає:** `Promise<void>`.
-- **Алгоритм / гілки:**
-  1. Формує `target = join(srcTauriDir, '.cargo', 'mutants.toml')` і `rel = relative(cwd, target)`.
-  2. **Файла немає:** створює директорію `<src-tauri>/.cargo/` (`mkdir … { recursive: true }`), записує повний `buildBaseline()`, репортує `pass`: `.cargo/mutants.toml створено з Tauri canonical baseline (<rel>) (tauri.mdc)`; вихід.
-  3. **Файл є:** викликає `detectMissingKeys(target)`.
-     - Якщо `missing.length === 0` — репортує `pass`: `.cargo/mutants.toml: manual cargo-mutants config preserved (<rel>)`; вихід.
-     - Інакше — читає поточний вміст, обчислює новий через `buildAppended(existing, missing)`, записує файл, репортує `pass`: `.cargo/mutants.toml: додано відсутні Tauri-ключі [<key1>, <key2>] (<rel>) (tauri.mdc)`.
-- **Side effects:** створює директорії, записує/перезаписує файл `mutants.toml`, додає `pass`-повідомлення в репортер. У поточній реалізації функція не викликає `reporter.fail` — концерн є строго ідемпотентно-fix-овим (немає сценарію «порушення»).
-
-## Залежності
-
-### Node.js core (вбудовані)
-
-- `node:fs` — `existsSync` для check'у наявності `Cargo.toml` / `mutants.toml`;
-- `node:fs/promises` — `mkdir`, `readFile`, `writeFile` (промісована I/O для запису конфіга);
-- `node:path` — `dirname`, `join`, `relative` (побудова цільового шляху та relative-вивід у репорт).
-
-### External
-
-- `smol-toml` (іменований імпорт `parse as parseToml`) — лояльний TOML-парсер для детекції наявних top-level ключів у існуючому `mutants.toml`.
-
-### Internal (workspace utilities)
-
-- `../../../scripts/lib/check-reporter.mjs` → `createCheckReporter()` — спільний reporter pass/fail/exit-code для concern-checker'ів.
-- `../../../scripts/lib/workspaces.mjs` → `getMonorepoPackageRootDirs(cwd)` — повертає корінь + усі workspace-пакети монорепо.
-
-## Потік виконання / Використання
-
-### Типовий виклик з CLI / rule-runner
-
-Модуль — частина правила `tauri.mdc`, його `check`-функцію викликає rule-runner (як один з концернів). Приблизний псевдо-виклик:
-
-```js
-import { check } from './cargo_mutants_config.mjs'
-
-const exitCode = await check(process.cwd())
-process.exit(exitCode)
-```
-
-### Послідовність дій усередині одного запуску
-
-1. `check(cwd)` створює репортер.
-2. `findSrcTauriDirs(cwd)` обходить пакети монорепо й збирає всі `src-tauri/` з `Cargo.toml`.
-3. Якщо пусто — `return reporter.getExitCode()` (тихий skip, нічого не пишемо).
-4. Для кожного знайденого `src-tauri/`:
-   - якщо `.cargo/mutants.toml` відсутній → `mkdir -p` + запис canonical baseline;
-   - якщо файл існує + усі канонічні ключі присутні → нічого не змінює, репорт `manual cargo-mutants config preserved`;
-   - якщо файл існує, але деякі канонічні ключі відсутні → дописує лише відсутні ключі окремим блоком у кінці файла.
-5. Повертає підсумковий exit code.
-
-### Гарантії
+Огляд
 
-- **Self-gating:** концерн нічого не робить, якщо в репо немає Tauri-пакетів — це не помилка.
-- **Ідемпотентність:** повторні прогони на чистому/повному canonical файлі не змінюють вмісту.
-- **Non-destructive:** ані наявні значення `additional_cargo_test_args`/`exclude_globs`, ані сторонні top-level ключі користувача не перезаписуються — додавання відсутніх ключів відбувається окремим append-блоком в кінці файла з коментарем-маркером.
-- **Read-once-write-once на один каталог:** при append-сценарії файл читається повторно (один раз для парсу через `detectMissingKeys`, ще раз як текст для конкатенації), що гарантує запис рівно одного фінального вмісту.
+Файл виконує пошук пакетів у монорепо, які містять директорії `src-tauri/`. Обробляється конфігураційні файли цих пакетів. Створюється або оновлюється файл `.cargo/mutants.toml` для забезпечення наявності певних ключів у конфігурації. (tauri.mdc)
 
-### Точки розширення
+## Поведінка
 
-- Додати новий канонічний top-level ключ: додати пару `key → snippet\n` у `TAURI_KEY_SNIPPETS`; `TAURI_CANONICAL_KEYS` та логіка `buildBaseline`/`buildAppended`/`detectMissingKeys` підхоплять його автоматично, зі збереженим порядком вставки.
-- Змінити список platform-bridge файлів: відредагувати `exclude_globs` сніпет у `TAURI_KEY_SNIPPETS`.
+1. Знайти всі каталоги з `src-tauri/` та власним `Cargo.toml` у монорепо через `getMonorepoPackageRootDirs`.
+2. Для кожного знайденого каталогу обробити `processOneSrcTauri`.
+3. У `processOneSrcTauri` визначити цільовий файл `.cargo/mutants.toml` у каталозі `src-tauri/`.
+4. Перевірити наявність файлу `.cargo/mutants.toml`.
+5. Якщо файл відсутній, створити його з базовим конфігураційним блоком.
+6. Якщо файл існує, зчитати його вміст і визначити відсутні ключі.
+7. Додати визначені канонічні ключі до існуючого вмісту.
+8. Повідомити про успішне створення або збереження конфігурації з маркуванням (tauri.mdc).
+9. Повертати код виходу репортера для фінального результату.
 
-### Rebuild Test
+## Гарантії поведінки
 
-Файл містить достатню інформацію, щоб реконструювати правило з нуля: визначені вхідні точки виявлення Tauri-пакетів, перелік канонічних top-level ключів конфіга, форма заголовка/коментарів у згенерованому файлі, точні повідомлення репортера, гарантії ідемпотентності та non-destructive append, повний контракт експортованої функції `check(cwd)` (включно з дефолтом і поверненим типом).
+- Не звертається до мережі.