@7n/test 0.14.5 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.16.0] - 2026-07-18
+
+### Added
+
+- coverage: full-режим mutation testing для Storybook через Stryker command runner — canonical stryker.storybook.config.mjs (testRunner:'command', jsonReporter → reports/stryker-storybook/mutation.json), спайк-валідований define-трюк для __STRYKER_ACTIVE_MUTANT__ у browser-mode vite-конфізі; без canonical конфіга — чесний skip, як і раніше. Задокументовано контракт у npm/docs/stryker-storybook-config.md
+
+## [0.15.0] - 2026-07-18
+
+### Added
+
+- coverage: окремий рядок «Vue (Storybook)» — Storybook-покриття через vitest browser mode (@storybook/addon-vitest), незалежно від JS/mutation-виміру
+- Mutation testing тепер мутує `.vue` SFC (`<script>`/`<script setup>`) поряд зі звичайним JS/TS — Stryker core підтримує це нативно, обмеження лише на browser-mode тести (Storybook). `run` (без `--no-mutation`) генерує Storybook CSF3 `.stories.*` для непокритих Vue-компонентів у Storybook-проєктах замість звичайних unit-тестів (`gen-stories.mjs`), з валідацією через реальний `vitest run --project=storybook`.
+- coverage: mutation testing для Storybook-покритого коду (vitest browser mode) — власний mutate→run→restore executor у --changed-режимі: детерміновані AST-мутанти (rollup parseAst, 5 тірів операторів) по змінених production-файлах і покритих сторі рядках (lcov DA), вбиває/милує реальний browser-mode прогін зі сторі-фільтром і бюджетами (8/файл, 32/прогін); survived мутанти йдуть у наявний ланцюг classify/fix
+- coverage: LLM-джерело мутантів для Storybook mutation executor-а (Mutahunter/Meta-ACH-патерн) — LLM пропонує context-aware bug-like мутанти (off-by-one, підмінені fallback, переплутані аргументи) поверх детермінованих, вбиває/милує так само лише реальний browser-mode прогін; жорстка валідація пропозицій (точний підрядок, покритий рядок, parseAst-синтакс-перевірка), власна стеля 3/файл, graceful degradation без API-ключа, opt-out N_7N_TEST_NO_LLM_MUTANTS=1
+
+### Fixed
+
+- deps: оновити @7n/llm-lib ^2.0.2 → ^2.7.6 — виправляє помилкову класифікацію unresolved-model викликів (порожній modelSpec) як cloud у chain-телеметрії; тепер фактично резолвлена pi-модель (напр. локальний omlx) прокидається в chain.note() коректно, окремий бакет unknownCalls замість неявного cloud
+
 ## [0.14.5] - 2026-07-12
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.14.5",
+  "version": "0.16.0",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",
@@ -39,9 +39,9 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@7n/llm-lib": "^2.7.6",
     "@earendil-works/pi-coding-agent": "^0.80.3",
     "@nitra/check-env": "^4.2.1",
-    "@7n/llm-lib": "^2.0.2",
     "@vitest/coverage-v8": "^4.1.9",
     "rollup": "^4.62.2",
     "vitest": "^4.1.9",

package/src/coverage/js-collector.mjs

@@ -15,13 +15,24 @@ import { dirname, isAbsolute, join, relative } from 'node:path'
 import { resolveAllJsRoots } from '../lib/resolve-js-root.mjs'
 import { addCoverage, addMutation } from './aggregate.mjs'
 import { hasRunnableTests, isBunNativeRoot } from './bun-native.mjs'
