@nitra/cursor 1.26.2 → 1.27.0

package/CHANGELOG.md

@@ -4,6 +4,37 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.27.0] - 2026-05-26
+
+### Changed
+
+- **`rules/test/js/data/stryker_config/stryker.config.baseline.mjs`**: канон Stryker перейшов з `command` runner (`bun test`, `concurrency: 1`, `inPlace: true`, `coverageAnalysis: 'off'`) на `vitest` runner з `coverageAnalysis: 'perTest'`. У verify-first spike (158 мутантів, `benchmarks/runner-comparison/SPIKE.md`) це дало 31×–57× прискорення повного прогону і ≈262× для incremental noop-прогону. `inPlace` більше не потрібен — vitest-runner ізолює мутантів через AST-патчінг у пам'яті, без копіювання node_modules у sandbox (стара проблема command runner у Bun monorepo).
+- **`rules/test/js/stryker_config.mjs`**: концерн тепер копіює два canonical baseline-и у кожен JS-root: `stryker.config.mjs` + `vitest.config.js`. Ідемпотентність збережена — обидва файли копіюються лише якщо ще немає.
+- **`rules/js-lint/coverage/coverage.mjs`**: `detect()` тепер шукає `vitest` у `dependencies`/`devDependencies` (раніше — `scripts.test:coverage` або `scripts.test` з `--coverage`). `runJsCoverage` спавнить `bunx vitest run --coverage --coverage.reporter=lcov --coverage.reportsDirectory=…` замість `bun run test:coverage --coverage-reporter=lcov`. `parseLcov` без змін — формат lcov у Vitest v8-coverage співпадає з тим, що віддавало `bun test --coverage`. Якщо vitest відсутній — `detect` повертає `false` із одноразовим hint у stderr.
+- **`rules/test/policy/package_json/template/package.json.contains.json`**: канон scripts тепер містить додатково `"test": ["vitest"]` (substring-вимога). `coverage` як було — `["n-cursor coverage"]`.
+- **`rules/test/test.mdc` v2.4**: нові розділи «Vitest baseline та `package.json#scripts`» і «Frontend-варіант (Vue/Vite + happy-dom)». Текст про purpose `bun test --coverage` оновлено на `vitest run --coverage`. `globs` додатково ловить `vitest.config.js`.
+
+### Added
+
+- **`rules/test/js/data/vitest_config/vitest.config.baseline.js`**: новий canonical baseline для Vitest (`environment: 'node'`, `coverage.provider: 'v8'` із lcov+text-summary, `include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}']`). Концерн `stryker_config` копіює його як `vitest.config.js` у кожен JS-root.
+- **`rules/test/js/tests/stryker_config.test.mjs`**: нові кейси — копіювання `vitest.config.js`, перевірка вмісту нового Stryker baseline (`testRunner: 'vitest'`, `coverageAnalysis: 'perTest'`), ідемпотентність `vitest.config.js`.
+- **`rules/test/policy/package_json/package_json_test.rego`**: нові кейси для `scripts.test` — deny при відсутності/некоректному значенні, allow при substring-розширенні.
+
+## [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

package/package.json

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

package/rules/js-lint/coverage/coverage.mjs

@@ -1,7 +1,8 @@
 /**
- * JS-провайдер для `n-cursor coverage`: збирає метрики покриття (`bun test --coverage`)
- * і мутаційного тестування (Stryker) для JS/TS коду. Активується через `js-lint`
- * правило в `.n-cursor.json#rules`; реальна applies-логіка — у `detect(cwd)`.
+ * JS-провайдер для `n-cursor coverage`: збирає метрики покриття (`vitest run --coverage`)
+ * і мутаційного тестування (Stryker з vitest-runner + perTest) для JS/TS коду.
+ * Активується через `js-lint` правило в `.n-cursor.json#rules`; реальна applies-логіка
+ * — у `detect(cwd)`.
  *
  * Контракт провайдера — у docs/superpowers/specs/2026-05-24-coverage-rule-design.md.
  */
@@ -15,23 +16,22 @@ import { resolveJsRoot } from '../../../scripts/utils/resolve-js-root.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
+const VITEST_HINT = 'js-lint coverage: vitest відсутній у package.json — додай `vitest`, `@vitest/coverage-v8` та `@stryker-mutator/vitest-runner` у devDependencies (див. test.mdc)'
 
 /**
- * Чи `scripts` містить coverage-сумісну команду.
- * @param {Record<string, string> | undefined} scripts секція scripts з package.json
- * @returns {boolean} true, якщо є test:coverage або test з --coverage
+ * Чи у пакеті встановлено vitest (через dependencies або devDependencies).
+ * @param {{dependencies?: Record<string,string>, devDependencies?: Record<string,string>}} pkg package.json
+ * @returns {boolean}
  */
