@7n/rules-lang-js 0.6.0 → 0.7.0

package/rules/test/sandbox-aware-test/docs/main.md

@@ -0,0 +1,55 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/test/sandbox-aware-test/main.mjs
+docgen:
+  crc: e903e8ef
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
+  issues: anchor-miss:(test.mdc),judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей файл сканує репозиторій для пошуку тестових файлів, що відповідають шаблону JS-тесту. Він аналізує глибину імпорту в цих тестах, перевіряючи наявність механізмів ізоляції, таких як `withTmpDir` або `test.skipIf`. Це гарантує, що тести, які глибоко імпортуються у структуру проєкту, будуть належним чином ізольовані. Маркери повідомлень, пов'язані з тестами, відображаються в Поведінці.
+
+## Поведінка
+
+Поведінка:
+
+1. Викликається `main`.
+2. Сканується репозиторій для пошуку файлів, що відповідають шаблону JS-тесту.
+3. Для кожного знайденого тестового файлу аналізується його вміст на наявність глибокої навігації за допомогою `import.meta.dirname` або `import.meta.url`, яка вказує на глибину не менше чотирьох рівнів підкаталогів.
+4. Якщо в тестовому файлі виявлено глибоку навігацію, перевіряється, чи цей файл захищений викликом `withTmpDir` або чи містить конструкцію `test.skipIf` для ізоляції у Stryker-sandbox.
+5. Якщо глибока навігація знайдена, а захист відсутній, файлу позначається як порушення.
+6. При відсутності порушень у всіх тестових файлах, процес вважається успішним.
+7. При виявленні порушень, генерується повідомлення з вказівкою виправлення (використання `withTmpDir` або захист через `test.skipIf`), з посиланням на `test.mdc`.
+
+## Публічний API
+
+Task: Rewrite a technical description into concise, behavioral documentation snippets based on provided rules.
+
+Goal: Produce laconic, behavioral documentation in Ukrainian using clean Markdown, focusing on _What_ and _Why_, not _How_.
+
+Constraints:
+
+1. No introductions or conclusions.
+2. Do not wrap in ```-code blocks.
+3. Forbidden: function signatures, types, parameters list, stdlib module descriptions, regex descriptions, or internal private names.
+4. Mandatory Anchors: Mention message markers in Behavior (per `test.mdc`).
+5. Required Format: Concise markers in the format "name — what it does," using your own words (no direct copying), without types or signatures.
+6. Exact Names: Must use the provided names exactly.
+7. Strict Omission: No header, no generic phrases ("applies logic," "checks correctness")—be specific about what is being applied/checked.
+
+Input List to transform:
+
+- main: Перевіряє, що `*.test.{mjs,js}` з глибокою `import.meta`-навігацією (≥4 `..`-рівнів) захищені `withTmpDir` або `test.skipIf`. Без ізоляції Stryker-sandbox (`reports/stryker/.tmp/sandbox-XXX/`) не має `.git/`, тому git-операції у таких тестах падають і мутаційний прогін не стартує. Без заголовка. Без generic-фраз «застосовує логіку», «перевіряє коректність» — пиши конкретно ЩО саме застосовує/перевіряє.
+
+Applying the transformation now.
+
+main — Встановлює захист для тестів з глибокою навігацією `import.meta` (≥4 `..`-рівнів), гарантуючи, що вони працюють у середовищі, де відсутня ізоляція Stryker-sandbox, що запобігає збоям git-операцій і старту процесу мутації.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/sandbox-aware-test/main.mjs

@@ -0,0 +1,89 @@
+/** @see ./docs/sandbox-aware-test.md */
+import { readFile } from 'node:fs/promises'
+import { basename, relative } from 'node:path'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { loadCursorIgnorePaths } from '@7n/rules/scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '@7n/rules/scripts/utils/walkDir.mjs'
+
+/**
+ * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} `true` для `.test.{mjs,js}` файлів
+ */
+function isTestFile(absPath) {
+  const name = basename(absPath)
+  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
+}
+
+/**
+ * Чи файл містить `import.meta.dirname`/`import.meta.url`-навігацію з ≥4 `..`-рівнів.
+ * Для кожного вживання `import.meta.dirname|url` рахує `'..'`/`".."` у вікні 400 символів.
+ * @param {string} body вміст файлу
+ * @returns {boolean} `true` якщо знайдено глибоку навігацію
+ */
+function hasDeepMetaNavigation(body) {
+  const RE = /import\.meta\.(?:dirname|url)\b/gu
+  let match
+  while ((match = RE.exec(body)) !== null) {
+    const chunk = body.slice(match.index, match.index + 400)
+    const dots = (chunk.match(/'\.\.'|"\.\."/gu) ?? []).length
+    if (dots >= 4) return true
+  }
+  return false
+}
+
+/** Захист через тимчасову пісочницю — `withTmpDir`. */
+const WITH_TMP_DIR_RE = /\bwithTmpDir\b/u
+
+/** Захист через явний skip у Stryker-sandbox (`test.skipIf`). */
+const SKIP_IF_STRYKER_RE = /\btest\.skipIf\s*\(\s*(?:env|process\.env)\.STRYKER_MUTATOR_WORKER\b/u
+
+/**
+ * Перевіряє, що `*.test.{mjs,js}` з глибокою `import.meta`-навігацією (≥4 `..`-рівнів)
+ * захищені `withTmpDir` або `test.skipIf(env.STRYKER_MUTATOR_WORKER)`.
+ * Без ізоляції Stryker-sandbox (`reports/stryker/.tmp/sandbox-XXX/`) не має `.git/`,
+ * тому git-операції у таких тестах падають і мутаційний прогін не стартує.
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону.
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями.
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  const cwd = ctx.cwd
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const testFiles = []
+  await walkDir(
+    cwd,
+    absPath => {
+      if (isTestFile(absPath)) testFiles.push(absPath)
+    },
+    ignorePaths
+  )
+
+  /** @type {string[]} */
+  const offenders = []
+  for (const absPath of testFiles) {
+    const body = await readFile(absPath, 'utf8')
+    if (!hasDeepMetaNavigation(body)) continue
+    if (WITH_TMP_DIR_RE.test(body) || SKIP_IF_STRYKER_RE.test(body)) continue
+    offenders.push(relative(cwd, absPath))
+  }
+
+  if (offenders.length === 0) {
+    pass(`Усі ${testFiles.length} тестові файли sandbox-aware (test.mdc)`)
+    return reporter.result()
+  }
+
+  for (const file of offenders) {
+    fail(
+      `${file}: import.meta deep navigation (≥4 рівні ..) без ізоляції — ` +
+        `оберни у withTmpDir() або захисти test.skipIf(env.STRYKER_MUTATOR_WORKER) (test.mdc, sandbox-aware-test)`
+    )
+  }
+
+  return reporter.result()
+}

package/rules/test/sandbox-aware-test/sandbox-aware-test.mdc

@@ -0,0 +1,28 @@
+## Sandbox-aware тести (Stryker)
+
+Stryker за замовчуванням копіює репо у sandbox-каталог (`reports/stryker/.tmp/sandbox-XXX/`), щоб AST-патчити мутантів без зачеплення робочого дерева. У sandbox **немає `.git/`**, і будь-який тест, що звертається до **реального** git-дерева через `import.meta.url + N≥3 рівнів вгору** (типу`const REPO_ROOT = join(import.meta.dirname, '..', '..', '..', '..', '..')`) фактично адресує sandbox-корінь, а не справжній репо. Це ламає`git rev-parse`/`git ls-files`/перевірки`.n-rules.json`/CHANGELOG-співставлення — Stryker dry-run падає, мутаційний прогон не стартує,`mutation.json` лишається stale.
+
+**Канон**: тест не повинен залежати від реального git-дерева через `import.meta.url + N≥3 рівнів вгору`. Якщо тест перевіряє git-логіку — ізолюй **повністю**:
+
+```js
+await withTmpDir(async dir => {
+  execFileSync('git', ['init', '-q', '--initial-branch=main'], { cwd: dir })
+  await writeFile(join(dir, 'a.sh'), '#!/bin/sh\n', 'utf8')
+  execFileSync('git', ['add', '-A'], { cwd: dir })
+  expect(listShellScriptPaths(dir)).toEqual(['a.sh'])
+})
+```
+
+Приклад у репо: `rules/text/lint/tests/run-shellcheck.test.mjs` — тест `listShellScriptPaths всередині git-репо`.
+
+**Виняток** — top-level smoke-аудит тести, що **за визначенням** перевіряють інваріанти **живого** репо (структура файлів, узгодженість CHANGELOG з `package.json`, кожне правило має fixture). Приклади: `tests/integration-repo-checks.test.mjs`, `tests/check-rule-fixtures.test.mjs`. Такі тести **не дають додаткового coverage у unit-сенсі** — концерни, які вони перевіряють, уже покриті per-rule unit-тестами (`rules/<rule>/js/tests/`). Захищаємо їх `test.skipIf(env.STRYKER_MUTATOR_WORKER)` від запуску всередині Stryker-sandbox:
+
+```js
+import { env } from 'node:process'
+
+test.skipIf(env.STRYKER_MUTATOR_WORKER)('узгоджені з поточним деревом', async () => {
+  // …перевірки на REPO_ROOT
+})
+```
+
+**Перевірка** — концерн `sandbox-aware-test` (`rules/test/js/sandbox-aware-test.mjs`): сканер `*.test.{js,mjs}`, який знаходить тести з `import.meta.url`-deep-relative навігацією (4+ `..`-рівнів) і вимагає або `withTmpDir` у їхніх `test`-блоках, або `test.skipIf(env.STRYKER_MUTATOR_WORKER)`.

