@nitra/cursor 1.17.1 → 1.17.3

package/CHANGELOG.md

@@ -4,6 +4,36 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.17.3] - 2026-05-24
+
+### Added
+
+- Концерн `stryker_config` правила `test` тепер ідемпотентно додає у кореневий `.gitignore` патерни Stryker-output-у:
+  - `**/reports/stryker/.tmp/` — in-place backup-каталог (з baseline-у `tempDirName`).
+  - `**/reports/stryker/mutation.json` — JSON-репорт мутацій.
+  - Header-секція `# Stryker mutation testing (test.mdc)`, sectioning через `ensureGitignoreEntries`.
+- Спільний helper `npm/scripts/utils/ensure-gitignore-entries.mjs` — append-only оновлювач `.gitignore` з header-секціями. Idempotent (точне співпадіння рядка після `trim`), створює файл якщо немає, зберігає trailing-newline. 5 unit-тестів.
+
+### Changed
+
+- `test.mdc` 2.0 → 2.1: додано параграф про gitignore-керування Stryker-output-у в секцію «Налаштування mutation-testing».
+- `stryker_config` concern: додано виклик `ensureGitignoreEntries` після копіювання baseline-ів; репортер видає pass-повідомлення про додані патерни.
+
+## [1.17.2] - 2026-05-24
+
+### Added
+
+- Правило `test`: два нових концерни — `stryker_config` і `cargo_mutants_config`. Self-gating через `.n-cursor.json#rules`: концерн активний лише якщо відповідне залежне правило (`js-lint` / `rust`) enabled. **Iterate-all-workspaces**: при відсутності цільового файлу копіює canonical baseline у КОЖЕН workspace-каталог (не лише workspaces[0]).
+  - `stryker.config.mjs` у кожному JS-root (всі workspaces з package.json, або cwd у single-package) — мінімум для роботи з `bun test`.
+  - `.cargo/mutants.toml` у каталозі КОЖНОГО Cargo.toml-маніфесту: корінь + workspaces (з підтримкою Tauri-патерну `<ws>/src-tauri/Cargo.toml`) — комент-плейсхолдер; cargo-mutants має робочі defaults.
+- Спільні резолвери у `npm/scripts/utils/`: `resolveJsRoot` (single, для coverage-провайдера) + `resolveAllJsRoots` (plural, для test-концерну); `resolveCargoManifest` (single) + `resolveAllCargoManifests` (plural). Coverage-провайдери js-lint і rust реюзають single-варіанти.
+
+### Changed
+
+- `test.mdc` 1.2 → 2.0 (major): `alwaysApply: true → false`; явні `globs` (`.n-cursor.json`, `package.json`, `Cargo.toml`, mutation-config-цілі, `*.test.mjs`). Нова секція «Налаштування mutation-testing» з посиланнями на baselines.
+- `js-lint/coverage/coverage.mjs`: hint при missing `mutation.json` тепер вказує на `npx @nitra/cursor fix test`. `resolveJsRoot` витягнуто у спільний модуль.
+- `rust/coverage/coverage.mjs`: `resolveCargoManifest` витягнуто у спільний модуль (контракт `null` замість throw для missing manifest; user-facing throw зберігся на callsite).
+
 ## [1.17.1] - 2026-05-24
 
 ### Fixed

package/package.json

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

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