+import { STORIES_FILE_RE, hasStories, isStorybookRoot } from './storybook.mjs'
+import { parseLcovCoveredLines, runStorybookMutation } from './storybook-mutation.mjs'
+import { proposeLlmMutants } from './storybook-mutation-llm.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
-/** JS/TS-розширення — файли, які мутує Stryker і покриває vitest. */
-const JS_FILE = /\.(c|m)?[jt]sx?$/
+/**
+ * JS/TS/Vue-розширення — файли, які мутує Stryker і покриває vitest. `.vue` включено:
+ * Stryker core мутує `<script>`/`<script setup>` блок SFC без окремого плагіна (з версії 7+).
+ * Мутувати можна лише те, що покрите НЕ-browser-mode тестами (`@vue/test-utils`+happy-dom
+ * тощо), НЕ Storybook-сторі (`@storybook/addon-vitest`, browser mode) — детальніше про чому
+ * див. коментар над `collectStorybookForRoot` нижче.
+ */
+const JS_FILE = /\.(c|m)?[jt]sx?$|\.vue$/
 /** Тест-файли (`*.test.*` / `*.spec.*`) — НЕ production-код, не йдуть у Stryker `--mutate`. */
 const TEST_FILE = /\.(test|spec)\.[^.]+$/
+/** `.vue`-компоненти + `*.stories.*` — сигнал для Storybook-змінного scope (line coverage). */
+const VUE_OR_STORIES_FILE = /\.vue$|\.stories\.[^.]+$/
 
 /**
  * Звужує список змінених файлів (relative до cwd) до тих, що лежать під `jsRoot`,
@@ -42,9 +53,35 @@ export function scopeToRoot(changedFiles, cwd, jsRoot) {
   return out
 }
 
+/**
+ * Звужує список змінених файлів до тих, що стосуються Storybook-покриття
+ * (`.vue`-компоненти + `*.stories.*`) під `jsRoot`, рібейзить відносно `jsRoot`.
+ * Окремий від `scopeToRoot`: `.vue`/`*.stories.*` НЕ йдуть у Stryker `--mutate`
+ * (JS-мутація для Vue поза скоупом), тож не змішуємо scope-и.
+ * @param {string[]} changedFiles relative-до-cwd шляхи змінених файлів
+ * @param {string} cwd корінь проєкту
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @returns {string[]} `.vue`/`.stories.*`-файли під jsRoot, шляхи relative до jsRoot
+ */
+export function scopeToStorybookRoot(changedFiles, cwd, jsRoot) {
+  const out = []
+  for (const f of changedFiles) {
+    if (!VUE_OR_STORIES_FILE.test(f)) continue
+    const rel = relative(jsRoot, join(cwd, f))
+    if (rel.startsWith('..') || isAbsolute(rel)) continue
+    out.push(rel)
+  }
+  return out
+}
+
 const VITEST_HINT =
   'js coverage: vitest відсутній у package.json — додай `vitest`, `@vitest/coverage-v8` та `@stryker-mutator/vitest-runner` у devDependencies (див. test.mdc)'
 
