@7n/test 0.14.5 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [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.15.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,6 +53,27 @@ 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)'
 
@@ -262,11 +294,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 +315,7 @@ const defaultRunner = {
         '--coverage',
         '--coverage.reporter=lcov',
         `--coverage.reportsDirectory=${lcovDir}`,
+        ...projectArgs,
         ...changedArgs
       ],
       { cwd, stdio: 'inherit', env: process.env }
@@ -301,6 +341,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
@@ -335,6 +426,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 +443,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 +472,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 +512,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 +551,183 @@ 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-режимі**
+ * пропускається з попередженням (повний suite × кожен мутант × Chromium — надто
+ * дорого; той самий принцип чесного 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-режиму (richer operator set + incremental mode).
+ *
+ * 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}} 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-режим: mutation чесно пропускається (див. JSDoc). Guard на runStorybookMutantTest
+  // тримає сумісність із інжектованими runner-ами без mutation-підтримки.
+  if (!scope || typeof runner.runStorybookMutantTest !== 'function') {
+    console.error(
+      `⚠ ${wsRel || '.'}: Storybook (Vue) — mutation testing пропущено ` +
+        '(у full-режимі надто дорого: повний browser-mode suite на кожен мутант), лише 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 +735,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
 }