-function hasCoverageScript(scripts) {
-  if (!scripts || typeof scripts !== 'object') return false
-  if (typeof scripts['test:coverage'] === 'string' && scripts['test:coverage'].length > 0) return true
-  if (typeof scripts.test === 'string' && scripts.test.includes('--coverage')) return true
-  return false
+function hasVitestDep(pkg) {
+  return Boolean(pkg.devDependencies?.vitest) || Boolean(pkg.dependencies?.vitest)
 }
 
 /**
- * Чи провайдер застосовний у поточному cwd.
+ * Чи провайдер застосовний у поточному cwd. Активується, коли у JS-root знайдено
+ * `vitest` як залежність — інакше silent skip із hint у stderr (одноразово).
  * @param {string} cwd корінь проєкту
- * @returns {Promise<boolean>} true, якщо знайдено coverage-сумісний test-скрипт
+ * @returns {Promise<boolean>} true, якщо проєкт сумісний з vitest-based coverage
  */
 export async function detect(cwd) {
   const jsRoot = await resolveJsRoot(cwd)
@@ -39,7 +39,14 @@ export async function detect(cwd) {
   const pkgPath = join(jsRoot, 'package.json')
   if (!existsSync(pkgPath)) return false
   const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  return hasCoverageScript(pkg.scripts)
+  if (!hasVitestDep(pkg)) {
+    if (!detect._hinted) {
+      console.error(VITEST_HINT)
+      detect._hinted = true
+    }
+    return false
+  }
+  return true
 }
 
 /**
@@ -194,11 +201,11 @@ export function parseStrykerReport(report, jsRoot) {
  */
 const defaultRunner = {
   runJsCoverage({ cwd, lcovDir }) {
-    const r = spawnSync('bun', ['run', 'test:coverage', '--coverage-reporter=lcov', `--coverage-dir=${lcovDir}`], {
-      cwd,
-      stdio: 'inherit',
-      env: process.env
-    })
+    const r = spawnSync(
+      'bunx',
+      ['vitest', 'run', '--coverage', '--coverage.reporter=lcov', `--coverage.reportsDirectory=${lcovDir}`],
+      { cwd, stdio: 'inherit', env: process.env }
+    )
     return r.status ?? 1
   },
   runStryker({ cwd }) {
@@ -218,7 +225,7 @@ export async function collect(cwd, opts = {}) {
   const jsRoot = await resolveJsRoot(cwd)
   if (jsRoot === null) throw new Error('js-lint coverage: package.json не знайдено')
 
-  // 1. Coverage через bun test --coverage
+  // 1. Coverage через vitest run --coverage (v8 provider пише lcov.info у lcovDir)
   const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
   let coverage
   try {

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/js/data/stryker_config/stryker.config.baseline.mjs

@@ -1,15 +1,18 @@
 /** @type {import('@stryker-mutator/core').PartialStrykerOptions} */
 export default {
-  testRunner: 'command',
-  commandRunner: { command: 'bun test' },
-  // inPlace: уникає hoisted-node_modules issues у Bun monorepo (sandbox-копія втрачає resolution).
-  // Також тести, що читають git/fs-state (integration checks), працюють тільки in-place.
-  inPlace: true,
+  testRunner: 'vitest',
+  vitest: { configFile: 'vitest.config.js' },
+  // perTest: Stryker запускає лише тести, що покривають мутовану лінію — головний приріст
+  // швидкості проти command runner (де треба було б ганяти ввесь test-suite на кожен мутант).
+  coverageAnalysis: 'perTest',
+  // concurrency: за замовч. Stryker обирає os.cpus().length - 1.
+  // inPlace більше не потрібен — vitest-runner ізолює мутантів у пам'яті через AST-патчінг,
+  // без копіювання node_modules у sandbox (стара проблема command runner у Bun monorepo).
   tempDirName: 'reports/stryker/.tmp',
   reporters: ['json', 'clear-text'],
   jsonReporter: { fileName: 'reports/stryker/mutation.json' },
-  coverageAnalysis: 'off',
   // incremental: зберігає результати між запусками, відновлює після краш/kill.
+  // Дає ~262× прискорення на noop-прогонах (див. benchmarks/runner-comparison/SPIKE.md).
   incremental: true,
   incrementalFile: 'reports/stryker/incremental.json'
 }

package/rules/test/js/data/vitest_config/vitest.config.baseline.js

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    // Підхоплюються обидві основні розкладки: тести поряд із кодом (rule `test`-конвенція —
+    // у піддиректоріях `tests/`) і top-level integration suites у `<root>/tests/`.
+    include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}'],
+    environment: 'node',
+    coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] }
+  }
+})