+/** Canonical config-файл для full-режиму Storybook-мутації через Stryker command runner. */
+const STORYBOOK_STRYKER_CONFIG = 'stryker.storybook.config.mjs'
+/** Шлях mutation.json того ж прогону (окремий від `reports/stryker/` JS-виміру). */
+const STORYBOOK_STRYKER_REPORT = join('reports', 'stryker-storybook', 'mutation.json')
+
 /**
  * Чи у пакеті встановлено vitest (через dependencies або devDependencies).
  * @param {{dependencies?: Record<string,string>, devDependencies?: Record<string,string>}} pkg package.json
@@ -262,11 +299,18 @@ function resolveLocalStrykerBin() {
 }
 
 const defaultRunner = {
-  runJsCoverage({ cwd, lcovDir, base }) {
+  runJsCoverage({ cwd, lcovDir, base, excludeStorybookProject }) {
     // base !== undefined ⇔ --changed-режим: vitest сам рахує зачеплені змінами тести
     // через граф імпортів. `--changed <base>` порівнює base↔робоче дерево (committed і
     // uncommitted разом); `--changed` без аргументу — uncommitted vs HEAD.
     const changedArgs = base === undefined ? [] : base === null ? ['--changed'] : ['--changed', base]
+    // excludeStorybookProject: коли root — Storybook-workspace, named vitest-проєкт
+    // "storybook" (browser mode, Playwright) типово живе у ТОМУ Ж vitest.config.mjs, що
+    // й звичайний JS-suite (canonical setup @storybook/addon-vitest — projects: [...]).
+    // Без --project=!storybook цей прогін спробував би виконати і browser-mode тести теж —
+    // зайве дублювання з collectStorybookForRoot і ризик втягнути Playwright-залежність
+    // у звичайний coverage-прогін.
+    const projectArgs = excludeStorybookProject ? ['--project=!storybook'] : []
     const r = spawnSync(
       'bunx',
       [
@@ -276,6 +320,7 @@ const defaultRunner = {
         '--coverage',
         '--coverage.reporter=lcov',
         `--coverage.reportsDirectory=${lcovDir}`,
+        ...projectArgs,
         ...changedArgs
       ],
       { cwd, stdio: 'inherit', env: process.env }
@@ -301,6 +346,57 @@ const defaultRunner = {
     )
     return r.status ?? 1
   },
+  runStorybookCoverage({ cwd, lcovDir, base }) {
+    // Coverage сторі рахує сам Storybook-vitest-addon (browser mode, Playwright Chromium)
+    // через named vitest-проєкт "storybook" (канонічний vitest.config для Vue-проєктів,
+    // див. npm/docs) — той самий контракт lcov, що й у звичайного vitest run --coverage.
+    const changedArgs = base === undefined ? [] : base === null ? ['--changed'] : ['--changed', base]
+    const r = spawnSync(
+      'bunx',
+      [
+        'vitest',
+        'run',
+        '--project=storybook',
+        '--passWithNoTests',
+        '--coverage',
+        '--coverage.reporter=lcov',
+        `--coverage.reportsDirectory=${lcovDir}`,
+        ...changedArgs
+      ],
+      { cwd, stdio: 'inherit', env: process.env }
+    )
+    return r.status ?? 1
+  },
+  runStorybookMutantTest({ cwd, storyFilter, timeoutMs }) {
+    // Один прогін проти мутованого дерева (mutate→run→restore цикл у
+    // storybook-mutation.mjs). storyFilter (сторі-файл компонента) звужує suite до
+    // релевантних тестів — browser-mode прогін коштує секунди, повний suite на кожен
+    // мутант марнотратний. stdio ignore: важливий лише exit code; вивід мутант-прогонів
+    // лише шумів би (десятки прогонів поспіль). null (kill за таймаутом) → Timeout.
+    const r = spawnSync('bunx', ['vitest', 'run', '--project=storybook', ...(storyFilter ? [storyFilter] : [])], {
+      cwd,
+      stdio: 'ignore',
+      env: process.env,
+      timeout: timeoutMs
+    })
+    if (r.signal) return null // убитий таймаутом
+    return r.status ?? 1
+  },
+  async proposeStorybookLlmMutants({ file, source, coveredLines, cwd }) {
+    // Друге джерело мутантів (Mutahunter/ACH-патерн): LLM пропонує bug-like мутанти,
+    // судить так само лише реальний прогін. Graceful degradation: будь-яка помилка
+    // (нема API-ключа, мережа) → [] з одноразовим попередженням — детерміновані
+    // мутанти працюють далі. Opt-out: N_7N_TEST_NO_LLM_MUTANTS=1.
+    try {
+      return await proposeLlmMutants({ file, source, coveredLines, cwd })
+    } catch (error) {
+      if (!defaultRunner._llmMutantsWarned) {
+        console.error(`⚠ LLM-мутанти недоступні (${String(error.message ?? error).slice(0, 120)}) — лише детерміновані`)
+        defaultRunner._llmMutantsWarned = true
+      }
+      return []
+    }
+  },
   runStryker({ cwd, mutate }) {
     // Plugin-discovery Stryker (`@stryker-mutator/*`) globиться відносно CORE-install-каталогу
     // (`core/dist/src/di/plugin-loader.js` → `../../../../../@stryker-mutator/*`). Тож core
@@ -315,6 +411,21 @@ const defaultRunner = {
       ? spawnSync(strykerBin, ['run', ...mutateArgs], { cwd, stdio: 'inherit', env: process.env })
       : spawnSync('npx', ['@stryker-mutator/core', 'run', ...mutateArgs], { cwd, stdio: 'inherit', env: process.env })
     return r.status ?? 1
+  },
+  runStorybookStrykerFull({ cwd }) {
+    // Full-режим Storybook-мутація через canonical `stryker.storybook.config.mjs`
+    // (окремий Stryker-прогін, testRunner:'command' — vitest-runner browser mode не
+    // підтримує, див. коментар над collectStorybookForRoot). Спайк 2026-07 підтвердив:
+    // command runner + vitest browser mode ПРАЦЮЄ з `define` для
+    // __STRYKER_ACTIVE_MUTANT__ у vite-конфізі browser-проєкту — канонічний контракт
+    // конфіга задокументовано в npm/docs/stryker-storybook-config.md. Той самий
+    // резолвінг local-bin, що й runStryker (plugin-discovery відносно install-каталогу).
+    const strykerBin = resolveLocalStrykerBin()
+    const args = ['run', '--configFile', 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 })
+    return r.status ?? 1
   }
 }
 
@@ -335,6 +446,13 @@ const defaultRunner = {
  * `bun test --coverage` (vitest не резолвить модуль `bun`), mutation пропускається
  * з попередженням — Stryker vitest-runner такий код не виконає.
  *
+ * `.vue`-мутація: Stryker core мутує `<script>`/`<script setup>` SFC без окремого плагіна.
+ * Storybook root (`isStorybookRoot`) → `runJsCoverage` отримує `excludeStorybookProject:
+ * true` (`--project=!storybook`), щоб не зачепити browser-mode проєкт (докладніше про стан
+ * підтримки browser mode у Stryker — коментар над `collectStorybookForRoot` нижче) —
+ * інакше цей самий JS-прогін спробував би й browser-mode тести теж, якщо вони живуть
+ * у тому ж vitest.config.mjs.
+ *
  * Реальні помилки (vitest/bun exit ≠ 0, відсутній mutation.json попри запуск Stryker)
  * кидаються — у multi-root режимі це не маскує справжній збій.
  * @param {string} jsRoot абсолютний шлях до workspace-кореня
@@ -345,12 +463,18 @@ const defaultRunner = {
  */
 async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   const wsRel = relative(cwd, jsRoot)
