@nitra/cursor 1.26.1 → 1.26.3

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.26.3] - 2026-05-26
+
+### Added
+
+- **`rules/tauri/js/cargo_mutants_config.mjs`**: новий концерн tauri-правила. Для кожного `<ws>/src-tauri/Cargo.toml` ідемпотентно гарантує наявність Tauri-канонічних ключів у `<ws>/src-tauri/.cargo/mutants.toml` — `additional_cargo_test_args = ["--lib", "--tests"]` та `exclude_globs` для `src/main.rs` (binary shell) і platform-bridge файлів (`*android.rs`, `*ios.rs`, `*mobile.rs`, `*desktop.rs`, `*macos.rs`, `*windows.rs`, `*linux.rs`). Семантика: ці файли — boundary, бізнес-логіка повинна жити у platform-neutral модулях. Файл відсутній → створює повний baseline; всі канонічні ключі є → `manual cargo-mutants config preserved`; частина ключів відсутня → додає лише відсутні в окремий блок у кінці, без зміни існуючих значень.
+- **`rules/tauri/js/tests/cargo_mutants_config.test.mjs`**: 7 тестів — silent skip без Tauri, створення baseline, ідемпотентність (повторний прогон байт-в-байт), збереження ручних налаштувань, partial-merge (додаються лише відсутні ключі), кілька src-tauri у різних workspaces, augmentation поверх нейтрального test-rule baseline.
+- **`rules/tauri/tauri.mdc` v1.3**: нові розділи «Виявлення проєкту Tauri» (опис маркерів і workspace-обходу) та «Mutation-testing: семантика app shell та platform bridge» з фіксованою семантикою boundary-файлів і ідемпотентністю взаємодії з `test`-rule.
+
+### Changed
+
+- **`rules/test/js/data/cargo_mutants_config/mutants.toml.baseline`**: видалено Tauri-specific `additional_cargo_test_args = ["--lib", "--tests"]` — `test`-rule baseline тепер універсальний (тільки коментар, ніяких exclude'ів та framework-припущень). Customization-семантика framework-rules-ів описана в коментарі baseline'а.
+- **`rules/test/test.mdc` v2.3**: додано розділ «Універсальний baseline і framework-specific tuning» — `test` володіє нейтральним baseline, framework-rules (tauri, capacitor) зобов'язані доповнювати ідемпотентно і не перетирати ручні налаштування.
+- **`rules/tauri/js/tooling.mjs`**: виявлення Tauri тепер обходить усі workspace-пакети через `getMonorepoPackageRootDirs()` (раніше — тільки корінь). Маркером є будь-що з: `<ws>/src-tauri/`, `<ws>/src-tauri/Cargo.toml`, `<ws>/src-tauri/tauri.conf.json`, `<ws>/tauri.conf.json`, `<ws>/package.json#dependencies/devDependencies` з `@tauri-apps/*`. Дозволяє tauri-rule працювати в monorepo-проєктах, де Tauri живе в одному з пакетів, а не в корені.
+- **`rules/test/js/tests/cargo_mutants_config.test.mjs`**: тест базлайну тепер перевіряє відсутність framework-specific ключів (`additional_cargo_test_args`, `exclude_globs`) у нейтральному baseline-файлі.
+
+## [1.26.2] - 2026-05-26
+
+### Changed
+
+- **`rules/js-lint/policy/jscpd/template/.jscpd.json.snippet.json`**: канон тепер містить поле `ignore` із трьома обов'язковими патернами — `.claude/worktrees/**`, `**/dist/**`, `**/CHANGELOG.md`. `**/CHANGELOG.md` додано тому, що release-журнали різних пакетів структурно повторюються (заголовки `## [x.y.z] - YYYY-MM-DD`, секції `### Added` / `### Changed` / `### Fixed` за Keep a Changelog) і `jscpd` при `minLines: 25` фіксує їх як клон — false positive (кожен `CHANGELOG.md` per-package за каноном `n-changelog`). Існуючий rego (`policy/jscpd/jscpd.rego`) уже застосовує subset-of до будь-якого масиву в снипеті, тож зміна не потребує правок коду — лише новий test-case у `jscpd_test.rego`.
+- **`rules/js-lint/js-lint.mdc` v1.26**: оновлено приклад `.jscpd.json` і опис під ним (тепер посилається на снипет як source of truth і пояснює, чому `**/CHANGELOG.md` у каноні).
+
 ## [1.26.1] - 2026-05-26
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.26.1",
+  "version": "1.26.3",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/js-lint/js-lint.mdc

@@ -2,7 +2,7 @@
 description: Перевірка JavaScript коду
 globs: "**/{.oxlintrc.json,eslint.config.js,.jscpd.json,knip.json,package.json},**/*.{js,mjs,cjs,jsx,ts,tsx}"
 alwaysApply: false
-version: '1.25'
+version: '1.26'
 ---
 
 **oxlint**, **ESLint**, **jscpd**, **knip**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`**, **`bunx knip`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config` мінімум `^3.9.2`** (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd/knip не додавай без потреби монорепо.
@@ -42,17 +42,19 @@ version: '1.25'
 
 Каталог `.claude/worktrees/` (робочі копії, які Claude Code створює через **superpowers:using-git-worktrees**) має ігноруватися: додай його у кореневий `.gitignore` (це штатне місце для не-комітних робочих копій), а в `.jscpd.json` додай `.claude/worktrees/**` у `ignore` як страховку на випадок запуску без `gitignore: true`. Без цього jscpd сканує паралельну копію репо в worktree і фіксує самозбіги між дзеркальними файлами.
 
+`**/CHANGELOG.md` теж у каноні `ignore`: release-журнали різних пакетів структурно повторюються (заголовки `## [x.y.z] - YYYY-MM-DD`, секції `### Added` / `### Changed` / `### Fixed` за Keep a Changelog), і `jscpd` за `minLines: 25` фіксує їх як клон, хоч це false positive — кожен `CHANGELOG.md` веде свій per-package журнал за каноном `n-changelog`, спільної історії не існує. Без цього в монорепо легко зловити блокуюче `bun run lint` на парі CHANGELOG-ів довжиною від ~25 рядків.
+
 ```json title=".jscpd.json"
 {
   "gitignore": true,
   "exitCode": 1,
   "reporters": ["console"],
   "minLines": 25,
-  "ignore": [".claude/worktrees/**", "**/dist/**"]
+  "ignore": [".claude/worktrees/**", "**/dist/**", "**/CHANGELOG.md"]
 }
 ```
 
-Канон базових ключів `.jscpd.json` (`gitignore`, `exitCode`, `reporters`, `minLines`): [.jscpd.json.snippet.json](./policy/jscpd/template/.jscpd.json.snippet.json)
+Канон ключів `.jscpd.json` (`gitignore`, `exitCode`, `reporters`, `minLines`, `ignore` як subset-of): [.jscpd.json.snippet.json](./policy/jscpd/template/.jscpd.json.snippet.json)
 
 ```text title=".gitignore (фрагмент)"
 .claude/worktrees/

package/rules/js-lint/policy/jscpd/template/.jscpd.json.snippet.json

@@ -2,5 +2,6 @@
   "gitignore": true,
   "exitCode": 1,
   "reporters": ["console"],
-  "minLines": 25
+  "minLines": 25,
+  "ignore": [".claude/worktrees/**", "**/dist/**", "**/CHANGELOG.md"]
 }

package/rules/tauri/js/cargo_mutants_config.mjs

@@ -0,0 +1,148 @@
+/**
+ * Концерн `cargo_mutants_config` правила tauri (tauri.mdc): для кожного
+ * `<workspace>/src-tauri/Cargo.toml` ідемпотентно гарантує наявність
+ * Tauri-specific cargo-mutants налаштувань у `<workspace>/src-tauri/.cargo/mutants.toml`.
+ *
+ * Семантика (фіксована між Tauri-проєктами):
+ *   - `src/main.rs` — binary shell entrypoint (smoke/e2e, не mutation unit);
+ *   - `src/**\/{android,ios,mobile}.rs` — mobile plugin bridge / platform glue;
+ *   - `src/**\/{macos,windows,linux,desktop}.rs` — desktop platform bridge / OS integration glue.
+ *
+ * Self-gating: silently skip, якщо в monorepo не знайдено жодного
+ * `<ws>/src-tauri/Cargo.toml` (test rule сам створить нейтральний baseline там,
+ * де потрібно).
+ *
+ * Ідемпотентність:
+ *   - якщо файл відсутній — створює з Tauri-canonical baseline;
+ *   - якщо файл існує і всі канонічні ключі вже є — `manual cargo-mutants config preserved`;
+ *   - якщо файл існує, але якихось канонічних top-level ключів немає — додає
+ *     лише відсутні ключі окремим блоком у кінці; існуючих значень не торкається.
+ */
+import { existsSync } from 'node:fs'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
+
+const TAURI_BASELINE_HEADER = `# .cargo/mutants.toml — Tauri canonical cargo-mutants config (tauri.mdc).
+# Виключаємо --bins і --doc щоб бінарник Tauri та doc-tests не перезбиралися
+# з нуля під кожного мутанта (секунди → хвилини).
+`
+
+const TAURI_KEY_SNIPPETS = Object.freeze({
+  additional_cargo_test_args: 'additional_cargo_test_args = ["--lib", "--tests"]\n',
+  exclude_globs: `# Platform bridge / app shell — boundary-файли (тестуються smoke/e2e, не mutation unit).
+# Якщо у bridge-файлі з'являється pure/business logic — винеси її у platform-neutral
+# модуль (src/auth/oauth.rs, src/gmail/message.rs, ...) і тестуй mutation-testing там.
+exclude_globs = [
+  "src/main.rs",
+  "src/**/android.rs",
+  "src/**/ios.rs",
+  "src/**/mobile.rs",
+  "src/**/desktop.rs",
+  "src/**/macos.rs",
+  "src/**/windows.rs",
+  "src/**/linux.rs"
+]
+`
+})
+
+const TAURI_CANONICAL_KEYS = Object.freeze(Object.keys(TAURI_KEY_SNIPPETS))
+
+/**
+ * Знаходить усі `<ws>/src-tauri/` каталоги з власним `Cargo.toml` у монорепо.
+ * Обходить workspace-пакети через `getMonorepoPackageRootDirs` (корінь + усі workspaces).
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до знайдених `src-tauri/` каталогів
+ */
+async function findSrcTauriDirs(cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const result = []
+  for (const root of roots) {
+    const srcTauriCargo = join(cwd, root, 'src-tauri', 'Cargo.toml')
+    if (existsSync(srcTauriCargo)) {
+      result.push(join(cwd, root, 'src-tauri'))
+    }
+  }
+  return result
+}
+
+/**
+ * Зчитує існуючий `.cargo/mutants.toml` і повертає top-level ключі, яких ще немає.
+ * @param {string} targetPath абсолютний шлях до файла
+ * @returns {Promise<string[]>} список відсутніх канонічних ключів (зі збереженням порядку TAURI_CANONICAL_KEYS)
+ */
+async function detectMissingKeys(targetPath) {
+  const existing = await readFile(targetPath, 'utf8')
+  const parsed = parseToml(existing)
+  return TAURI_CANONICAL_KEYS.filter(k => !(k in parsed))
+}
+
+/**
+ * Будує append-блок з відсутніх ключів. Існуючий вміст не торкається.
+ * @param {string} existing поточний вміст файла
+ * @param {string[]} missingKeys ключі, які треба додати
+ * @returns {string} новий вміст файла
+ */
+function buildAppended(existing, missingKeys) {
+  const tail = existing.endsWith('\n') ? existing : `${existing}\n`
+  const block = ['\n# Tauri canonical cargo-mutants additions (tauri.mdc)\n']
+  for (const key of missingKeys) block.push(TAURI_KEY_SNIPPETS[key])
+  return tail + block.join('')
+}
+
+/**
+ * Будує повний Tauri-canonical baseline (для випадку, коли файла ще немає).
+ * @returns {string} вміст для нового `.cargo/mutants.toml`
+ */
+function buildBaseline() {
+  return TAURI_BASELINE_HEADER + TAURI_CANONICAL_KEYS.map(k => TAURI_KEY_SNIPPETS[k]).join('\n')
+}
+
+/**
+ * Обробляє один `src-tauri/` каталог: створює або ідемпотентно доповнює `.cargo/mutants.toml`.
+ * @param {string} srcTauriDir абсолютний шлях до `src-tauri/`
+ * @param {string} cwd корінь проєкту (для relative-шляхів у репортах)
+ * @param {{ pass: (msg: string) => void, fail: (msg: string) => void }} reporter репортер концерну
+ * @returns {Promise<void>}
+ */
+async function processOneSrcTauri(srcTauriDir, cwd, reporter) {
+  const target = join(srcTauriDir, '.cargo', 'mutants.toml')
+  const rel = relative(cwd, target)
+
+  if (!existsSync(target)) {
+    await mkdir(dirname(target), { recursive: true })
+    await writeFile(target, buildBaseline())
+    reporter.pass(`.cargo/mutants.toml створено з Tauri canonical baseline (${rel}) (tauri.mdc)`)
+    return
+  }
+
+  const missing = await detectMissingKeys(target)
+  if (missing.length === 0) {
+    reporter.pass(`.cargo/mutants.toml: manual cargo-mutants config preserved (${rel})`)
+    return
+  }
+
+  const existing = await readFile(target, 'utf8')
+  await writeFile(target, buildAppended(existing, missing))
+  reporter.pass(`.cargo/mutants.toml: додано відсутні Tauri-ключі [${missing.join(', ')}] (${rel}) (tauri.mdc)`)
+}
+
+/**
+ * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const cwd = process.cwd()
+  const srcTauriDirs = await findSrcTauriDirs(cwd)
+  if (srcTauriDirs.length === 0) {
+    return reporter.getExitCode()
+  }
+  for (const dir of srcTauriDirs) {
+    await processOneSrcTauri(dir, cwd, reporter)
+  }
+  return reporter.getExitCode()
+}

package/rules/tauri/js/tooling.mjs

@@ -3,11 +3,15 @@
  * проєктів, у яких є маркер Tauri.
  *
  * Cross-file gating (JS):
- *   1. Tauri-маркер визначаємо за **будь-яким** з:
- *      - існує каталог `src-tauri/` у `cwd`;
- *      - існує файл `tauri.conf.json` у `cwd` або в workspace-пакетах;
- *      - кореневий `package.json#devDependencies` або `dependencies` містить
- *        ключ з префіксом `@tauri-apps/`.
+ *   1. Tauri-маркер визначаємо обходом усіх workspace-пакетів через
+ *      `getMonorepoPackageRootDirs()` (корінь + workspaces). Кожен workspace
+ *      перевіряється за **будь-яким** з:
+ *      - існує каталог `<ws>/src-tauri/`;
+ *      - існує файл `<ws>/src-tauri/Cargo.toml`;
+ *      - існує файл `<ws>/src-tauri/tauri.conf.json`;
+ *      - існує файл `<ws>/tauri.conf.json` (legacy flat-layout);
+ *      - `<ws>/package.json#dependencies` чи `devDependencies` містить ключ
+ *        з префіксом `@tauri-apps/`.
  *   2. Якщо маркера немає — пропустити перевірку (tauri-tooling не вимагається).
  *   3. Інакше — для `.vscode/extensions.json` зробити FS-existence + делегувати
  *      content `rego.tauri.vscode_extensions` через `runConftestBatch`.
@@ -17,9 +21,11 @@
  */
 import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import { runConftestBatch } from '../../../scripts/lib/run-conftest-batch.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
 /**
  * Чи є префікс `@tauri-apps/` у ключах `dependencies` або `devDependencies`.
@@ -39,16 +45,34 @@ function packageHasTauriDep(pkg) {
 }
 
 /**
- * Чи є у проєкті маркер Tauri: `src-tauri/`, `tauri.conf.json` (root або
- * workspace), або `@tauri-apps/*` у залежностях кореневого `package.json`.
+ * Чи має одиничний workspace-пакет маркер Tauri.
+ * @param {string} cwd корінь репо
+ * @param {string} ws відносний шлях workspace ('.' для root)
+ * @returns {Promise<boolean>} true, якщо в цьому workspace є Tauri
+ */
+async function workspaceHasTauriMarker(cwd, ws) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const srcTauri = join(base, 'src-tauri')
+  if (existsSync(srcTauri) && statSync(srcTauri).isDirectory()) return true
+  if (existsSync(join(base, 'src-tauri', 'Cargo.toml'))) return true
+  if (existsSync(join(base, 'src-tauri', 'tauri.conf.json'))) return true
+  if (existsSync(join(base, 'tauri.conf.json'))) return true
+  const pkgPath = join(base, 'package.json')
+  if (!existsSync(pkgPath)) return false
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  return packageHasTauriDep(pkg)
+}
+
+/**
+ * Чи є у проєкті (root або будь-якому workspace-пакеті) маркер Tauri.
  * @returns {Promise<boolean>} true, якщо проєкт використовує Tauri
  */
 async function projectHasTauriMarker() {
-  if (existsSync('src-tauri') && statSync('src-tauri').isDirectory()) return true
-  if (existsSync('tauri.conf.json')) return true
-  if (!existsSync('package.json')) return false
-  const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-  if (packageHasTauriDep(pkg)) return true
+  const cwd = process.cwd()
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  for (const ws of roots) {
+    if (await workspaceHasTauriMarker(cwd, ws)) return true
+  }
   return false
 }
 

package/rules/tauri/tauri.mdc

@@ -2,7 +2,7 @@
 description: Tauri
 globs: "**/src-tauri/**,**/tauri.conf.json"
 alwaysApply: false
-version: '1.2'
+version: '1.3'
 ---
 
 У `.vscode/extensions.json` `recommendations` має містити `tauri-apps.tauri-vscode`:
@@ -14,3 +14,53 @@ version: '1.2'
 ```
 
 Розширені Rust-вимоги (`rust-lang.rust-analyzer`, `tamasfe.even-better-toml`, скрипт `lint-rust`, CI `lint-rust.yml`) — у правилі **`rust`** (`n-rust.mdc`). Tauri-проєкт завжди має `src-tauri/Cargo.toml`, тому `rust` активується автоматично разом з `tauri`.
+
+## Виявлення проєкту Tauri
+
+Правило активується, якщо хоч у одному workspace-пакеті (корінь або будь-який пакет з `package.json#workspaces`) виявлений маркер Tauri:
+
+- існує каталог `<ws>/src-tauri/`;
+- існує `<ws>/src-tauri/Cargo.toml`;
+- існує `<ws>/src-tauri/tauri.conf.json`;
+- існує `<ws>/tauri.conf.json` (legacy flat-layout);
+- `<ws>/package.json#dependencies` чи `devDependencies` містить ключ з префіксом `@tauri-apps/`.
+
+Виявлення виконує `js/tooling.mjs` через `getMonorepoPackageRootDirs()`. Це дозволяє Tauri-rule працювати у монорепо, де Tauri живе в одному з пакетів (а не в корені), не вимагаючи кореневих маркерів.
+
+## 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/**/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;
+- **`*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-manifesta — без 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/test/js/data/cargo_mutants_config/mutants.toml.baseline

@@ -1,8 +1,7 @@
-# .cargo/mutants.toml — конфігурація cargo-mutants (опційно).
+# .cargo/mutants.toml — universal cargo-mutants baseline (test.mdc).
+# Цей baseline нейтральний: він не робить припущень про framework/app shell,
+# не виключає platform glue, generated wrappers або binary entrypoints.
+# Framework-specific tuning (Tauri, Capacitor тощо) належить відповідним
+# правилам — вони ідемпотентно доповнюють цей файл, не перетирають його.
 # cargo-mutants має робочі defaults; цей файл — стартова точка для customization.
 # Документація: https://mutants.rs/
-# Канон постачає правило `test` (@nitra/cursor).
-
-# Виключаємо --bins і --doc: бінарник Tauri та doc-tests щоразу перезбираються
-# з нуля навіть з кешем, що збільшує час кожного мутанту з секунд до хвилин.
-additional_cargo_test_args = ["--lib", "--tests"]

package/rules/test/test.mdc

@@ -1,6 +1,6 @@
 ---
 description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.2'
+version: '2.3'
 globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
@@ -82,4 +82,15 @@ Recursive globs ловлять файли всередині `tests/` так с
 
 Customization (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерни лише забезпечують наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.
 
+### Універсальний baseline і framework-specific tuning
+
+Правило `test` відповідає лише за **універсальний baseline** mutation-testing:
+
+- створює `.cargo/mutants.toml` для Rust crates (порожній, з коментом);
+- не робить припущень про framework/app shell;
+- не виключає platform glue, generated wrappers або binary entrypoints;
+- framework-specific tuning (`--lib`/`--tests`, `exclude_globs` для app-shell і platform bridge файлів) належить відповідним правилам (`tauri`, `capacitor` тощо).
+
+Якщо інше правило спеціалізує mutation-behavior — воно зобов'язане **доповнювати** існуючий `.cargo/mutants.toml` ідемпотентно (додавати лише відсутні ключі) і **не перетирати** ручні налаштування. Послідовний запуск `npx @nitra/cursor fix test` після `fix tauri` не має скидати tauri-tuning, і навпаки — повторний `fix tauri` не дублює секції.
+
 Додатково: коли `js-lint` enabled, концерн `stryker_config` ідемпотентно додає у кореневий `.gitignore` патерн `**/reports/stryker/` — увесь каталог Stryker-output-у (backup'и `tempDirName`, `mutation.json`, HTML/dashboard-репорти якщо додасте інші reporter-и). Це запобігає випадковому коміту build-артефактів.