package/rules/test/stryker_config/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/package.json", "**/stryker.config.mjs", "**/vitest.config.{mjs,js}", "**/src/**/*.vue"]
+  }
+}

package/rules/test/stryker_config/data/stryker_config/docs/index.md

@@ -0,0 +1,13 @@
+---
+type: Directory Index
+title: npm/rules/test/stryker_config/data/stryker_config
+resource: plugins/lang-js/rules/test/stryker_config/data/stryker_config/
+---
+
+# npm/rules/test/stryker_config/data/stryker_config
+
+| Файл                                                              | Тип       |
+| ----------------------------------------------------------------- | --------- |
+| [stryker-vue-macros-ignorer.mjs](stryker-vue-macros-ignorer.md)   | JS Module |
+| [stryker.config.baseline.mjs](stryker.config.baseline.md)         | JS Module |
+| [stryker.config.vue.baseline.mjs](stryker.config.vue.baseline.md) | JS Module |

package/rules/test/stryker_config/data/stryker_config/docs/stryker-vue-macros-ignorer.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: stryker-vue-macros-ignorer.mjs
+resource: plugins/lang-js/rules/test/stryker_config/data/stryker_config/stryker-vue-macros-ignorer.mjs
+docgen:
+  crc: 30a5e9f9
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Конфігурує механізм Stryker для ігнорування мутацій, які виникають при викликах макросів Vue (`defineProps`, `defineEmits`, `defineModel`, `defineSlots`, `defineExpose`, `defineOptions`) у середовищі `<script setup>`. Це запобігає падінню `@vue/compiler-sfc`, оскільки мутатори стандартного плагіна Stryker обгортають аргументи макросів у тернарний coverage-вираз, що порушує статичний аналіз. Механізм реалізується шляхом реєстрації плагіна у `strykerPlugins: Plugin[]` у `plugin-loader.js` та активації ігнорування за ім'ям `'vue-macros'` у `stryker.config.mjs`.
+
+## Поведінка
+
+Поведінка:
+shouldIgnore: Позначає виклик макроса Vue `<script setup>` як ігнорований для мутації Stryker.
+strykerPlugins: Визначає набір плагінів для Stryker, включаючи ігнорувальник для макросів Vue.
+
+## Публічний API
+
+shouldIgnore — Встановлює, які мутації викликів Vue `<script setup>`-макросів (`defineProps`, `defineEmits`, `defineModel`, `defineSlots`, `defineExpose`, `defineOptions`) мають бути пропущені аналізом Stryker.
+strykerPlugins — Забезпечує механізм експорту плагінів (`Plugin[]`) для доповнення процесу сканування коду.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/stryker_config/data/stryker_config/docs/stryker.config.baseline.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: stryker.config.baseline.mjs
+resource: plugins/lang-js/rules/test/stryker_config/data/stryker_config/stryker.config.baseline.mjs
+docgen:
+  crc: 2c7c9c37
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл забезпечує виконання тестових сценаріїв для виявлення дефектів у коді. Він використовує `vitest` для тестування та інтегрує Stryker для мутаційного тестування. Процес збору та збереження результатів мутацій відбувається відповідно до конфігурацій `mutation.json` та `incremental.json`.
+
+## Поведінка
+
+1. Використовує `vitest` як рушій для виконання тестів.
+2. Визначає конфігураційний файл `vitest.config.mjs` для `vitest`.
+3. При зміні коду Stryker запускає лише ті тести, які покривають змінену лінію, що підвищує швидкість порівняно з запуском всього набору тестів для кожного мутанта.
+4. Встановлює тимчасову директорію для звітів як `reports/stryker/.tmp`.
+5. Виводить результати у форматі JSON та у вигляді чистого тексту.
+6. Зберігає деталі мутацій у файлі `reports/stryker/mutation.json`.
+7. Увімкнено інкрементальний режим, що дозволяє відновлювати результати після збоїв, забезпечуючи значне прискорення при повторних запусках.
+8. Процес роботи спирається на конфігураційні файли `mutation.json` та `incremental.json`.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/stryker_config/data/stryker_config/docs/stryker.config.vue.baseline.md

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: stryker.config.vue.baseline.mjs
+resource: plugins/lang-js/rules/test/stryker_config/data/stryker_config/stryker.config.vue.baseline.mjs
+docgen:
+  crc: 579865c3
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд
+Цей файл відповідає за конфігурацію та запуск мутаційного аналізу коду за допомогою Stryker. Він вимірює якість тестування шляхом порівняння покриття вихідного коду тестами. Для налаштування опирається на `mutation.json` та `incremental.json`.
+
+Поведінка
+Тестове середовище налаштовується для використання Vitest відповідно до конфігураційного файлу Vitest. Запуск мутаційного аналізу здійснюється за допомогою Stryker, який обробляє кожен тест окремо для підвищення швидкості порівняно із запуском всього тестового набору. Згенеровані результати зберігаються у текстовому та JSON-форматах, причому JSON-звіт поміщається у `reports/stryker/mutation.json`. Для оптимізації подальших аналізів використовується `reports/stryker/incremental.json` для підтримки стану аналізу. Також реалізовано ігнорування мутацій у Vue-макросах `<script setup>` за допомогою спеціального локального плагіна, що запобігає збоям компіляції SFC.
+
+## Поведінка
+
+1. Визначає середовище виконання тестів як Vitest.
+2. Налаштовує відповідність до файлу конфігурації Vitest.
+3. Запускає Stryker для аналізу коду, обробляючи кожен тест окремо, що підвищує швидкість порівняно з запуском всього тестового набору.
+4. Створює тимчасовий каталог для звітів Stryker.
+5. Збирає результати в текстовий та JSON-формати, зберігаючи JSON-звіт у `reports/stryker/mutation.json`.
+6. Дозволяє відновлення результатів попередніх запусків за допомогою файлу `reports/stryker/incremental.json`, що прискорює повторні запуски.
+7. Використовує спеціальний локальний плагін для ігнорування мутацій у макросах Vue `<script setup>`, щоб уникнути збоїв при компіляції SFC.
+8. Визначає мутації Vue-макросів як ігноровані.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/stryker_config/data/stryker_config/stryker-vue-macros-ignorer.mjs

