@7n/test 0.16.0 → 0.16.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.16.2] - 2026-07-18
+
+### Fixed
+
+- coverage: точний root cause провалу full-режиму Storybook mutation testing — дві незалежні причини замість 'невідомо'. (1) Stryker-інструментація ламає vue-docgen-api парсер @storybook/vue3-vite (framework-вбудований, не залежить від addon-docs) — виправлено через docgen:false у .storybook/main.js#framework.options, root cause підтверджено відтворенням поза Stryker-процесом. (2) окремий, підтверджений upstream Vitest browser mode баг (vitest#9509) — детерміновано (3/3), не флейкі, прогрів кешу не допомагає, не виправна на нашому боці. Full-режим лишається задокументованим напрямком до фіксу у Vitest
+- coverage: подальше розслідування upstream Vitest browser-mode бага (vitest#9509) у full-режимі Storybook mutation testing — 11/11 детермінованих відтворень (було 3/3), простежено точний механізм резолву setup-file.js (bare-специфікатор через package.json#exports, версієзалежний .../internal/setup-file.browser.4), випробувано й відкинуто optimizeDeps.include з буквальним dist-шляхом (дає окрему exports-помилку) і з коректними bare-специфікаторами (синтаксично вірно, але не усуває fetch-провал). Висновок незмінний — --changed-executor лишається єдиним підтвердженим робочим шляхом
+- coverage: vitest#9509 закритий upstream, але його фікс (optimizeDeps.include з повним runtime-стеком) не переноситься на наш кейс — ізоляційний тест з mutate:[] (0 інструментованих файлів) дає ту саму fetch-помилку на setup-file.js, виключаючи вміст файлів; штучна затримка перед стартом vitest теж не допомогла, виключаючи startup-race. Провал специфічний до факту спавну як дочірнього процесу Stryker — ймовірно окремий, ще не задокументований баг зі схожим симптомом. Висновок незмінний: --changed-executor лишається єдиним підтвердженим шляхом
+- Full-режим Storybook mutation testing (Stryker command runner) тепер працює на реальних проєктах: root cause "Failed to fetch dynamically imported module" — symlinked node_modules у Stryker sandbox-копії, обхід через inPlace: true в stryker.storybook.config.mjs
+
+## [0.16.1] - 2026-07-18
+
+### Fixed
+
+- coverage: три реальні баги, знайдені живою перевіркою на справжньому Storybook 10 + Vue 3 проєкті (storybook init-скаффолд) — (1) --project=!storybook падав з 'No projects matched the filter' для проєктів без окремого JS unit-test vitest-проєкту (типовий default-скаффолд), тепер трактується як passWithNoTests; (2) .vue на Storybook-root виключено з JS-виміру Stryker-мутації — vitest-runner структурно не може прогнати dry-run, коли єдиний vitest-проєкт це browser-mode 'storybook', раніше це валило ВЕСЬ прогін; (3) Stryker CLI configFile — позиційний аргумент, не --configFile. Задокументовано нове невирішене обмеження full-режиму command runner на реальних проєктах (npm/docs/stryker-storybook-config.md) — --changed-executor лишається єдиним підтвердженим робочим шляхом
+
 ## [0.16.0] - 2026-07-18
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",

package/src/coverage/js-collector.mjs

@@ -33,6 +33,7 @@ const JS_FILE = /\.(c|m)?[jt]sx?$|\.vue$/
 const TEST_FILE = /\.(test|spec)\.[^.]+$/
 /** `.vue`-компоненти + `*.stories.*` — сигнал для Storybook-змінного scope (line coverage). */
 const VUE_OR_STORIES_FILE = /\.vue$|\.stories\.[^.]+$/
+const VUE_FILE_RE = /\.vue$/
 
 /**
  * Звужує список змінених файлів (relative до cwd) до тих, що лежать під `jsRoot`,
@@ -81,6 +82,8 @@ const VITEST_HINT =
 const STORYBOOK_STRYKER_CONFIG = 'stryker.storybook.config.mjs'
 /** Шлях mutation.json того ж прогону (окремий від `reports/stryker/` JS-виміру). */
 const STORYBOOK_STRYKER_REPORT = join('reports', 'stryker-storybook', 'mutation.json')
+/** vitest hard-fail коли `--project=!storybook` не залишає жодного проєкту (не test-порожньо). */
+const NO_PROJECTS_MATCHED_RE = /No projects matched the filter/
 
 /**
  * Чи у пакеті встановлено vitest (через dependencies або devDependencies).
@@ -311,20 +314,36 @@ const defaultRunner = {
     // зайве дублювання з collectStorybookForRoot і ризик втягнути Playwright-залежність
     // у звичайний coverage-прогін.
     const projectArgs = excludeStorybookProject ? ['--project=!storybook'] : []
-    const r = spawnSync(
-      'bunx',
-      [
-        'vitest',
-        'run',
-        '--passWithNoTests',
-        '--coverage',
-        '--coverage.reporter=lcov',
-        `--coverage.reportsDirectory=${lcovDir}`,
-        ...projectArgs,
-        ...changedArgs
-      ],
-      { cwd, stdio: 'inherit', env: process.env }
-    )
+    const args = [
+      'vitest',
+      'run',
+      '--passWithNoTests',
+      '--coverage',
+      '--coverage.reporter=lcov',
+      `--coverage.reportsDirectory=${lcovDir}`,
+      ...projectArgs,
+      ...changedArgs
+    ]
+
+    if (!excludeStorybookProject) {
+      const r = spawnSync('bunx', args, { cwd, stdio: 'inherit', env: process.env })
+      return r.status ?? 1
+    }
+
+    // excludeStorybookProject-гілка захоплює stdout/stderr (не stdio:'inherit'), бо треба
+    // програмно розрізнити "--project=!storybook не залишив ЖОДНОГО проєкту" (типовий
+    // canonical @storybook/addon-vitest setup БЕЗ окремого unit-test проєкту — Storybook-root
+    // з єдиним named-проєктом "storybook") від реальної помилки. vitest у цьому кейсі кидає
+    // hard "No projects matched the filter" і завершується exit≠0 ДО будь-якого запуску тестів
+    // (`--passWithNoTests` цей кейс не покриває — той стосується тестів усередині вже
+    // знайдених проєктів, не відсутності самих проєктів). Підтверджено емпірично на
+    // реальному `storybook init` (Storybook 10 + Vue3, 2026-07): весь `test.projects` — лише
+    // "storybook", без окремого JS unit-test проєкту.
+    const r = spawnSync('bunx', args, { cwd, encoding: 'utf8', env: process.env })
+    const out = (r.stdout ?? '') + (r.stderr ?? '')
+    process.stdout.write(r.stdout ?? '')
+    process.stderr.write(r.stderr ?? '')
+    if (r.status !== 0 && NO_PROJECTS_MATCHED_RE.test(out)) return 0
     return r.status ?? 1
   },
   runBunCoverage({ cwd, lcovDir }) {
@@ -421,7 +440,10 @@ const defaultRunner = {
     // конфіга задокументовано в npm/docs/stryker-storybook-config.md. Той самий
     // резолвінг local-bin, що й runStryker (plugin-discovery відносно install-каталогу).
     const strykerBin = resolveLocalStrykerBin()
-    const args = ['run', '--configFile', STORYBOOK_STRYKER_CONFIG]
+    // `configFile` — позиційний аргумент Stryker CLI (`stryker run [options] [configFile]`),
+    // НЕ `--configFile` — емпірично підтверджено (реальний прогін, 2026-07): `--configFile`
+    // дає `error: unknown option '--configFile'`.
+    const args = ['run', STORYBOOK_STRYKER_CONFIG]
     const r = strykerBin
       ? spawnSync(strykerBin, args, { cwd, stdio: 'inherit', env: process.env })
       : spawnSync('npx', ['@stryker-mutator/core', ...args], { cwd, stdio: 'inherit', env: process.env })
@@ -463,18 +485,28 @@ const defaultRunner = {
  */
 async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   const wsRel = relative(cwd, jsRoot)
-  // У changed-режимі production-файли для мутації = змінені JS/Vue цього root без
-  // тест-файлів і без *.stories.* (сторі — не production-код, окремий Storybook-вимір).
-  // `.vue` тут ЗАЛИШАЄТЬСЯ — Stryker core мутує <script>/<script setup> SFC (з v7+),
-  // допоки покриття дають НЕ-browser-mode тести (@vue/test-utils тощо, не Storybook-сторі).
-  const mutateSrc = scope ? scope.files.filter(f => !TEST_FILE.test(f) && !STORIES_FILE_RE.test(f)) : null
 
   // Bun-native workspace: coverage через `bun test`, mutation пропускається
   // (Stryker vitest-runner не виконає код з `import ... from 'bun'`).
   const bunNative = await isBunNativeRoot(jsRoot)
   // Storybook root: named vitest-проєкт "storybook" (browser mode) типово ділить один
   // vitest.config.mjs зі звичайним suite — виключаємо його з JS-прогону (див. runJsCoverage).
-  const excludeStorybookProject = !bunNative && (await isStorybookRoot(jsRoot))
+  const isStorybook = !bunNative && (await isStorybookRoot(jsRoot))
+  const excludeStorybookProject = isStorybook
+
+  // У changed-режимі production-файли для мутації = змінені JS/Vue цього root без
+  // тест-файлів і без *.stories.* (сторі — не production-код, окремий Storybook-вимір).
+  // `.vue` на Storybook-root ТЕЖ виключено: якщо root — Storybook-only (типовий
+  // `storybook init`-скаффолд, ЄДИНИЙ vitest-проєкт — "storybook"), Stryker vitest-runner
+  // структурно не може прогнати dry-run (немає non-browser проєкту для виконання) —
+  // емпірично підтверджено (2026-07, реальний Storybook 10 + Vue3 скаффолд): dry-run
+  // валиться, `collectOneRoot` кидає, і це ламає ВЕСЬ прогін (обидва виміри), не лише
+  // JS-рядок. `.vue`-мутація на Storybook-root — виключно відповідальність
+  // `collectStorybookForRoot` (own executor / command-runner), яка вже покриває SFC
+  // повністю; дублювання через JS-вимір там і зайве, і структурно ламке.
+  const mutateSrc = scope
+    ? scope.files.filter(f => !TEST_FILE.test(f) && !STORIES_FILE_RE.test(f) && !(isStorybook && VUE_FILE_RE.test(f)))
+    : null
   if (bunNative && !(await hasRunnableTests(jsRoot))) {
     // `bun test` без тестів завершується помилкою — graceful skip як vitest --passWithNoTests.
     return scope
@@ -598,21 +630,36 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
  * Meta ACH): детермінована генерація мутантів + реальний прогін як суддя — без LLM
  * у контурі виконання.
  *
- * **Валідована альтернатива (спайк 2026-07):** Stryker **command runner** (не
- * vitest-runner) + browser mode ПРАЦЮЄ — але лише з обов'язковим
+ * **Full-режим — Stryker command runner (`runStorybookStrykerFull`, опційний у
+ * runner-і), ПРАЦЮЄ на реальному проєкті за двох обов'язкових умов (перевіряй
+ * перед покладанням — секція «Обмеження» в `npm/docs/stryker-storybook-config.md`):**
+ * Spike на синтетичному JS-репо (2026-07-17) підтвердив саму МЕХАНІКУ — command
+ * runner + browser mode ПРАЦЮЄ з обов'язковим
  * `define: { 'process.env.__STRYKER_ACTIVE_MUTANT__': JSON.stringify(process.env.__STRYKER_ACTIVE_MUTANT__ ?? '') }`
