@7n/test 0.16.1 → 0.16.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.16.3] - 2026-07-18
+
+### Fixed
+
+- Full-режим Storybook mutation testing: mutate-glob має виключати *.stories.* і *.mdx — інакше Stryker-інструментація ламає CSF-індексацію Storybook (виявлено при наскрізній перевірці через @7n/test coverage, підтверджено реальним mutation score 15/59 на Button/Header/Page.vue)
+
+## [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

package/package.json

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

package/src/coverage/js-collector.mjs

@@ -631,21 +631,35 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
  * у контурі виконання.
  *
  * **Full-режим — Stryker command runner (`runStorybookStrykerFull`, опційний у
- * runner-і), АЛЕ з відомим невирішеним обмеженням (перевіряй перед покладанням —
- * секція «Обмеження» в `npm/docs/stryker-storybook-config.md`):**
+ * 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-конфізі (без define — тихий провал, 0% killed). Але живий прогін на
- * РЕАЛЬНОМУ `storybook init`-скаффолді (2026-07-18) показав: dry-run падає з
- * `Failed to fetch dynamically imported module` для `*.stories.js`, і ЖОДНА з
- * перевірених гіпотез (symlink sandbox, `inPlace: true`, vue-docgen-plugin,
- * concurrency) не root-cause. Той самий `vitest run --project=storybook`
- * бездоганно працює через ЗВИЧАЙНИЙ `spawnSync` (наш `--changed`-executor) —
- * проблема специфічна саме до того, як Stryker spawn-ить/оточує процес.
- * Висновок: full-режим лишається задокументованим напрямком, не підтвердженим
- * робочим рішенням; `--changed`-executor (нижче) — єдиний перевірений на
- * реальному проєкті шлях отримати справжній mutation score для Storybook-коду.
+ * у 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`
@@ -702,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)) {