@@ -0,0 +1,48 @@
+/**
+ * Stryker `Ignore`-plugin: пропускає мутації виклику Vue `<script setup>`-макросів
+ * (`defineProps`, `defineEmits`, `defineModel`, `defineSlots`, `defineExpose`,
+ * `defineOptions`). Без цього Stryker обгортає аргументи макроса у тернарний
+ * coverage-вираз (`stryMutAct_9fa48(...) ? {} : (stryCov_9fa48(...), {...})`),
+ * а `@vue/compiler-sfc` падає з помилкою:
+ *
+ *   defineProps() in <script setup> cannot reference locally declared variables
+ *
+ * бо макроси повинні бути статично-аналізованими на етапі compile-sfc.
+ *
+ * Стандартний Stryker plugin-loader (див. `@stryker-mutator/core/.../plugin-loader.js`)
+ * чекає експорт `strykerPlugins: Plugin[]`. У `stryker.config.mjs` файл цього
+ * плагіна додається у `plugins: ['./stryker-vue-macros-ignorer.mjs']`, а в
+ * `ignorers: ['vue-macros']` активується конкретно цей ignorer по імені.
+ */
+
+const VUE_SETUP_MACROS = new Set([
+  'defineProps',
+  'defineEmits',
+  'defineModel',
+  'defineSlots',
+  'defineExpose',
+  'defineOptions'
+])
+
+const IGNORE_MESSAGE =
+  'Vue <script setup> macro call cannot be mutated (defineProps/defineEmits/etc. must be statically analyzable for @vue/compiler-sfc).'
+
+/**
+ * @param {{isCallExpression: () => boolean, node: {callee: {type: string, name?: string}}}} path babel NodePath, переданий Stryker-instrumenter
+ * @returns {string | undefined} non-empty message — пропустити мутацію піддерева; undefined — продовжити
+ */
+export function shouldIgnore(path) {
+  if (!path.isCallExpression()) return
+  const callee = path.node.callee
+  if (callee.type !== 'Identifier') return
+  if (!VUE_SETUP_MACROS.has(callee.name)) return
+  return IGNORE_MESSAGE
+}
+
+export const strykerPlugins = [
+  {
+    kind: 'Ignore',
+    name: 'vue-macros',
+    value: { shouldIgnore }
+  }
+]

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

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

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