-  // У changed-режимі production-файли для мутації = змінені JS цього root без тест-файлів.
-  const mutateSrc = scope ? scope.files.filter(f => !TEST_FILE.test(f)) : null
+  // У 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))
   if (bunNative && !(await hasRunnableTests(jsRoot))) {
     // `bun test` без тестів завершується помилкою — graceful skip як vitest --passWithNoTests.
     return scope
@@ -368,7 +492,11 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   try {
     const code = bunNative
       ? await runner.runBunCoverage({ cwd: jsRoot, lcovDir })
-      : await runner.runJsCoverage(scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir })
+      : await runner.runJsCoverage(
+          scope
+            ? { cwd: jsRoot, lcovDir, base: scope.base, excludeStorybookProject }
+            : { cwd: jsRoot, lcovDir, excludeStorybookProject }
+        )
     if (code !== 0) throw new Error(`JS coverage exit ${code}`)
     const lcovPath = join(lcovDir, 'lcov.info')
     coverage = existsSync(lcovPath)
@@ -404,10 +532,23 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   await runner.runStryker(scope ? { cwd: jsRoot, mutate: mutateSrc } : { cwd: jsRoot })
   const mutationPath = join(jsRoot, 'reports', 'stryker', 'mutation.json')
   if (!existsSync(mutationPath)) {
+    // Stryker vitest-runner не підтримує сучасний (Playwright-based) vitest browser mode
+    // (докладніше — коментар над collectStorybookForRoot): якщо стрикер-фейсінг vitest.config.mjs
+    // (на який вказує stryker.config.mjs#vitest.configFile) містить named-проєкт "storybook",
+    // Stryker намагається виконати і його — і падає без mutation.json. Виправлення на боці
+    // target-проєкту: винести Storybook-проєкт в окремий vitest-конфіг, якого Stryker НЕ бачить
+    // (не reused той самий configFile).
+    const storybookHint = excludeStorybookProject
+      ? ' Root має Storybook (.storybook/ + @storybook/addon-vitest) — якщо vitest.config.mjs, ' +
+        'на який вказує stryker.config.mjs#vitest.configFile, містить named-проєкт "storybook" ' +
+        '(browser mode), Stryker впаде на ньому (browser mode не підтримується vitest-runner) — ' +
+        'винеси Storybook-проєкт в окремий vitest-конфіг.'
+      : ''
     throw new Error(
       'js coverage: stryker не залишив mutation.json — ' +
         'переконайся що встановлено canonical stryker.config.mjs (vitest-runner, perTest), ' +
-        'або налаштуй його вручну'
+        'або налаштуй його вручну.' +
+        storybookHint
     )
   }
   const mutationReport = JSON.parse(await readFile(mutationPath, 'utf8'))
@@ -430,21 +571,228 @@ async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
 }
 
 /**
- * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує усі
- * JS-roots з `resolveAllJsRoots()` (включно з glob-патернами `cf/*`), запускає
- * vitest+Stryker у кожному та сумує lcov/mutation через `addCoverage`/`addMutation`.
- * Workspaces без тестів пропускаються (див. `collectOneRoot`).
- * Якщо тестів немає у жодному workspace — повертає `[]`.
+ * Збирає Storybook-покриття (Vue/React/... компоненти зі сторі) для **одного** JS-root.
+ * Активується лише коли `isStorybookRoot` (тека `.storybook/` + `@storybook/addon-vitest`
+ * у deps) і `hasStories` — інакше `null` (root не бере участі у рядку `Vue (Storybook)`).
+ *
+ * Mutation testing: у **changed-режимі** виконується власним mutate→run→restore
+ * executor-ом (`storybook-mutation.mjs`) — детерміновані AST-мутанти по змінених
+ * production-файлах, вбиває/милує реальний browser-mode прогін. У **full-режимі**
+ * власний executor надто дорогий (усі production-файли, не лише змінені) — тут шлях
+ * лише через canonical Stryker command-runner (`STORYBOOK_STRYKER_CONFIG`, див. нижче
+ * і `npm/docs/stryker-storybook-config.md`), якщо target-проєкт його налаштував;
+ * інакше чесний skip з попередженням (той самий принцип, що й bun-native).
+ *
+ * **Чому не Stryker (перевіряй перед покладанням на це в майбутньому — площина
+ * активно змінюється з обох боків):** issue stryker-js#4557 ("[vitest] support browser
+ * mode") ЗАКРИТИЙ через PR stryker-js#4628 ще у 2023 (v8.0.0) — але це стосувалось
+ * раннього browser mode доби vitest@1.0.0-beta, ДО сучасної provider-based архітектури
+ * (`@vitest/browser-playwright` тощо, стабілізованої у Vitest 4, 2025-12). Той старий фікс
+ * НЕ покриває сучасний Playwright-based browser mode, яким користується
+ * `@storybook/addon-vitest`: чинна документація Stryker vitest-runner прямо каже
+ * "Currently, Browser Mode is not supported" — інструментація Stryker передбачає
+ * Node.js-виконання, а сучасний browser mode виконує тести у реальному Chromium через
+ * Playwright, що структурно несумісно з тим, як Stryker патчить/спостерігає код.
+ * Власний executor слідує патерну, підтвердженому дослідженням спільноти
+ * (https://alexop.dev/posts/mutation-testing-ai-agents-vitest-browser-mode/, Mutahunter,
+ * Meta ACH): детермінована генерація мутантів + реальний прогін як суддя — без LLM
+ * у контурі виконання.
+ *
+ * **Валідована альтернатива (спайк 2026-07):** Stryker **command runner** (не
+ * vitest-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-пропагації взагалі.
+ *
+ * Changed-режим: запускається тільки якщо серед змінених файлів root-а є хоча б
+ * один `.vue`/`*.stories.*` (`scope.files` — вже звужений через `scopeToStorybookRoot`
+ * на боці виклику); інакше `null` (root пропускається повністю для цього виміру).
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @param {string} cwd корінь проєкту (для рібейзингу `survived[].file`)
+ * @param {{runStorybookCoverage:Function, runStorybookMutantTest?:Function, proposeStorybookLlmMutants?:Function, runStorybookStrykerFull?:Function}} runner spawn-ін'єкція
+ * @param {{files:string[], base:string|null}|null} [scope] changed-scope (null = full-режим)
+ * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результат або null коли root не Storybook/без сторі/без relevant-змін
+ */
+async function collectStorybookForRoot(jsRoot, cwd, runner, scope = null) {
+  const wsRel = relative(cwd, jsRoot)
+  if (!(await isStorybookRoot(jsRoot))) return null
+  if (!(await hasStories(jsRoot))) return null
+
+  const lcovDir = await mkdtemp(join(tmpdir(), 'sb-cov-'))
+  let coverage
+  let coveredLines = new Map()
+  let baselineMs = 0
+  try {
+    const startedAt = Date.now()
+    const code = await runner.runStorybookCoverage(
+      scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir }
+    )
+    baselineMs = Date.now() - startedAt
+    if (code !== 0) {
+      throw new Error(
+        `Storybook coverage exit ${code} — перевір встановлений Playwright Chromium ` +
+          '(`npx playwright install chromium`) і named vitest-проєкт "storybook" (canonical config)'
+      )
+    }
+    const lcovPath = join(lcovDir, 'lcov.info')
+    if (existsSync(lcovPath)) {
+      const lcovText = await readFile(lcovPath, 'utf8')
+      coverage = parseLcov(lcovText)
+      coveredLines = parseLcovCoveredLines(lcovText, jsRoot)
+    } else {
+      coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+    }
+  } finally {
+    await rm(lcovDir, { recursive: true, force: true })
+  }
+
+  // Full-режим: власний executor надто дорогий (повний suite × кожен мутант ×
+  // Chromium на ВСІХ production-файлах, не лише змінених) — тут шлях лише через
+  // canonical Stryker command-runner (STORYBOOK_STRYKER_CONFIG), якщо target-проєкт
+  // його налаштував (див. npm/docs/stryker-storybook-config.md). Без canonical
+  // конфіга або без runStorybookStrykerFull у runner-і — чесний skip, як і раніше.
+  if (!scope) {
+    const hasCanonicalConfig = existsSync(join(jsRoot, STORYBOOK_STRYKER_CONFIG))
+    if (hasCanonicalConfig && typeof runner.runStorybookStrykerFull === 'function') {
+      const code = await runner.runStorybookStrykerFull({ cwd: jsRoot })
+      const reportPath = join(jsRoot, STORYBOOK_STRYKER_REPORT)
+      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-проєкту'
+        )
+      }
+      if (existsSync(reportPath)) {
+        const report = JSON.parse(await readFile(reportPath, 'utf8'))
+        const parsed = parseStrykerReport(report, jsRoot)
+        console.log(
+          `✓ ${wsRel || '.'}: Storybook mutation (Stryker command runner) — ${parsed.caught}/${parsed.total} вбито`
+        )
+        return {
+          coverage,
+          mutation: { caught: parsed.caught, total: parsed.total },
+          survived: parsed.survived.map(group => ({
+            ...group,
+            file: wsRel === '' ? group.file : join(wsRel, group.file)
+          }))
+        }
+      }
+    }
+    console.error(
+      `⚠ ${wsRel || '.'}: Storybook (Vue) — mutation testing пропущено ` +
+        `(${hasCanonicalConfig ? 'runner без runStorybookStrykerFull' : `нема ${STORYBOOK_STRYKER_CONFIG}`}), лише line coverage`
+    )
+    return { coverage, mutation: { caught: 0, total: 0 }, survived: [] }
+  }
+
+  // Changed-режим: guard на runStorybookMutantTest тримає сумісність із
+  // інжектованими runner-ами без mutation-підтримки (лише line coverage).
+  if (typeof runner.runStorybookMutantTest !== 'function') {
+    console.error(
+      `⚠ ${wsRel || '.'}: Storybook (Vue) — mutation testing пропущено (runner без runStorybookMutantTest), лише line coverage`
+    )
+    return { coverage, mutation: { caught: 0, total: 0 }, survived: [] }
+  }
+
+  // Changed-режим: мутуємо лише змінені production-файли (без сторі/тестів) із покриттям.
+  // proposeStorybookLlmMutants (опційний у runner) — друге, LLM-джерело мутантів поверх
+  // детермінованих; інжектовані runner-и без нього отримують лише детерміновані.
+  const mutationTargets = scope.files.filter(f => !STORIES_FILE_RE.test(f) && !TEST_FILE.test(f))
+  const proposeExtra =
+    typeof runner.proposeStorybookLlmMutants === 'function'
+      ? (file, source, lines) => runner.proposeStorybookLlmMutants({ file, source, coveredLines: lines, cwd: jsRoot })
+      : null
+  const { caught, total, survived } = await runStorybookMutation({
+    jsRoot,
+    files: mutationTargets,
+    coveredLines,
+    runMutantTest: args => runner.runStorybookMutantTest(args),
+    resolveStoryFilter: file => findStoryFilter(jsRoot, file),
+    proposeExtraMutants: proposeExtra,
+    // Мутант-прогін звужено сторі-фільтром і без coverage — baseline (повний coverage-прогін)
+    // з запасом 3× покриває навіть повний suite; мінімум страхує холодний старт Chromium.
+    timeoutMs: Math.max(30_000, 3 * baselineMs)
+  })
+  if (total > 0) {
+    console.log(`✓ ${wsRel || '.'}: Storybook mutation — ${caught}/${total} вбито (changed-scope)`)
+  }
+
+  return {
+    coverage,
+    mutation: { caught, total },
+    survived: survived.map(group => ({
+      ...group,
+      file: wsRel === '' ? group.file : join(wsRel, group.file)
+    }))
+  }
+}
+
+const STORY_EXTENSIONS = ['js', 'mjs', 'ts', 'jsx', 'tsx']
+
+/**
+ * Шукає сторі-файл компонента поряд із ним (`Card.vue` → `Card.stories.{js,ts,...}`)
+ * для звуження мутант-прогону до релевантних тестів.
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @param {string} file відносний шлях компонента
+ * @returns {string | null} відносний шлях сторі-файлу або null (прогін без фільтра)
+ */
+function findStoryFilter(jsRoot, file) {
+  const base = file.replace(FILE_EXTENSION, '')
+  for (const ext of STORY_EXTENSIONS) {
+    const candidate = `${base}.stories.${ext}`
+    if (existsSync(join(jsRoot, candidate))) return candidate
+  }
+  return null
+}
+
+/**
+ * Будує підсумковий рядок з масиву per-root результатів через сумування coverage/mutation.
+ * @param {string} area назва рядка (`JS`, `Vue (Storybook)`)
+ * @param {Array<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>} results per-root результати
+ * @returns {{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}} агрегований рядок
+ */
+function buildAreaRow(area, results) {
+  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  let mutation = { caught: 0, total: 0 }
+  const survived = []
+  for (const r of results) {
+    coverage = addCoverage(coverage, r.coverage)
+    mutation = addMutation(mutation, r.mutation)
+    survived.push(...r.survived)
+  }
+  return { area, coverage, mutation, survived }
+}
+
+/**
+ * Збирає JS-метрики покриття + мутаційного тестування, і окремо — Storybook-покриття
+ * (Vue/React/... компоненти зі сторі, `collectStorybookForRoot`). У monorepo ітерує усі
+ * JS-roots з `resolveAllJsRoots()` (включно з glob-патернами `cf/*`), для кожного root-а
+ * запускає обидва виміри незалежно й сумує lcov/mutation окремо через `buildAreaRow`.
+ * Workspaces без тестів (JS) або без Storybook-конфігурації/сторі пропускаються по
+ * кожному виміру окремо (root може дати лише JS-рядок, лише Storybook-рядок, обидва
+ * або жодного). Якщо і JS, і Storybook відсутні всюди — повертає `[]`.
  * Шляхи у `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs`
  * знаходив джерела через `join(projectRoot, file)`.
  *
- * Changed-режим (`opts.changedFiles` задано): кожен root отримує лише свої змінені
- * JS-файли (`scopeToRoot`); roots без змінених JS пропускаються повністю (ні vitest,
- * ні Stryker). Якщо змін нема ніде — повертає `[]` без error-логу (оркестратор
- * трактує порожній changed-scope як pass).
+ * Changed-режим (`opts.changedFiles` задано): JS-вимір отримує лише змінені JS-файли
+ * root-а (`scopeToRoot`), Storybook-вимір — лише змінені `.vue`/`*.stories.*`
+ * (`scopeToStorybookRoot`); кожен вимір пропускається незалежно, якщо relevant-змін
+ * нема. Якщо змін нема ніде — повертає `[]` без error-логу (оркестратор трактує
+ * порожній changed-scope як pass).
  * @param {string} cwd корінь проєкту
  * @param {{runner?: typeof defaultRunner, changedFiles?: string[], base?: string|null}} [opts] runner-ін'єкція + changed-scope
- * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядок `JS` або `[]` коли тестів/змін нема ніде
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядки `JS`/`Vue (Storybook)` — лише ті, де є дані
  */
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
@@ -452,36 +800,45 @@ export async function collect(cwd, opts = {}) {
   const jsRoots = await resolveAllJsRoots(cwd)
   if (jsRoots.length === 0) throw new Error('js coverage: package.json не знайдено')
 
-  const results = []
+  const jsResults = []
+  const storybookResults = []
   for (const jsRoot of jsRoots) {
-    let scope = null
     if (changed) {
-      const files = scopeToRoot(opts.changedFiles, cwd, jsRoot)
-      if (files.length === 0) continue // root без змінених JS — пропускаємо
-      scope = { files, base: opts.base ?? null }
+      const jsFiles = scopeToRoot(opts.changedFiles, cwd, jsRoot)
+      if (jsFiles.length > 0) {
+        const scope = { files: jsFiles, base: opts.base ?? null }
+        const r = await collectOneRoot(jsRoot, cwd, runner, scope)
+        if (r !== null) jsResults.push(r)
+      }
+
+      const sbFiles = scopeToStorybookRoot(opts.changedFiles, cwd, jsRoot)
+      if (sbFiles.length > 0) {
+        const sbScope = { files: sbFiles, base: opts.base ?? null }
+        const sb = await collectStorybookForRoot(jsRoot, cwd, runner, sbScope)
+        if (sb !== null) storybookResults.push(sb)
+      }
+      continue
     }
-    const r = await collectOneRoot(jsRoot, cwd, runner, scope)
-    if (r !== null) results.push(r)
+
+    const r = await collectOneRoot(jsRoot, cwd, runner, null)
+    if (r !== null) jsResults.push(r)
+
+    const sb = await collectStorybookForRoot(jsRoot, cwd, runner, null)
+    if (sb !== null) storybookResults.push(sb)
   }
 
-  if (results.length === 0) {
-    // Changed-режим: нема змінених JS у жодному root → тихо порожньо (це pass, не помилка).
-    if (changed) return []
+  const rows = []
+  if (jsResults.length > 0) {
+    rows.push(buildAreaRow('JS', jsResults))
+  } else if (!changed) {
     console.error(
       'js coverage: жоден workspace не має тестів ' +
         '(`*.test.{js,mjs}` у `tests/` або поряд із джерелом) — ' +
         'додай тести або запусти `npx @7n/test` для генерації'
     )
-    return []
   }
-
-  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
-  let mutation = { caught: 0, total: 0 }
-  const survived = []
-  for (const r of results) {
-    coverage = addCoverage(coverage, r.coverage)
-    mutation = addMutation(mutation, r.mutation)
-    survived.push(...r.survived)
+  if (storybookResults.length > 0) {
+    rows.push(buildAreaRow('Vue (Storybook)', storybookResults))
   }
-  return [{ area: 'JS', coverage, mutation, survived }]
+  return rows
 }