@nitra/cursor 1.16.1 → 1.17.0

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.17.0] - 2026-05-24
+
+### Added
+
+- CLI-команда `n-cursor coverage` — оркестратор покриття + мутаційного тестування з discovery провайдерів через `.n-cursor.json#rules`. Канон `scripts.coverage` (контейнер `package.json`) у правилі `test`. Лок — прямий `withLock('coverage', ...)`.
+- Провайдер `js-lint/coverage/` — `bun test --coverage --coverage-reporter=lcov` + `bunx stryker run`; парсить lcov.info і `reports/stryker/mutation.json`.
+- Провайдер `rust/coverage/` — `cargo llvm-cov --json` + `cargo mutants --in-place`; парсить `data[0].totals` і `outcomes.json` (caught = caught + timeout; total = caught + missed; unviable виключено).
+- Policy `test.package_json` з template `package.json.contains.json` — substring-вимога `scripts.coverage` містити `n-cursor coverage`.
+
+### Fixed
+
+- `test/coverage/coverage.mjs::loadProvider` — коли правило `test` присутнє у `.n-cursor.json#rules` (як у самому `@nitra/cursor`), оркестратор знаходив власний файл `npm/rules/test/coverage/coverage.mjs` і намагався викликати його як провайдер (`provider.detect is not a function`). `loadProvider` тепер перевіряє, що модуль експортує обидва `detect` і `collect` як функції — інакше silently skip. Regression-тест: `пропускає модулі без detect/collect (наприклад сам оркестратор)`.
+
+### Changed
+
+- `test.mdc` 1.1 → 1.2: додано секцію «Покриття + мутаційне тестування» з посиланням на template.
+- `js-lint.mdc` 1.24 → 1.25: додано параграф із посиланням на JS-coverage-провайдер.
+- `rust.mdc` 1.0 → 1.1: додано параграф із посиланням на Rust-coverage-провайдер.
+- `npm/bin/n-cursor.js`: новий `case 'coverage'` + розширений help-string.
+
 ## [1.16.1] - 2026-05-24
 
 ### Fixed
@@ -162,7 +182,7 @@
   - `rules/test/fix/location/check.mjs` — перевіряє **лише `*.test.mjs`**, `*_test.rego` свідомо виключено з область перевірки (зафіксовано у docstring).
   - Додано test-case у `rules/test/fix/location/tests/check.test.mjs`: `*_test.rego` поряд із полісі НЕ є порушенням.
 - **Відкат переміщення `*_test.rego`**: 69 файлів, які раніше було помилково перенесено у `policy/<concern>/tests/<name>_test.rego`, повернуто у `policy/<concern>/<name>_test.rego` через `git mv`. Порожні `tests/` піддиректорії під `policy/` видалено.
-- **`npx @nitra/cursor fix test`** охоплює лише JS-тести: «✅ Всі 77 файлів *.test.mjs у каталозі tests/». Rego-тести продовжують перевірятись через `conftest verify` у правилі `rego`.
+- **`npx @nitra/cursor fix test`** охоплює лише JS-тести: «✅ Всі 77 файлів \*.test.mjs у каталозі tests/». Rego-тести продовжують перевірятись через `conftest verify` у правилі `rego`.
 
 ## [1.13.81] - 2026-05-23
 

package/README.md

@@ -134,9 +134,9 @@ npm/rules/<id>/
 
 | Що реалізує               | Канал виклику                                  | Куди                |
 | ------------------------- | ---------------------------------------------- | ------------------- |
-| JS-діагностика + автофікс | `npx @nitra/cursor fix` (fix-канал)          | `js/<concern>/`    |
+| JS-діагностика + автофікс | `npx @nitra/cursor fix` (fix-канал)            | `js/<concern>/`     |
 | JS-orchestrator лінту     | `bun run lint-<id>` через `n-cursor lint-<id>` | `lint/`             |
-| Rego-діагностика          | `npx @nitra/cursor fix` (fix-канал)          | `policy/<concern>/` |
+| Rego-діагностика          | `npx @nitra/cursor fix` (fix-канал)            | `policy/<concern>/` |
 
 `js/` і `policy/` обидва живлять fix-канал (`npx @nitra/cursor fix` запускає і JS-checks, і rego-policies), але **розділені за технологією**: JS у `js/`, rego у `policy/`. `lint/` тримає лише JS, що оркеструє `bun run lint-<id>`.
 