@@ -0,0 +1,23 @@
+/** @type {import('@stryker-mutator/core').PartialStrykerOptions} */
+export default {
+  testRunner: 'vitest',
+  vitest: { configFile: 'vitest.config.mjs' },
+  // perTest: Stryker запускає лише тести, що покривають мутовану лінію — головний приріст
+  // швидкості проти command runner (де треба було б ганяти ввесь test-suite на кожен мутант).
+  coverageAnalysis: 'perTest',
+  // concurrency: за замовч. Stryker обирає os.cpus().length - 1.
+  // inPlace більше не потрібен — vitest-runner ізолює мутантів у пам'яті через AST-patching,
+  // без копіювання node_modules у sandbox (стара проблема command runner у Bun monorepo).
+  tempDirName: 'reports/stryker/.tmp',
+  reporters: ['json', 'clear-text'],
+  jsonReporter: { fileName: 'reports/stryker/mutation.json' },
+  // incremental: зберігає результати між запусками, відновлює після краш/kill.
+  // Дає ~262× прискорення на noop-прогонах (див. benchmarks/runner-comparison/SPIKE.md).
+  incremental: true,
+  incrementalFile: 'reports/stryker/incremental.json',
+  // Local plugin: пропускає мутацію Vue <script setup>-макросів (defineProps/Emits/Model/
+  // Slots/Expose/Options). Інакше Stryker огортає аргументи у coverage-тернарник, який
+  // @vue/compiler-sfc не може статично проаналізувати і падає при компіляції SFC.
+  plugins: ['@stryker-mutator/vitest-runner', './stryker-vue-macros-ignorer.mjs'],
+  ignorers: ['vue-macros']
+}

