@nitra/cursor 1.26.3 → 1.27.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 Формат — [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.26.3",
+  "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/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.3'
-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).