package/bin/n-cursor.js

@@ -1231,7 +1231,9 @@ try {
     }
     case 'check': {
       // Backward-compatibility alias. Перейменовано на `fix` у 1.13.84 (узгоджено з ім'ям файла `rules/<id>/fix.mjs`).
-      console.warn(`⚠️  Команда \`check\` deprecated — використовуйте \`fix\` (\`npx ${PACKAGE_NAME} fix [<rule>...]\`)`)
+      console.warn(
+        `⚠️  Команда \`check\` deprecated — використовуйте \`fix\` (\`npx ${PACKAGE_NAME} fix [<rule>...]\`)`
+      )
       await runFixCommand(args)
 
       break
@@ -1283,6 +1285,14 @@ try {
 
       break
     }
+    case 'coverage': {
+      // n-cursor coverage — оркестратор покриття + мутаційного тестування з discovery
+      // провайдерів через .n-cursor.json#rules (test.mdc).
+      const { runCoverageCli } = await import('../rules/test/coverage/coverage.mjs')
+      process.exitCode = await runCoverageCli()
+
+      break
+    }
     case 'skill': {
       process.exitCode = runSkillsCli(args)
 
@@ -1297,7 +1307,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, stop-hook, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, skill`
+        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, stop-hook, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, skill`
       )
       process.exitCode = 1
     }

package/package.json

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

package/rules/js-bun-redis/js/imports.mjs