- * у vite-конфізі browser-проєкту (vitest browser mode ставить define як runtime-глобал
- * у Chromium — саме той шлях, що читає інструментація Stryker). Без define — тихий
- * провал: 0% killed, усі мутанти "виживають" (контрольний експеримент підтвердив).
- * ~1.2s/мутант, sandbox без проблем (symlinked node_modules). Не прийнято зараз:
- * потребує змін конфігів target-проєкту (define + stryker command-config) і має
- * silent-0% failure mode, якщо Storybook-ів config merge загубить define; власний
- * executor мутує файл на диску — активація не залежить від env-пропагації взагалі.
- * Тому в **full-режимі** прийнято саме цей шлях (`runStorybookStrykerFull`, опційний
- * у runner-і) — там власний executor вибуває через вартість, а не через технічні
- * обмеження, тож ризик command-runner-а прийнятний. У **changed-режимі** лишається
- * власний executor: дешевший на кількох файлах, і активація не залежить від
- * env-пропагації взагалі.
+ * у vite-конфізі (без define — тихий провал, 0% killed). Живий прогін на
+ * РЕАЛЬНОМУ `storybook init`-скаффолді (2026-07-18) виявив ДВІ незалежні
+ * причини провалу dry-run (`Failed to fetch dynamically imported module`),
+ * обидві тепер виправлені конфігом:
+ * (1) Stryker-інструментація ламає `vue-docgen-api`-парсер `@storybook/vue3-vite`
+ * — root cause підтверджено (інструментований вміст, витягнутий з sandbox і
+ * підставлений напряму, відтворює ту саму помилку БЕЗ участі Stryker) і
+ * ВИПРАВЛЕНО через `docgen: false` у `.storybook/main.js#framework.options`;
+ * (2) Stryker sandbox symlink-ає `node_modules` у тимчасову `.stryker-tmp/sandbox-*`
+ * теку (дефолт), а `@storybook/addon-vitest` резолвить абсолютний шлях свого
+ * `setup-file.js` через РЕАЛЬНИЙ (symlink-target) шлях, а не sandbox-корінь —
+ * Vite dev server відмовляється віддавати файл поза власним root. Підтверджено
+ * прямим експериментом: `vitest run` (БЕЗ Stryker) із `node_modules`, вручну
+ * зробленим symlink-ом з іншої директорії, відтворює ту саму помилку 1:1;
+ * той самий `node_modules`, СКОПІЙОВАНИЙ (не symlink) — працює без помилок.
+ * `resolve.preserveSymlinks` (Vite) і `NODE_OPTIONS=--preserve-symlinks` (Node)
+ * НЕ допомагають (шлях резолвиться всередині коду самого addon-vitest, не
+ * через Vite-резолвер). ВИПРАВЛЕНО через `inPlace: true` у
+ * `stryker.storybook.config.mjs` — Stryker мутує файли без sandbox-копії,
+ * symlink просто не задіяний.
+ * Висновок: з обома фіксами (`docgen: false` + `inPlace: true`) full-режим
+ * дає справжній mutation score на реальному Storybook-проєкті;
+ * `--changed`-executor (нижче) лишається окремим шляхом для звичайного
+ * PR-прогону по змінених файлах.
  *
  * Changed-режим: запускається тільки якщо серед змінених файлів root-а є хоча б
  * один `.vue`/`*.stories.*` (`scope.files` — вже звужений через `scopeToStorybookRoot`
@@ -669,8 +716,9 @@ async function collectStorybookForRoot(jsRoot, cwd, runner, scope = null) {
       if (code !== 0 && !existsSync(reportPath)) {
         throw new Error(
           `Storybook Stryker (command runner) exit ${code} — перевір ${STORYBOOK_STRYKER_CONFIG} ` +
-            '(testRunner: "command", commandRunner.command, jsonReporter.fileName) ' +
-            'і define __STRYKER_ACTIVE_MUTANT__ у vite-конфізі browser-проєкту'
+            '(testRunner: "command", commandRunner.command, jsonReporter.fileName, inPlace: true), ' +
+            'define __STRYKER_ACTIVE_MUTANT__ у vite-конфізі browser-проєкту ' +
+            'і docgen: false у .storybook/main.js#framework.options (див. npm/docs/stryker-storybook-config.md)'
         )
       }
       if (existsSync(reportPath)) {