@@ -11,23 +11,7 @@ import { mkdtemp, readFile, rm } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 
-/**
- * Резолвить cwd, у якому стоять JS-тести. Workspace-проєкти — перший workspace
- * (наприклад: app/), single-package — корінь.
- * @param {string} cwd корінь проєкту
- * @returns {Promise<string|null>} абсолютний шлях до JS-root або 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
-}
+import { resolveJsRoot } from '../../../scripts/utils/resolve-js-root.mjs'
 
 /**
  * Чи `scripts` містить coverage-сумісну команду.
@@ -140,7 +124,11 @@ export async function collect(cwd, opts = {}) {
   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 у проєкті')
+    throw new Error(
+      'js-lint coverage: stryker не залишив mutation.json — ' +
+        'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
+        'або налаштуй його вручну'
+    )
   }
   const mutation = parseStrykerReport(mutationReport)
 

package/rules/rust/coverage/coverage.mjs

@@ -13,6 +13,7 @@ import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 
 import { hasCargoTomlInTree } from '../lib/has-cargo-toml.mjs'
+import { resolveCargoManifest } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
 
 const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo', 'target'])
 
@@ -26,30 +27,6 @@ export function detect(cwd) {
   return Promise.resolve(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 = {
   runLlvmCov({ manifestPath }) {
     const r = spawnSync('cargo', ['llvm-cov', '--manifest-path', manifestPath, '--json', '--summary-only'], {
@@ -76,6 +53,9 @@ const defaultRunner = {
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
   const manifestPath = await resolveCargoManifest(cwd)
+  if (manifestPath === null) {
+    throw new Error('rust coverage: Cargo.toml не знайдено (cwd + workspaces)')
+  }
 
   // 1. Coverage через cargo llvm-cov
   const { exitCode: llvmCode, stdout: llvmJson } = await runner.runLlvmCov({ manifestPath })

package/rules/test/js/cargo_mutants_config.mjs

@@ -0,0 +1,65 @@
+/**
+ * Концерн `cargo_mutants_config` правила test (test.mdc): якщо `rust` присутнє
+ * в `.n-cursor.json#rules` і не у `disable-rules` — резолвить ВСІ Cargo.toml
+ * (cwd і всі workspaces, з підтримкою Tauri-патерну) і копіює canonical
+ * baseline `.cargo/mutants.toml` у каталог кожного manifest'а, якщо файлу немає.
+ *
+ * Self-gating: концерн silently skips коли `rust` не enabled.
+ * Якщо `rust` enabled, але жодного Cargo.toml не знайдено — теж silently skip
+ * (manifest може з'явитися пізніше; це не помилка).
+ *
+ * Baseline — порожній файл з коментом; cargo-mutants має робочі defaults.
+ */
+import { existsSync } from 'node:fs'
+import { copyFile, mkdir } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { resolveAllCargoManifests } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const BASELINE_PATH = join(HERE, 'data', 'cargo_mutants_config', 'mutants.toml.baseline')
+
+/**
+ * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const cwd = process.cwd()
+  const config = await readNCursorConfigLite(cwd)
+
+  // Self-gate: rust має бути enabled
+  if (!config.rules.includes('rust') || config.disableRules.includes('rust')) {
+    return reporter.getExitCode()
+  }
+
+  const manifests = await resolveAllCargoManifests(cwd)
+  if (manifests.length === 0) {
+    // rust enabled, але Cargo.toml ще немає — silently skip (manifest може з'явитися пізніше)
+    return reporter.getExitCode()
+  }
+
+  if (!existsSync(BASELINE_PATH)) {
+    reporter.fail(
+      `.cargo/mutants.toml canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`
+    )
+    return reporter.getExitCode()
+  }
+
+  for (const manifestPath of manifests) {
+    const cargoDir = dirname(manifestPath)
+    const target = join(cargoDir, '.cargo', 'mutants.toml')
+
+    if (existsSync(target)) {
+      reporter.pass(`.cargo/mutants.toml існує (${relative(cwd, target)})`)
+      continue
+    }
+
+    await mkdir(dirname(target), { recursive: true })
+    await copyFile(BASELINE_PATH, target)
+    reporter.pass(`.cargo/mutants.toml створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
+  }
+  return reporter.getExitCode()
+}

package/rules/test/js/data/cargo_mutants_config/mutants.toml.baseline

@@ -0,0 +1,4 @@
+# .cargo/mutants.toml — конфігурація cargo-mutants (опційно).
+# cargo-mutants має робочі defaults; цей файл — стартова точка для customization.
+# Документація: https://mutants.rs/
+# Канон постачає правило `test` (@nitra/cursor).

package/rules/test/js/data/stryker_config/stryker.config.baseline.mjs

@@ -0,0 +1,12 @@
+/** @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,
+  tempDirName: 'reports/stryker/.tmp',
+  reporters: ['json', 'clear-text'],
+  jsonReporter: { fileName: 'reports/stryker/mutation.json' },
+  coverageAnalysis: 'off'
+}

package/rules/test/js/stryker_config.mjs

@@ -0,0 +1,75 @@
+/**
+ * Концерн `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, де файлу немає.
+ *
+ * Self-gating: концерн silently skips коли `js-lint` не enabled — це навмисно,
+ * щоб не шуміти у single-language проєктах без JS coverage tooling.
+ *
+ * Baseline — мінімум для запуску Stryker з bun test runner; mutate-патерни
+ * лишаються на Stryker defaults (`src/**\/*.{js,mjs,ts,jsx,tsx,cjs}`).
+ */
+import { existsSync } from 'node:fs'
+import { copyFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { ensureGitignoreEntries } from '../../../scripts/utils/ensure-gitignore-entries.mjs'
+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')
+
+// Stryker-output патерни для .gitignore: temp-каталог з backup-файлами
+// (`tempDirName: 'reports/stryker/.tmp'` у baseline) і JSON-репорт мутацій.
+// Канон in-place mode у baseline лишає backup'и у `reports/stryker/.tmp/backup-XXX/`,
+// які НЕ можна комітити. Подвійний-зірочка-префікс покриває всі workspaces.
+const STRYKER_GITIGNORE_ENTRIES = ['**/reports/stryker/.tmp/', '**/reports/stryker/mutation.json']
+
+/**
+ * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const cwd = process.cwd()
+  const config = await readNCursorConfigLite(cwd)
+
+  // Self-gate: js-lint має бути enabled
+  if (!config.rules.includes('js-lint') || config.disableRules.includes('js-lint')) {
+    return reporter.getExitCode()
+  }
+
+  const jsRoots = await resolveAllJsRoots(cwd)
+  if (jsRoots.length === 0) {
+    reporter.fail('test: js-lint enabled, але кореневий package.json не знайдено (test.mdc)')
+    return reporter.getExitCode()
+  }
+
+  if (!existsSync(BASELINE_PATH)) {
+    reporter.fail(
+      `stryker.config.mjs canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @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)`)
+  }
+
+  // Гарантуємо що Stryker temp/output ніколи не комітяться. Patterns
+  // покривають усі workspaces через `**/`-префікс (єдиний root .gitignore).
+  const { added } = await ensureGitignoreEntries(cwd, STRYKER_GITIGNORE_ENTRIES, 'Stryker mutation testing (test.mdc)')
+  if (added.length > 0) {
+    reporter.pass(`.gitignore: додано Stryker-патерни (${added.join(', ')}) (test.mdc)`)
+  }
+  return reporter.getExitCode()
+}

package/rules/test/test.mdc

@@ -1,7 +1,8 @@
 ---
-description: JS-тести (*.test.mjs) живуть у каталозі tests/ поряд із джерельним файлом, а не безпосередньо в тій же директорії
-version: '1.2'
-alwaysApply: true
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
+version: '2.1'
+globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,.cargo/mutants.toml},**/*.test.mjs"
+alwaysApply: false
 ---
 
 ## Конвенція розміщення тестів
@@ -68,3 +69,17 @@ Recursive globs ловлять файли всередині `tests/` так с
 У `package.json` (корінь) має бути `scripts.coverage` із викликом `n-cursor coverage`:
 
 Канон `scripts.coverage` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
+
+## Налаштування 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`.
+
+Канон Stryker config (мінімум для роботи з `bun test`): [stryker.config.baseline.mjs](./js/data/stryker_config/stryker.config.baseline.mjs)
+
+Аналогічно, якщо `rust` присутнє в `rules` — створюється `.cargo/mutants.toml` у каталозі **кожного** Cargo.toml-маніфесту: кореневий `Cargo.toml`, `<workspace>/src-tauri/Cargo.toml` (Tauri-патерн) і `<workspace>/Cargo.toml` (flat workspace).
+
+Канон cargo-mutants config: [mutants.toml.baseline](./js/data/cargo_mutants_config/mutants.toml.baseline)
+
+Customization (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерни лише забезпечують наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.
+
+Додатково: коли `js-lint` enabled, концерн `stryker_config` ідемпотентно додає у кореневий `.gitignore` патерни Stryker-output-у — `**/reports/stryker/.tmp/` (in-place backup-каталог з baseline-у) і `**/reports/stryker/mutation.json` (JSON-репорт). Це запобігає випадковому коміту backup-копій вихідного коду та мутаційного звіту як build-артефактів.

package/scripts/utils/ensure-gitignore-entries.mjs

@@ -0,0 +1,30 @@
+/**
+ * Idempotent append-only оновлювач `.gitignore` у корені проєкту. Перевіряє,
+ * чи задані entries уже присутні (точне співпадіння рядка після `trim`); відсутні
+ * дописує під header-комент, не порушуючи решту файлу. Якщо `.gitignore` немає —
+ * створюється з заданими entries + header.
+ *
+ * Викликається з test-концерну `stryker_config` (gitignore Stryker temp dirs).
+ */
+import { existsSync } from 'node:fs'
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь репо (де знаходиться `.gitignore`)
+ * @param {string[]} entries патерни для .gitignore (порядок збережено)
+ * @param {string} sectionLabel header-коментар над секцією (без `#`-префікса)
+ * @returns {Promise<{added: string[]}>} перелік патернів, що були дописані
+ */
+export async function ensureGitignoreEntries(cwd, entries, sectionLabel) {
+  const gitignorePath = join(cwd, '.gitignore')
+  const existing = existsSync(gitignorePath) ? await readFile(gitignorePath, 'utf8') : ''
+  const existingLines = new Set(existing.split('\n').map(line => line.trim()))
+  const missing = entries.filter(entry => !existingLines.has(entry))
+  if (missing.length === 0) return { added: [] }
+
+  const prefix = existing.length === 0 || existing.endsWith('\n') ? '' : '\n'
+  const block = `${prefix}\n# ${sectionLabel}\n${missing.join('\n')}\n`
+  await writeFile(gitignorePath, existing + block)
+  return { added: missing }
+}

package/scripts/utils/resolve-cargo-manifest.mjs

@@ -0,0 +1,62 @@
+/**
+ * Резолвить шлях до Cargo.toml у проєкті: cwd/Cargo.toml або в одному з
+ * workspace-підкаталогів (з підтримкою Tauri-патерну `<workspace>/src-tauri/`).
+ * Спільна утиліта для coverage-провайдера rust і test-концерну cargo_mutants_config.
+ * Повертає null (а не throw) щоб callsite-и могли gracefully skip-нути.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string|null>} абсолютний шлях до Cargo.toml або null
+ */
+export 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 tauri = join(cwd, ws, 'src-tauri', 'Cargo.toml')
+      if (existsSync(tauri)) return tauri
+      const flat = join(cwd, ws, 'Cargo.toml')
+      if (existsSync(flat)) return flat
+    }
+  }
+  return null
+}
+
+/**
+ * Plural-варіант: повертає всі Cargo.toml-маніфести в проєкті — корінь
+ * (`cwd/Cargo.toml`) і у workspace-підкаталогах (`<ws>/src-tauri/Cargo.toml`
+ * пріоритетніше за `<ws>/Cargo.toml`). Порожній масив якщо нічого не знайдено.
+ * Використовується test-концерном `cargo_mutants_config` для per-manifest
+ * baseline-копіювання.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до знайдених Cargo.toml
+ */
+export async function resolveAllCargoManifests(cwd) {
+  const manifests = []
+  const rootManifest = join(cwd, 'Cargo.toml')
+  if (existsSync(rootManifest)) manifests.push(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 tauri = join(cwd, ws, 'src-tauri', 'Cargo.toml')
+      if (existsSync(tauri)) {
+        manifests.push(tauri)
+        continue
+      }
+      const flat = join(cwd, ws, 'Cargo.toml')
+      if (existsSync(flat)) manifests.push(flat)
+    }
+  }
+  return manifests
+}