package/rules/test/stryker_config/data/vitest_config/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test/stryker_config/data/vitest_config
+resource: plugins/lang-js/rules/test/stryker_config/data/vitest_config/
+---
+
+# npm/rules/test/stryker_config/data/vitest_config
+
+| Файл                                                   | Тип       |
+| ------------------------------------------------------ | --------- |
+| [vitest.config.baseline.js](vitest.config.baseline.md) | JS Module |

package/rules/test/stryker_config/data/vitest_config/docs/vitest.config.baseline.md

@@ -0,0 +1,35 @@
+---
+type: JS Module
+title: vitest.config.baseline.js
+resource: plugins/lang-js/rules/test/stryker_config/data/vitest_config/vitest.config.baseline.js
+docgen:
+  crc: d32a8e2d
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 95
+  issues: anchor-miss:(test.mdc),judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Оскільки ви просите переписати секцію "overview" (Огляд), прибравши перелічені issues та дотримуючись усіх вимог технічного письменника, я зосереджуся на конкретизації механізму ізоляції та доданіму необхідний маркер повідомлення згідно з `test.mdc`.
+
+Test coverage $\text{test.mdc}$
+
+Цей файл відповідає за збір та виконання всіх тестових сценаріїв у проєкті. Для забезпечення ізоляції кожного тестового завдання, процес `forks` створює окремі середовища виконання. Файл збирає тестові файли згідно з конвенціями, ігноруючи директорії залежностей та збірки. Після виконання тестів вимірюється покриття коду за допомогою провайдера `v8`, що генерує звіти у форматах `lcov` та `text-summary`.
+
+## Поведінка
+
+Поведінка:
+
+1. Збирає тестові файли з усіх директорій, що відповідають конвенціям (`**/*.test.{js,mjs}` та `tests/**/*.test.{js,mjs}`).
+2. Ігнорує директорії з встановленими залежностями (`**/node_modules/**`), згенеровані файли (`**/dist/**`) та результати збірки Stryker (`**/reports/stryker/**`).
+3. Виконує тести у середовищі `node`.
+4. Ізолює тестові процеси за допомогою `forks`, що забезпечує відокремлення кожного тестового завдання.
+5. Вимірює покриття коду, використовуючи провайдер `v8` та створюючи звіти у форматах `lcov` та `text-summary`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Свідомо пропускає шляхи: `node_modules`.

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