package/rules/test/js/stryker_config.mjs

@@ -2,12 +2,12 @@
  * Концерн `stryker_config` правила test (test.mdc): якщо `js-lint` присутнє в
  * `.n-cursor.json#rules` і не у `disable-rules` — резолвить ВСІ JS-roots
  * (всі workspaces з package.json, або cwd у single-package) і копіює canonical
- * baseline `stryker.config.mjs` у кожен root, де файлу немає.
+ * baseline `stryker.config.mjs` + `vitest.config.js` у кожен root, де файлу немає.
  *
  * Self-gating: концерн silently skips коли `js-lint` не enabled — це навмисно,
  * щоб не шуміти у single-language проєктах без JS coverage tooling.
  *
- * Baseline — мінімум для запуску Stryker з bun test runner; mutate-патерни
+ * Baseline — мінімум для запуску Stryker з vitest-runner + perTest; mutate-патерни
  * лишаються на Stryker defaults (`src/**\/*.{js,mjs,ts,jsx,tsx,cjs}`).
  */
 import { existsSync } from 'node:fs'
@@ -21,7 +21,8 @@ import { ensureGitignoreEntries } from '../../../scripts/utils/ensure-gitignore-
 import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
-const BASELINE_PATH = join(HERE, 'data', 'stryker_config', 'stryker.config.baseline.mjs')
+const STRYKER_BASELINE_PATH = join(HERE, 'data', 'stryker_config', 'stryker.config.baseline.mjs')
+const VITEST_BASELINE_PATH = join(HERE, 'data', 'vitest_config', 'vitest.config.baseline.js')
 
 // Stryker-output патерн для .gitignore: увесь каталог reports/stryker/ — це
 // build-артефакти (`tempDirName` backup'и, mutation.json, HTML/dashboard-репорти