package/scripts/utils/resolve-js-root.mjs

@@ -0,0 +1,46 @@
+/**
+ * Резолвить корінь JS-коду в проєкті: для workspace-projects — перший workspace
+ * (наприклад `app/` у mlmail), для single-package — корінь cwd. Спільна утиліта
+ * для coverage-провайдера js-lint і test-концерну stryker_config (DRY).
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь проєкту (де `.n-cursor.json` і кореневий package.json)
+ * @returns {Promise<string|null>} абсолютний шлях до JS-root або null без кореневого package.json
+ */
+export 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
+}
+
+/**
+ * Plural-варіант: повертає всі JS-roots проєкту. Для workspace-projects — кожен
+ * workspace з власним `package.json`; для single-package — `[cwd]`. Порожній
+ * масив без кореневого package.json. Використовується test-концерном
+ * `stryker_config` для per-workspace baseline-копіювання.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до всіх JS-roots
+ */
+export async function resolveAllJsRoots(cwd) {
+  const rootPkgPath = join(cwd, 'package.json')
+  if (!existsSync(rootPkgPath)) return []
+  const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+  const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+  if (workspaces.length === 0) return [cwd]
+  const roots = []
+  for (const ws of workspaces) {
+    const wsPath = join(cwd, ws)
+    if (existsSync(join(wsPath, 'package.json'))) roots.push(wsPath)
+  }
+  return roots.length > 0 ? roots : [cwd]
+}