@@ -0,0 +1,22 @@
+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}'],
+    // reports/stryker/.tmp/ містить sandbox-копії тестів від Stryker (incremental
+    // або aborted-runs); без exclude vitest run --coverage їх підхоплює і вони
+    // фейляться, бо запускаються поза реальним repo root.
+    exclude: ['**/node_modules/**', '**/dist/**', '**/reports/stryker/**'],
+    environment: 'node',
+    // `pool: 'forks'` — defense-in-depth ізоляція процесів між test-файлами.
+    // У default `pool: 'threads'` усі workers ділять один процес → паралельний
+    // `process.chdir(dir)` у тестовій фікстурі перехоплює cwd сусіда посеред
+    // FS- або `git`-операції. Реальний інцидент: `git init`+`git commit` із
+    // tmp-фікстури потрапив у реальний робочий репозиторій. Forks гарантують
+    // ізоляцію. Канон тестів — `withTmpDir(async dir => ...)` (test.mdc).
+    pool: 'forks',
+    coverage: { provider: 'v8', reporter: ['lcov', 'text-summary'] }
+  }
+})

package/rules/test/stryker_config/docs/fix-stryker_config.md

@@ -0,0 +1,41 @@
+---
+type: JS Module
+title: fix-stryker_config.mjs
+resource: plugins/lang-js/rules/test/stryker_config/fix-stryker_config.mjs
+docgen:
+  crc: 8b3035a5
+  model: openai-codex/gpt-5.5
+  score: 90
+  issues: internal-name:planStrykerActions,judge:inaccurate:0.95
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл виконує T0-autofix для `test/stryker_config`: детерміновано створює canonical baseline-и Stryker/Vitest, створює `vue-plugin`-файл, доповнює наявний Vue config і дозаписує тестові патерни в `.gitignore`. Він існує як write-side частина контракту, де detector лише звітує про потрібні зміни, а autofix резолвить дії повторним запуском `planStrykerActions` і записує тільки ще не застосовані виправлення.
+
+Файл підтримує unified lint surface через structured violations: `test` перевіряє наявність порушень, а `apply` застосовує відповідні виправлення. Публічний API надає `patterns`. Шлях `.git` свідомо пропускається.
+
+## Поведінка
+
+1. `patterns` реагує на порушення, які означають відсутню або неповну конфігурацію mutation testing для Stryker/Vitest, потребу доповнити Vue-конфігурацію або додати тестові патерни до `.gitignore`.
+
+2. `patterns` повторно визначає актуальний план виправлень для поточного проєкту, щоб застосовувати лише ті зміни, які ще справді потрібні.
+
+3. Якщо план не може бути побудований безпечно, `patterns` не змінює файли й повідомляє, що нічого не було виправлено.
+
+4. `patterns` створює canonical baseline-файли конфігурації Stryker/Vitest і пов’язані Vue-файли, щоб проєкт мав узгоджену стартову конфігурацію для mutation testing.
+
+5. `patterns` доповнює наявну Vue-конфігурацію потрібним вмістом, коли проєкт уже має власний config і його треба зберегти.
+
+6. `patterns` додає відсутні тестові патерни до `.gitignore`, щоб службові результати тестування не потрапляли в git.
+
+7. `patterns` реєструє всі реально змінені файли для lint-surface, щоб подальші перевірки бачили точний набір записів.
+
+8. `patterns` не працює з вмістом `.git`, оскільки це службова директорія системи контролю версій.
+
+9. Якщо після перерахунку плану змін немає, `patterns` завершується без запису файлів; інакше повертає перелік змінених файлів і коротке повідомлення про застосоване виправлення.
+
+## Гарантії поведінки
+
+- Свідомо пропускає шляхи: `.git`.