@@ -29,6 +30,24 @@ const BASELINE_PATH = join(HERE, 'data', 'stryker_config', 'stryker.config.basel
 // перелічування під-патернів. Подвійний-зірочка-префікс — для monorepo workspaces.
 const STRYKER_GITIGNORE_ENTRIES = ['**/reports/stryker/']
 
+/**
+ * Копіює baseline у target, якщо target ще не існує. Idempotent.
+ * @param {ReturnType<typeof createCheckReporter>} reporter check-reporter для логу pass/fail
+ * @param {string} cwd корінь проєкту (для relative-шляхів у логах)
+ * @param {string} baselinePath абсолютний шлях до canonical baseline
+ * @param {string} target абсолютний шлях, куди копіювати
+ * @param {string} label людиночитна мітка ("stryker.config.mjs" / "vitest.config.js")
+ * @returns {Promise<void>}
+ */
+async function ensureBaselineFile(reporter, cwd, baselinePath, target, label) {
+  if (existsSync(target)) {
+    reporter.pass(`${label} існує (${relative(cwd, target)})`)
+    return
+  }
+  await copyFile(baselinePath, target)
+  reporter.pass(`${label} створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
+}
+
 /**
  * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
  */
@@ -48,19 +67,16 @@ export async function check() {
     return reporter.getExitCode()
   }
 
-  if (!existsSync(BASELINE_PATH)) {
-    reporter.fail(`stryker.config.mjs canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`)
-    return reporter.getExitCode()
+  for (const baselinePath of [STRYKER_BASELINE_PATH, VITEST_BASELINE_PATH]) {
+    if (!existsSync(baselinePath)) {
+      reporter.fail(`canonical baseline не знайдено (${baselinePath}) — перевстанови @nitra/cursor`)
+      return reporter.getExitCode()
+    }
   }
 
   for (const jsRoot of jsRoots) {
-    const target = join(jsRoot, 'stryker.config.mjs')
-    if (existsSync(target)) {
-      reporter.pass(`stryker.config.mjs існує (${relative(cwd, target)})`)
-      continue
-    }
-    await copyFile(BASELINE_PATH, target)
-    reporter.pass(`stryker.config.mjs створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
+    await ensureBaselineFile(reporter, cwd, STRYKER_BASELINE_PATH, join(jsRoot, 'stryker.config.mjs'), 'stryker.config.mjs')
+    await ensureBaselineFile(reporter, cwd, VITEST_BASELINE_PATH, join(jsRoot, 'vitest.config.js'), 'vitest.config.js')
   }
 
   // Гарантуємо що Stryker temp/output ніколи не комітяться. Patterns

package/rules/test/policy/package_json/template/package.json.contains.json

@@ -1,5 +1,6 @@
 {
   "scripts": {
-    "coverage": ["n-cursor coverage"]
+    "coverage": ["n-cursor coverage"],
+    "test": ["vitest"]
   }
 }

package/rules/test/test.mdc

@@ -1,7 +1,7 @@
 ---
-description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.2'
-globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,.cargo/mutants.toml},**/*.test.mjs"
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.js (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
+version: '2.4'
+globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
 
@@ -62,7 +62,7 @@ Recursive globs ловлять файли всередині `tests/` так с
 
 ## Покриття + мутаційне тестування
 
-Канонічна команда — `n-cursor coverage`: збирає метрики покриття (`bun test --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker, `cargo-mutants`) з усіх активних провайдерів у `.n-cursor.json#rules` і пише `COVERAGE.md` у корінь проєкту. Лок і дедуп — `withLock('coverage', ...)`.
+Канонічна команда — `n-cursor coverage`: збирає метрики покриття (`vitest run --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker з vitest-runner + `coverageAnalysis: 'perTest'`, `cargo-mutants`) з усіх активних провайдерів у `.n-cursor.json#rules` і пише `COVERAGE.md` у корінь проєкту. Лок і дедуп — `withLock('coverage', ...)`.
 
 Провайдери живуть у `npm/rules/<rule>/coverage/coverage.mjs` (постачаються правилами мови/рантайму: `js-lint`, `rust`, у майбутньому `python` тощо). Оркестратор — у `npm/rules/test/coverage/coverage.mjs`.
 
@@ -72,9 +72,36 @@ Recursive globs ловлять файли всередині `tests/` так с
 
 ## Налаштування mutation-testing
 
-Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` і `scripts/stryker.config.mjs`.
+Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` + `vitest.config.js` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` + `app/vitest.config.js` і `scripts/stryker.config.mjs` + `scripts/vitest.config.js`.
 
-Канон Stryker config (мінімум для роботи з `bun test`): [stryker.config.baseline.mjs](./js/data/stryker_config/stryker.config.baseline.mjs)
+Канон Stryker config (Vitest runner + perTest): [stryker.config.baseline.mjs](./js/data/stryker_config/stryker.config.baseline.mjs)
+
+### Vitest baseline та `package.json#scripts`
+
+Поряд зі Stryker концерн `stryker_config` ідемпотентно копіює `vitest.config.js` (теж тільки якщо файлу немає). Canonical: [vitest.config.baseline.js](./js/data/vitest_config/vitest.config.baseline.js) — `environment: 'node'`, `coverage.provider: 'v8'` з lcov+text-summary репортами, `include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}']` (підхоплює обидві розкладки — тести у `tests/`-піддиректоріях і top-level integration suites у `<root>/tests/`).
+
+У `package.json#scripts` має бути `"test": "vitest run"` (canonical contains-substring `vitest` — допустимо `vitest run` та інші локальні розширення); опційно — `"test:watch": "vitest"`.
+
+Канон scripts: [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
+
+### Frontend-варіант (Vue/Vite + happy-dom)
+
+Для проєктів зі своїм `vite.config.js` `vitest.config.js` має реюзати vite-плагіни та aliases і перемкнути `environment` на `'happy-dom'` (або `'jsdom'`):
+
+```js
+import { defineConfig, mergeConfig } from 'vitest/config'
+import viteConfig from './vite.config.js'
+
+export default mergeConfig(viteConfig, defineConfig({
+  test: {
+    include: ['**/*.test.{js,mjs}', 'tests/**/*.test.{js,mjs}'],
+    environment: 'happy-dom',
+    coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] }
+  }
+}))
+```
+
+Концерн ставить **node-варіант** baseline; перехід на frontend — ручна модифікація, після якої концерн уже не перетирає (idempotent).
 
 Аналогічно, якщо `rust` присутнє в `rules` — створюється `.cargo/mutants.toml` у каталозі **кожного** Cargo.toml-маніфесту: кореневий `Cargo.toml`, `<workspace>/src-tauri/Cargo.toml` (Tauri-патерн) і `<workspace>/Cargo.toml` (flat workspace).
 
@@ -82,4 +109,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-артефактів.