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

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`.

package/rules/test/stryker_config/fix-stryker_config.mjs

@@ -0,0 +1,77 @@
+/**
+ * T0-autofix для `test/stryker_config` — детерміноване створення canonical
+ * stryker/vitest baseline-ів, vue-plugin-файла, augment існуючого Vue-config-а та
+ * дозапис тест-патернів у `.gitignore`. Логіку перенесено з detector-а (read-only
+ * contract: detector лише ЗВІТУЄ потрібні зміни, запис — тут).
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Дії резолвимо повторним запуском чистого планувальника `planStrykerActions(cwd)`
+ * (той самий код, що й detector) → idempotent: already-applied не повертаються.
+ */
+import { copyFile, readFile, writeFile } from 'node:fs/promises'
+
+import { ensureGitignoreEntries } from '@7n/rules/scripts/utils/ensure-gitignore-entries.mjs'
+
+import {
+  GITIGNORE_MISSING,
+  GITIGNORE_SECTION_LABEL,
+  STRYKER_CONFIG_MISSING,
+  STRYKER_VUE_AUGMENT,
+  planStrykerActions
+} from './main.mjs'
+
+const TRIGGER_REASONS = new Set([STRYKER_CONFIG_MISSING, STRYKER_VUE_AUGMENT, GITIGNORE_MISSING])
+
+/**
+ * Виконує одну BaselineAction: copy as-is або string-replace baseline-тексту.
+ * @param {import('./main.mjs').StrykerPlan['baselineActions'][number]} a одна baseline-дія (copy або string-replace).
+ * @returns {Promise<void>}
+ */
+async function writeBaseline(a) {
+  if (a.transform) {
+    const src = await readFile(a.baselinePath, 'utf8')
+    const { replacement } = a.transform
+    await writeFile(
+      a.target,
+      // eslint-disable-next-line security/detect-non-literal-regexp -- planned canonical regex replay
+      src.replace(new RegExp(a.transform.re, 'u'), () => replacement),
+      'utf8'
+    )
+  } else {
+    await copyFile(a.baselinePath, a.target)
+  }
+}
+
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'test-stryker-config-create',
+    test: violations => violations.some(v => TRIGGER_REASONS.has(v.reason)),
+    apply: async (violations, ctx) => {
+      const cwd = ctx.cwd
+      const plan = await planStrykerActions(cwd)
+      if (plan.fatal) return { touchedFiles: [] }
+
+      const touchedFiles = []
+      for (const a of plan.baselineActions) {
+        ctx.recordWrite?.(a.target)
+        await writeBaseline(a)
+        touchedFiles.push(a.target)
+      }
+      for (const w of plan.augmentWrites) {
+        ctx.recordWrite?.(w.target)
+        await writeFile(w.target, w.content, 'utf8')
+        touchedFiles.push(w.target)
+      }
+      if (plan.gitignoreMissing.length > 0) {
+        const gitignorePath = `${cwd}/.gitignore`
+        ctx.recordWrite?.(gitignorePath)
+        const { added } = await ensureGitignoreEntries(cwd, plan.gitignoreMissing, GITIGNORE_SECTION_LABEL)
+        if (added.length > 0) touchedFiles.push(gitignorePath)
+      }
+
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `stryker/vitest config + .gitignore: ${touchedFiles.join(', ')}` }
+    }
+  }
+]