@@ -16,11 +16,7 @@ import { join, relative } from 'node:path'
 
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import {
-  findRedisImportsInText,
-  isRedisScanSourceFile,
-  shouldSkipFileForRedisScan
-} from '../lib/redis-imports.mjs'
+import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from '../lib/redis-imports.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
 /**

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

@@ -0,0 +1,146 @@
+/**
+ * JS-провайдер для `n-cursor coverage`: збирає метрики покриття (`bun test --coverage`)
+ * і мутаційного тестування (Stryker) для JS/TS коду. Активується через `js-lint`
+ * правило в `.n-cursor.json#rules`; реальна applies-логіка — у `detect(cwd)`.
+ *
+ * Контракт провайдера — у docs/superpowers/specs/2026-05-24-coverage-rule-design.md.
+ */
+import { existsSync } from 'node:fs'
+import { mkdtemp, readFile, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+/**
+ * Резолвить cwd, у якому стоять JS-тести. Workspace-проєкти — перший workspace
+ * (mlmail: app/), single-package — корінь.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string|null>} абсолютний шлях або null якщо package.json відсутній
+ */
+async function resolveJsRoot(cwd) {
+  const rootPkgPath = join(cwd, 'package.json')
+  if (!existsSync(rootPkgPath)) return null
+  const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+  const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+  if (workspaces.length > 0) {
+    const wsPath = join(cwd, workspaces[0])
+    if (existsSync(join(wsPath, 'package.json'))) return wsPath
+  }
+  return cwd
+}
+
+/**
+ * Чи `scripts` містить coverage-сумісну команду.
+ * @param {Record<string, string> | undefined} scripts
+ * @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
+}
+
+/**
+ * Чи провайдер застосовний у поточному cwd.
+ * @param {string} cwd
+ * @returns {Promise<boolean>}
+ */
+export async function detect(cwd) {
+  const jsRoot = await resolveJsRoot(cwd)
+  if (jsRoot === null) return false
+  const pkgPath = join(jsRoot, 'package.json')
+  if (!existsSync(pkgPath)) return false
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  return hasCoverageScript(pkg.scripts)
+}
+
+/**
+ * Парс lcov.info: сумує LF/LH (рядки) і FNF/FNH (функції) по всіх records.
+ * @param {string} text
+ * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}}
+ */
+function parseLcov(text) {
+  const acc = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  for (const line of text.split('\n')) {
+    if (line.startsWith('LF:')) acc.lines.total += Number(line.slice(3))
+    else if (line.startsWith('LH:')) acc.lines.covered += Number(line.slice(3))
+    else if (line.startsWith('FNF:')) acc.functions.total += Number(line.slice(4))
+    else if (line.startsWith('FNH:')) acc.functions.covered += Number(line.slice(4))
+  }
+  return acc
+}
+
+/**
+ * Парс Stryker mutation.json: Killed+Timeout → caught; Survived+NoCoverage → до total.
+ * Compile/Runtime errors виключаються з total.
+ * @param {{files:Record<string,{mutants:Array<{status:string}>}>}} report
+ * @returns {{caught:number,total:number}}
+ */
+function parseStrykerReport(report) {
+  let caught = 0
+  let total = 0
+  for (const file of Object.values(report.files)) {
+    for (const mutant of file.mutants) {
+      if (mutant.status === 'Killed' || mutant.status === 'Timeout') {
+        caught += 1
+        total += 1
+      } else if (mutant.status === 'Survived' || mutant.status === 'NoCoverage') {
+        total += 1
+      }
+    }
+  }
+  return { caught, total }
+}
+
+/**
+ * Default runner — спавнить реальні bun-команди. Замінюється у тестах.
+ */
+const defaultRunner = {
+  async runJsCoverage({ cwd, lcovDir }) {
+    const proc = Bun.spawn(['bun', 'run', 'test:coverage', '--coverage-reporter=lcov', `--coverage-dir=${lcovDir}`], {
+      cwd,
+      stdout: 'inherit',
+      stderr: 'inherit'
+    })
+    return proc.exited
+  },
+  async runStryker({ cwd }) {
+    const proc = Bun.spawn(['bunx', 'stryker', 'run'], { cwd, stdout: 'inherit', stderr: 'inherit' })
+    return proc.exited
+  }
+}
+
+/**
+ * Збирає JS-метрики покриття + мутаційного тестування.
+ * @param {string} cwd корінь проєкту
+ * @param {{runner?: typeof defaultRunner}} [opts] runner-ін'єкція для тестів
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}}>>}
+ */
+export async function collect(cwd, opts = {}) {
+  const runner = opts.runner ?? defaultRunner
+  const jsRoot = await resolveJsRoot(cwd)
+  if (jsRoot === null) throw new Error('js-lint coverage: package.json не знайдено')
+
+  // 1. Coverage через bun test --coverage
+  const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
+  let coverage
+  try {
+    const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
+    if (code !== 0) throw new Error(`JS coverage exit ${code}`)
+    coverage = parseLcov(await readFile(join(lcovDir, 'lcov.info'), 'utf8'))
+  } finally {
+    await rm(lcovDir, { recursive: true, force: true })
+  }
+
+  // 2. Mutation через Stryker
+  await runner.runStryker({ cwd: jsRoot })
+  let mutationReport
+  try {
+    mutationReport = JSON.parse(await readFile(join(jsRoot, 'reports', 'stryker', 'mutation.json'), 'utf8'))
+  } catch {
+    throw new Error('js-lint coverage: stryker не залишив mutation.json — перевір stryker.config.mjs у проєкті')
+  }
+  const mutation = parseStrykerReport(mutationReport)
+
+  return [{ area: 'JS', coverage, mutation }]
+}

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.24'
+version: '1.25'
 ---
 
 **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 не додавай без потреби монорепо.
@@ -200,3 +200,7 @@ for (const item of arr) {
 ## Тести
 
 Проєкт має бути покритий unit-тестами (**Bun test**). Код: синтаксис Node **24+**, **top level await** (узгоджено з `engines.node` у `package.json`).
+
+## Покриття + мутаційне тестування JS
+
+Покриття + мутаційне тестування JS постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/js-lint/coverage/coverage.mjs`: `bun test --coverage --coverage-reporter=lcov` + `bunx stryker run`. Stryker конфігурується в `stryker.config.mjs` у JS-корені (single-package або `workspaces[0]`).

package/rules/js-run/js/runtime.mjs

@@ -36,11 +36,7 @@ import { existsSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
-import {
-  findBunyanImportsInText,
-  isBunyanScanSourceFile,
-  shouldSkipFileForBunyanScan
-} from '../lib/bunyan-imports.mjs'
+import { findBunyanImportsInText, isBunyanScanSourceFile, shouldSkipFileForBunyanScan } from '../lib/bunyan-imports.mjs'
 import { findUncheckedProcessEnvInText, isCheckEnvScanSourceFile } from '../lib/check-env-scan.mjs'
 import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import { runConftestBatch } from '../../../scripts/lib/run-conftest-batch.mjs'
@@ -52,10 +48,7 @@ import {
   resolveConnDirFromPackageJson
 } from '../lib/conn-imports-scan.mjs'
 import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import {
-  findPromiseSetTimeoutInText,
-  isPromiseSetTimeoutScanSourceFile
-} from '../lib/promise-settimeout-scan.mjs'
+import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../lib/promise-settimeout-scan.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 

package/rules/rust/coverage/coverage.mjs

@@ -0,0 +1,112 @@
+/**
+ * Rust-провайдер для `n-cursor coverage`: збирає метрики покриття (`cargo llvm-cov`)
+ * і мутаційного тестування (`cargo-mutants`) для Rust-коду. Активується через
+ * правило `rust` у `.n-cursor.json#rules`; applies-логіка — у `detect(cwd)`
+ * (наявність Cargo.toml у cwd або workspace-підкаталозі).
+ *
+ * Контракт провайдера — у docs/superpowers/specs/2026-05-24-coverage-rule-design.md.
+ */
+import { existsSync } from 'node:fs'
+import { mkdtemp, readFile, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import { hasCargoTomlInTree } from '../lib/has-cargo-toml.mjs'
+
+const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo', 'target'])
+
+/**
+ * Чи провайдер застосовний у поточному cwd.
+ * @param {string} cwd
+ * @returns {Promise<boolean>}
+ */
+export async function detect(cwd) {
+  if (existsSync(join(cwd, 'Cargo.toml'))) return true
+  return hasCargoTomlInTree(cwd, IGNORED_DIR_NAMES)
+}
+
+/**
+ * Знайти Cargo.toml: cwd/Cargo.toml або в одному з workspace-підкаталогів.
+ * @param {string} cwd
+ * @returns {Promise<string>} абсолютний шлях до Cargo.toml
+ */
+async function resolveCargoManifest(cwd) {
+  const rootManifest = join(cwd, 'Cargo.toml')
+  if (existsSync(rootManifest)) return rootManifest
+
+  const rootPkgPath = join(cwd, 'package.json')
+  if (existsSync(rootPkgPath)) {
+    const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+    const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+    for (const ws of workspaces) {
+      const tauriManifest = join(cwd, ws, 'src-tauri', 'Cargo.toml')
+      if (existsSync(tauriManifest)) return tauriManifest
+      const flatManifest = join(cwd, ws, 'Cargo.toml')
+      if (existsSync(flatManifest)) return flatManifest
+    }
+  }
+
+  throw new Error('rust coverage: Cargo.toml не знайдено (cwd + workspaces)')
+}
+
+const defaultRunner = {
+  async runLlvmCov({ manifestPath }) {
+    const proc = Bun.spawn(['cargo', 'llvm-cov', '--manifest-path', manifestPath, '--json', '--summary-only'], {
+      stdout: 'pipe',
+      stderr: 'inherit'
+    })
+    const stdout = await new Response(proc.stdout).text()
+    const exitCode = await proc.exited
+    return { exitCode, stdout }
+  },
+  async runCargoMutants({ manifestPath, outDir }) {
+    const proc = Bun.spawn(['cargo', 'mutants', '--in-place', '-o', outDir, '--manifest-path', manifestPath], {
+      stdout: 'inherit',
+      stderr: 'inherit'
+    })
+    return proc.exited
+  }
+}
+
+/**
+ * Збирає Rust-метрики покриття + мутаційного тестування.
+ * @param {string} cwd корінь проєкту
+ * @param {{runner?: typeof defaultRunner}} [opts]
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}}>>}
+ */
+export async function collect(cwd, opts = {}) {
+  const runner = opts.runner ?? defaultRunner
+  const manifestPath = await resolveCargoManifest(cwd)
+
+  // 1. Coverage через cargo llvm-cov
+  const { exitCode: llvmCode, stdout: llvmJson } = await runner.runLlvmCov({ manifestPath })
+  if (llvmCode !== 0) {
+    throw new Error('rust coverage: cargo llvm-cov упав — встанови: cargo install cargo-llvm-cov')
+  }
+  const totals = JSON.parse(llvmJson).data[0].totals
+  const coverage = {
+    lines: { covered: totals.lines.covered, total: totals.lines.count },
+    functions: { covered: totals.functions.covered, total: totals.functions.count }
+  }
+
+  // 2. Mutation через cargo mutants
+  const outDir = await mkdtemp(join(tmpdir(), 'rust-mutants-'))
+  let mutation
+  try {
+    // cargo-mutants exit ≠ 0 коли є missed — це нормально, не помилка.
+    // Реальний крах — відсутній outcomes.json.
+    await runner.runCargoMutants({ manifestPath, outDir })
+    let outcomes
+    try {
+      outcomes = JSON.parse(await readFile(join(outDir, 'mutants.out', 'outcomes.json'), 'utf8'))
+    } catch {
+      throw new Error('rust coverage: cargo mutants не залишив outcomes.json — встанови: cargo install cargo-mutants')
+    }
+    const caught = (outcomes.caught ?? 0) + (outcomes.timeout ?? 0)
+    mutation = { caught, total: caught + (outcomes.missed ?? 0) }
+  } finally {
+    await rm(outDir, { recursive: true, force: true })
+  }
+
+  return [{ area: 'Rust', coverage, mutation }]
+}

package/rules/rust/rust.mdc

@@ -2,7 +2,7 @@
 description: Перевірка Rust коду
 globs: "**/{Cargo.toml,Cargo.lock,rustfmt.toml,clippy.toml,.vscode/extensions.json,package.json},**/*.rs"
 alwaysApply: false
-version: '1.0'
+version: '1.1'
 ---
 
 **rustfmt** ([rust-lang/rustfmt](https://github.com/rust-lang/rustfmt)) — форматер; **clippy** ([rust-lang/rust-clippy](https://github.com/rust-lang/rust-clippy)) — лінтер. У скрипті **`lint-rust`** локально йдуть три кроки в одному рядку: `cargo fmt --all` → `cargo clippy --fix --allow-staged --allow-dirty --all-targets --all-features` → фінальний `cargo clippy --all-targets --all-features -- -D warnings`. У CI — без `--fix`: `cargo fmt --all -- --check` і `cargo clippy ... -- -D warnings` (див. `lint-rust.yml`).
@@ -25,3 +25,7 @@ Tauri-проєкт завжди має `src-tauri/Cargo.toml`, тому прав
 - `tauri` — `tauri-apps.tauri-vscode` (див. **tauri.mdc**).
 
 Обидва правила перевіряють `.vscode/extensions.json` за `contains`-семантикою; конкурентного запису немає.
+
+## Покриття + мутаційне тестування Rust
+
+Покриття + мутаційне тестування Rust постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/rust/coverage/coverage.mjs`: `cargo llvm-cov --json --summary-only` + `cargo mutants --in-place`. Бінарники: `cargo install cargo-llvm-cov && cargo install cargo-mutants`.

package/rules/test/coverage/coverage.mjs

@@ -0,0 +1,163 @@
+/**
+ * Канонічна команда `n-cursor coverage`: збирає метрики покриття + мутаційного
+ * тестування з усіх провайдерів, чиє правило активне в `.n-cursor.json#rules`,
+ * агрегує та записує COVERAGE.md у корінь проєкту.
+ *
+ * Discovery провайдерів — за `.n-cursor.json#rules`: для кожного `ruleId` зі
+ * списку шукаємо `npm/rules/<ruleId>/coverage/coverage.mjs` і динамічно
+ * імпортуємо. Якщо файлу немає — провайдер для цього правила відсутній (skip
+ * silently, не помилка).
+ *
+ * Лок — прямий виклик `withLock('coverage', steps)`. Один CLI-консумер, один
+ * callsite — спільна точка входу не виноситься (YAGNI, див. C4 у
+ * specs/2026-05-24-coverage-rule-design.md).
+ */
+import { existsSync } from 'node:fs'
+import { writeFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { withLock } from '../../../scripts/utils/with-lock.mjs'
+
+/** Корінь `npm/rules/` — `<rules>/test/coverage` → `<rules>` */
+const RULES_DIR = dirname(dirname(dirname(fileURLToPath(import.meta.url))))
+
+/**
+ * Сума двох coverage-totals.
+ * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} a
+ * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} b
+ * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}}
+ */
+export function addCoverage(a, b) {
+  return {
+    lines: { covered: a.lines.covered + b.lines.covered, total: a.lines.total + b.lines.total },
+    functions: {
+      covered: a.functions.covered + b.functions.covered,
+      total: a.functions.total + b.functions.total
+    }
+  }
+}
+
+/**
+ * Сума двох mutation-counts.
+ * @param {{caught:number,total:number}} a
+ * @param {{caught:number,total:number}} b
+ * @returns {{caught:number,total:number}}
+ */
+export function addMutation(a, b) {
+  return { caught: a.caught + b.caught, total: a.total + b.total }
+}
+
+/**
+ * Форматує covered/total як `XX.XX% (covered/total)`.
+ * @param {{covered:number,total:number}} metric
+ * @returns {string}
+ */
+export function formatCoverage({ covered, total }) {
+  const percent = total === 0 ? '—' : `${((covered / total) * 100).toFixed(2)}%`
+  return `${percent} (${covered}/${total})`
+}
+
+/**
+ * Форматує мутаційний score як `XX.XX%`.
+ * @param {{caught:number,total:number}} metric
+ * @returns {string}
+ */
+export function formatScore({ caught, total }) {
+  return total === 0 ? '—' : `${((caught / total) * 100).toFixed(2)}%`
+}
+
+/**
+ * Рендерить таблицю покриття + мутаційного тестування як Markdown.
+ * Без timestamp, щоб git diff рухався лише при зміні метрик.
+ * @param {Array<{area:string, coverage:{lines:{covered:number,total:number},functions:{covered:number,total:number}}, mutation:{caught:number,total:number}}>} rows
+ * @returns {string}
+ */
+export function renderMarkdown(rows) {
+  const lines = [
+    '# Coverage',
+    '',
+    '| Область | Рядки | Функції | Вбито мутацій | Score |',
+    '| --- | --- | --- | --- | --- |'
+  ]
+  for (const row of rows) {
+    lines.push(
+      `| ${row.area} | ${formatCoverage(row.coverage.lines)} | ${formatCoverage(row.coverage.functions)} | ` +
+        `${row.mutation.caught}/${row.mutation.total} | ${formatScore(row.mutation)} |`
+    )
+  }
+  return `${lines.join('\n')}\n`
+}
+
+/**
+ * Завантажує provider-модуль з `<rulesDir>/<ruleId>/coverage/coverage.mjs`.
+ * Повертає null коли:
+ *   - файлу немає (rule без coverage-провайдера),
+ *   - файл існує, але не експортує `detect` + `collect` як функції (наприклад,
+ *     `rules/test/coverage/coverage.mjs` — сам оркестратор, не провайдер).
+ * @param {string} rulesDir
+ * @param {string} ruleId
+ * @returns {Promise<{detect:Function, collect:Function}|null>}
+ */
+async function loadProvider(rulesDir, ruleId) {
+  const providerPath = join(rulesDir, ruleId, 'coverage', 'coverage.mjs')
+  if (!existsSync(providerPath)) return null
+  const mod = await import(providerPath)
+  if (typeof mod.detect !== 'function' || typeof mod.collect !== 'function') return null
+  return mod
+}
+
+/**
+ * Будує підсумковий рядок «Разом» через сумування всіх coverage/mutation.
+ * @param {Array<{area:string, coverage:object, mutation:object}>} rows
+ * @returns {{area:string, coverage:object, mutation:{caught:number,total:number}}}
+ */
+function buildTotalsRow(rows) {
+  const totalCoverage = rows.reduce((acc, row) => addCoverage(acc, row.coverage), {
+    lines: { covered: 0, total: 0 },
+    functions: { covered: 0, total: 0 }
+  })
+  const totalMutation = rows.reduce((acc, row) => addMutation(acc, row.mutation), { caught: 0, total: 0 })
+  return { area: '**Разом**', coverage: totalCoverage, mutation: totalMutation }
+}
+
+/**
+ * Виконує coverage-pipeline: discovery провайдерів за `.n-cursor.json#rules`,
+ * detect+collect для кожного, агрегація, запис COVERAGE.md.
+ * @param {{cwd?:string, rulesDir?:string}} [opts] ін'єкція для тестів
+ * @returns {Promise<number>} exit code (0 OK, 1 коли жоден провайдер не дав даних)
+ */
+export async function runCoverageSteps(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd()
+  const rulesDir = opts.rulesDir ?? RULES_DIR
+  const config = await readNCursorConfigLite(cwd)
+  const rows = []
+
+  for (const ruleId of config.rules) {
+    if (config.disableRules.includes(ruleId)) continue
+    const provider = await loadProvider(rulesDir, ruleId)
+    if (!provider) continue
+    if (!(await provider.detect(cwd))) continue
+    console.log(`→ ${ruleId} coverage…`)
+    rows.push(...(await provider.collect(cwd)))
+  }
+
+  if (rows.length === 0) {
+    console.error('✗ Жодного провайдера покриття не знайдено для активних правил у .n-cursor.json#rules')
+    return 1
+  }
+
+  rows.push(buildTotalsRow(rows))
+  const md = renderMarkdown(rows)
+  await writeFile(join(cwd, 'COVERAGE.md'), md, 'utf8')
+  console.log('✓ COVERAGE.md')
+  return 0
+}
+
+// Один оркестратор, один callsite — `withLock` викликається напряму, без спільної
+// точки входу. Канонічне обмеження «не імпортуй withLock у lint.mjs/fix.mjs напряму»
+// (scripts.mdc § withLock) націлене на дедуплікацію preamble серед багатьох файлів —
+// для одного coverage-консумера не релевантне (див. C4 у
+// specs/2026-05-24-coverage-rule-design.md).
+export const runCoverageCli = () => withLock('coverage', runCoverageSteps)

package/rules/test/policy/package_json/package_json.rego

@@ -0,0 +1,17 @@
+# Перевірка `package.json` для правила test (test.mdc).
+#
+# Канон надходить через --data: { "template": { "contains": ... } }
+# Структура --data сформована з template/package.json.contains.json.
+# Перевіряємо substring-вимоги до scripts.coverage:
+# рядок має містити "n-cursor coverage" (локальні розширення дозволені).
+package test.package_json
+
+import rego.v1
+
+deny contains msg if {
+	some script_name, needles in data.template.contains.scripts
+	actual := object.get(object.get(input, "scripts", {}), script_name, "")
+	some needle in needles
+	not contains(actual, needle)
+	msg := sprintf("package.json: scripts.%s має містити %q (test.mdc)", [script_name, needle])
+}

package/rules/test/policy/package_json/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи зі scripts.coverage (test.mdc)"
+}

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

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

package/rules/test/test.mdc

@@ -1,6 +1,6 @@
 ---
 description: JS-тести (*.test.mjs) живуть у каталозі tests/ поряд із джерельним файлом, а не безпосередньо в тій же директорії
-version: '1.1'
+version: '1.2'
 alwaysApply: true
 ---
 
@@ -58,3 +58,13 @@ Recursive globs ловлять файли всередині `tests/` так с
 `*_test.rego` перевіркою **не охоплюються** — вони не переміщуються.
 
 Пропускаються: `node_modules`, `.git`, `dist`, `build`, `.venv`, `venv`, шляхи з `.n-cursor.json:ignore`.
+
+## Покриття + мутаційне тестування
+
+Канонічна команда — `n-cursor coverage`: збирає метрики покриття (`bun test --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker, `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`.
+
+У `package.json` (корінь) має бути `scripts.coverage` із викликом `n-cursor coverage`:
+
+Канон `scripts.coverage` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)

package/scripts/utils/worktree-fingerprint.mjs

@@ -21,9 +21,7 @@ export function worktreeFingerprint(spawn = spawnSync) {
     // повертаються у `"..."` формі, і `git hash-object` не знаходить файл → throw → fingerprint=null.
     const untrackedRaw = git(['ls-files', '-z', '--others', '--exclude-standard'])
     const untrackedFiles = untrackedRaw.split('\0').filter(Boolean)
-    const pairs = untrackedFiles
-      .map(f => `${f}:${git(['hash-object', f]).trim()}`)
-      .sort()
+    const pairs = untrackedFiles.map(f => `${f}:${git(['hash-object', f]).trim()}`).sort()
     const raw = [commitHash, diffText, ...pairs].join('\n')
     return createHash('sha256').update(raw).digest('hex')
   } catch {