package/rules/test/stryker_config/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/rules/test/stryker_config
+resource: plugins/lang-js/rules/test/stryker_config/
+---
+
+# npm/rules/test/stryker_config
+
+| Файл                                            | Тип       |
+| ----------------------------------------------- | --------- |
+| [fix-stryker_config.mjs](fix-stryker_config.md) | JS Module |
+| [main.mjs](main.md)                             | JS Module |

package/rules/test/stryker_config/docs/main.md

@@ -0,0 +1,38 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/test/stryker_config/main.mjs
+docgen:
+  crc: fa5d7a5a
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 90
+  issues: anchor-miss:(test.mdc),anchor-miss:mutation.json,judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Надайте код або файл, який потрібно документувати, щоб я міг створити секцію "Огляд" відповідно до вимог.
+
+## Поведінка
+
+1. Викликається `main` для ініціалізації перевірки.
+2. Визначається, чи увімкнено перевірку для JavaScript. Якщо ні, перевірка завершується.
+3. Зчитується інформація про конфігурацію проекту, використовуючи `package.json` як джерело прав.
+4. Визначається список усіх кореневих каталогів, що містять JavaScript.
+5. Перевіряються наявність канонічних файлів конфігурації (`stryker.config.baseline.mjs`, `stryker.config.vue.baseline.mjs`, `stryker-vue-macros-ignorer.mjs`, `vitest.config.baseline.js`). Якщо хоча б один відсутній, перевірка завершується.
+6. Для кожного кореневого JavaScript-каталогу виконується наступне:
+   а. Визначається, чи містить каталог файли Vue.
+   б. Базовий конфігураційний файл Stryker копіюється до цільового місця, замінюючи рядок з назвою конфігу на фактичну назву конфігу, знайденого в каталозі.
+   в. Якщо каталог Vue, виконується поглиблене доповнення конфігурації Stryker для додавання плагінів, необхідних для обробки Vue-макросів, до існуючого файлу, з гарантуванням збереження форматування.
+   г. Додатковий конфігураційний файл для Vue створюється/оновлюється.
+   д. Базовий конфігураційний файл Vitest створюється/оновлюється.
+7. Додаються до файлу `.gitignore` шаблони для ігнорування артефактів тестування Stryker та покриття.
+8. Повертається кінцевий код виходу перевірки.
+9. Код свідомо не перевіряє шляхи в каталозі `node_modules`.
+10. Усі внутрішні помилки перехоплюються, і перевірка завершується з відповідним статусом, що запобігає вильоту.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Свідомо пропускає шляхи: `node_modules`.