@7n/rules-lang-js 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.12.0] - 2026-07-21
+
+### Added
+
+- storybook: новий concern `ci` (ADR Кластер 5, CI-частина) — канонічний composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише chromium) і `.github/workflows/lint-storybook.yml` (швидкий PR-прогін `vitest --project=storybook`), гейтований `requires.capability: ci:github`
+
+### Fixed
+
+- storybook: viteFinal-фільтр стійкий до VueMacros-стека (Promise/масив-резолв, сімейний фільтр vite:*/vue-macros), vitest@^4 provider-factory (@vitest/browser-playwright) замість застарілого рядка `'playwright'`, flat-root layout у detectStoriesGlob (components без src/), точковий alias-мок одного модуля в mocking.mdc, і STORIES_RE false positive на `storybookTest({ configDir })` без явного include — усе за результатами пілота adopt-діагностики на nitra/components. Заодно governance package_json.rego: allowlist доповнено `@vitest/browser-playwright`.
+- canon Storybook: viteConfigPath-обхід (empty-vite.config.js), валідний iconSet-імпорт, mswLoader замість mswDecorator, повний .storybook/**-glob у CI/lint, вирівняні governance-піни (storybook ^10.5.3, root Vite build-tooling deps), knip-виключення для .storybook-артефактів
+
+## [0.11.0] - 2026-07-21
+
+### Added
+
+- storybook: новий concern `ci` (ADR Кластер 5, CI-частина) — канонічний composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише chromium) і `.github/workflows/lint-storybook.yml` (швидкий PR-прогін `vitest --project=storybook`), гейтований `requires.capability: ci:github`
+
+### Fixed
+
+- storybook: viteFinal-фільтр стійкий до VueMacros-стека (Promise/масив-резолв, сімейний фільтр vite:*/vue-macros), vitest@^4 provider-factory (@vitest/browser-playwright) замість застарілого рядка `'playwright'`, flat-root layout у detectStoriesGlob (components без src/), точковий alias-мок одного модуля в mocking.mdc, і STORIES_RE false positive на `storybookTest({ configDir })` без явного include — усе за результатами пілота adopt-діагностики на nitra/components. Заодно governance package_json.rego: allowlist доповнено `@vitest/browser-playwright`.
+
 ## [0.10.0] - 2026-07-21
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules-lang-js",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Плагін @7n/rules: JS/npm/bun-екосистема — lint-правила (js/bun/vue/js-run/npm-module/db), taze-провайдер (package.json, bunx taze) і doc-files-екстрактори (oxc AST)",
   "keywords": [
     "javascript",

package/rules/bun/package_json/package_json.mdc

@@ -9,8 +9,8 @@ Rego-пакет: `bun.package_json`
 Gate виносить два класи deny:
 
 1. **Заборонені top-level поля** — будь-яке поле з `package.json.deny.json` присутнє у файлі (навіть із порожнім значенням `{}`).
-2. **devDependencies не з білого списку** — дозволені лише `@nitra/*`/`@7n/*` та root-only тестові peer/tools (`vitest`, `@vitest/coverage-v8`, `@vitest/browser`, `@stryker-mutator/vitest-runner`, `@stryker-mutator/core`, `@playwright/test`, `playwright`, `@storybook/addon-vitest`, `@7n/test`). Будь-який інший пакет → deny. CLI-тули, які `n-rules lint` спавнить через `bunx` (oxlint, jscpd, v8r, github-actionlint тощо), у root не пінуються — вони приїжджають як `dependencies` пакета `@7n/rules` (npm-module.mdc).
+2. **devDependencies не з білого списку** — дозволені лише `@nitra/*`/`@7n/*` та root-only тестові peer/tools (`vitest`, `@vitest/coverage-v8`, `@vitest/browser`, `@vitest/browser-playwright`, `@stryker-mutator/vitest-runner`, `@stryker-mutator/core`, `@playwright/test`, `playwright`, `@storybook/addon-vitest`, `@7n/test`). Будь-який інший пакет → deny. CLI-тули, які `n-rules lint` спавнить через `bunx` (oxlint, jscpd, v8r, github-actionlint тощо), у root не пінуються — вони приїжджають як `dependencies` пакета `@7n/rules` (npm-module.mdc).
 
-`@vitest/browser`/`playwright`/`@storybook/addon-vitest` — додані для named vitest project "storybook" (канон Storybook, кластер 5: browser-mode, лише chromium) — той самий root vitest.config, що й `unit`-проект; `@storybook/addon-vitest` постачає `storybookTest`-плагін для цього vitest-конфіга (канонічний template правила `storybook`). **Межа з `npm-module.mdc`**: Storybook-специфічні identity-пакети (`storybook`, `@storybook/vue3-vite`, `@storybook/vue3`, `msw`, `msw-storybook-addon`) у цей allowlist **не** додаються — вони живуть у `npm/package.json` консюмер-пакета (канон Storybook, кластер 7 Governance), бо `isStorybookRoot()` у `@7n/test` детектує Storybook-скоуп саме за тим файлом, не кореневим. `@storybook/addon-vitest` — виняток із цієї межі: він test-tooling (vitest-плагін), а не identity-маркер, тож root, як і решта vitest-peer'ів.
+`@vitest/browser`/`@vitest/browser-playwright`/`playwright`/`@storybook/addon-vitest` — додані для named vitest project "storybook" (канон Storybook, кластер 5: browser-mode, лише chromium) — той самий root vitest.config, що й `unit`-проект; `@storybook/addon-vitest` постачає `storybookTest`-плагін для цього vitest-конфіга (канонічний template правила `storybook`). `@vitest/browser-playwright` — окремий npm-пакет: vitest@^4 прибрав рядкове API browser-провайдера (`provider: 'playwright'`), потрібна factory `import { playwright } from '@vitest/browser-playwright'` → `provider: playwright()` (звірено з реальним `bun.lock` пілотного консюмера — усі три `@vitest/*`/`playwright`-пакети встановлені поруч). **Межа з `npm-module.mdc`**: Storybook-специфічні identity-пакети (`storybook`, `@storybook/vue3-vite`, `@storybook/vue3`, `msw`, `msw-storybook-addon`) у цей allowlist **не** додаються — вони живуть у `npm/package.json` консюмер-пакета (канон Storybook, кластер 7 Governance), бо `isStorybookRoot()` у `@7n/test` детектує Storybook-скоуп саме за тим файлом, не кореневим. `@storybook/addon-vitest` — виняток із цієї межі: він test-tooling (vitest-плагін), а не identity-маркер, тож root, як і решта vitest-peer'ів.
 
 Перевірки, що потребують FS або cross-file контексту (наприклад наявність `yarn.lock`), лишаються у JS-шарі.

package/rules/bun/package_json/package_json.rego

@@ -8,10 +8,11 @@
 #  - `devDependencies` лише `@nitra/*` + root-only тестові peer/tools для `@7n/test coverage`
 #    (правило `test` enabled завжди — див. `test/auto.md`; published workspace-и не мають
 #     `devDependencies` за `npm-module.mdc`)
-#  - `@vitest/browser`/`playwright`/`@storybook/addon-vitest` (browser-mode provider +
-#    `storybookTest`-плагін для named vitest project "storybook", лише chromium — канон
-#    Storybook кластер 5) теж root-only test peers: той самий vitest.config, що й
-#    `unit`-проект, живе в корені монорепо-споживача. Storybook-специфічні
+#  - `@vitest/browser`/`@vitest/browser-playwright`/`playwright`/`@storybook/addon-vitest`
+#    (browser-mode provider factory + `storybookTest`-плагін для named vitest project
+#    "storybook", лише chromium — канон Storybook кластер 5) теж root-only test peers:
+#    той самий vitest.config, що й `unit`-проект, живе в корені монорепо-споживача.
+#    Storybook-специфічні
 #    identity-пакети (`storybook`, `@storybook/vue3*`, `msw*`) НЕ сюди — вони живуть у
 #    `npm/package.json` (канон Storybook кластер 7, `npm-module.mdc`), бо
 #    `isStorybookRoot()` @7n/test читає саме той файл, не кореневий package.json.
@@ -59,25 +60,40 @@ deny contains msg if {
 # @stryker-mutator/core — обов'язковий exact-pin peer vitest-runner@9+ (раніше тягнувся транзитивно)
 # @7n/test — оркестратор `coverage` (npx @7n/test coverage); devDependency, щоб npx резолвив
 # локально без мережевого fetch щоразу.
-# @vitest/browser + playwright — провайдер browser-mode для named vitest project
-# "storybook" (канон Storybook кластер 5: лише chromium, PR — швидкий
-# --project=storybook). `playwright` (не `@playwright/test`) — сирий driver, який
-# @vitest/browser використовує як provider; `@playwright/test` лишається окремо для
-# змістовних E2E-сценаріїв (n-vue.mdc).
+# @vitest/browser + @vitest/browser-playwright + playwright — провайдер browser-mode для
+# named vitest project "storybook" (канон Storybook кластер 5: лише chromium, PR —
+# швидкий --project=storybook). vitest@^4 прибрав рядкове API провайдера
+# (`provider: 'playwright'`) — `@vitest/browser-playwright` постачає factory
+# `import { playwright } from '@vitest/browser-playwright'` → `provider: playwright()`,
+# окремий npm-пакет, не входить у `@vitest/browser` (звірено з реальним bun.lock пілота —
+# усі три пакети встановлені поруч). `playwright` (не `@playwright/test`) — сирий driver,
+# який `@vitest/browser-playwright` використовує як provider; `@playwright/test` лишається
+# окремо для змістовних E2E-сценаріїв (n-vue.mdc).
 # @storybook/addon-vitest — постачає `storybookTest` для vitest-плагіна в канонічному
 # vitest.config named-проекту "storybook" (той самий канон Storybook кластер 5); версія
-# з лінійки Storybook 9.x (узгоджена з `storybook`@9.1.10, запіненим у
+# з лінійки Storybook 10.x (узгоджена з `storybook`@^10.5.3, запіненим у
 # npm_package_json.rego) — allowlist тут за іменем, точний пінінг версії root-tooling
 # не робимо (на відміну від Storybook-identity-пакетів у npm/package.json).
+# @storybook/builder-vite/@vitejs/plugin-vue/@quasar/vite-plugin — root-only build-tooling
+# для канонічного `.storybook/main.js` (storybook.mdc scaffold: `core.builder`,
+# `viteFinal`-плагіни `vue()`/`quasar()`); @quasar/extras — постачає material-icons
+# CSS/fallback-набір для `.storybook/preview.js` (iconMapFn). Усі чотири звірено з
+# реальним root package.json пілотного консюмера (components) — раніше були відсутні
+# в allowlist, хоча канонічний скафолд Storybook уже на них покладався (реальний gap).
 allowed_root_test_deps := {
 	"vitest",
 	"@vitest/coverage-v8",
 	"@vitest/browser",
+	"@vitest/browser-playwright",
 	"@stryker-mutator/vitest-runner",
 	"@stryker-mutator/core",
 	"@playwright/test",
 	"playwright",
 	"@storybook/addon-vitest",
+	"@storybook/builder-vite",
+	"@vitejs/plugin-vue",
+	"@quasar/vite-plugin",
+	"@quasar/extras",
 	"@7n/test",
 }
 

package/rules/npm-module/npm_package_json/npm_package_json.mdc

@@ -62,7 +62,7 @@ FS-перевірки (наявність файлу зі шляху `types`, с
 ✓ Правильно — канонічний Storybook-devDep із зафіксованою версією (канон Storybook):
 
 ```json
-{ "devDependencies": { "storybook": "9.1.10" } }
+{ "devDependencies": { "storybook": "^10.5.3" } }
 ```
 
 ✗ Неправильно — Storybook-devDep присутній, але версія не збігається з каноном:

package/rules/npm-module/npm_package_json/npm_package_json.rego

@@ -41,12 +41,21 @@ storybook_version_template := concat(" ", [
 ])
 
 # Канонічні Storybook-devDeps (isStorybookRoot()-маркери, канон Storybook кластер 7):
-# зафіксована точна версія — єдина дозволена версія для кожного пакета. Оновлення —
-# ручна правка цієї map.
+# зафіксований точний РЯДОК версії, як він має бути записаний у package.json (включно з
+# `^`, якщо канон його використовує) — єдине дозволене значення для кожного пакета.
+# Оновлення — ручна правка цієї map, після емпіричної верифікації (звірка з реальним
+# консюмером, що пройшов повний прогін storybook build + тести на цих версіях).
+#
+# storybook/@storybook/vue3-vite піднято з 9.1.10 (exact) на ^10.5.3 — пілотний консюмер
+# (components/npm/package.json) реально пройшов storybook build + 58/58 тестів саме на
+# 10.5.3 з caret-діапазоном, а не на exact-пінованій 9.1.10 (яка на практиці ніде вже не
+# встановлюється). @storybook/vue3 — не окремий devDep пілота (транзитивна залежність
+# @storybook/vue3-vite), версія вирівняна до тієї самої лінійки про запас (allowlist за
+# іменем, presence не обов'язковий).
 storybook_canon_dev_deps := {
-	"storybook": "9.1.10",
-	"@storybook/vue3-vite": "9.1.10",
-	"@storybook/vue3": "9.1.10",
+	"storybook": "^10.5.3",
+	"@storybook/vue3-vite": "^10.5.3",
+	"@storybook/vue3": "^10.5.3",
 	"msw": "2.11.3",
 	"msw-storybook-addon": "2.0.5",
 }

package/rules/storybook/adopt/docs/main.md

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: plugins/lang-js/rules/storybook/adopt/main.mjs
 docgen:
-  crc: 640409c7
+  crc: 986ffd02
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 90
   issues: anchor-miss:(mocking.mdc),anchor-miss:(vitest-config.mdc),judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/storybook/adopt/main.mjs

@@ -2,8 +2,8 @@
  * Adopt-режим канону Storybook (ADR канон-storybook-для-vue-компонентних-бібліотек,
  * Кластер 8; main.mdc). Для пакетів, де ВЖЕ є ручний `.storybook/`, що не збігається з
  * каноном, — діагностика diff по секціях проти канонічних `template/` (main.js,
- * preview.js, mocks/gql-sse.js, package.json#scripts.storybook, vitest test.projects,
- * vitest.stryker.config), БЕЗ сліпого перезапису розбіжних файлів. Автофікс
+ * preview.js, empty-vite.config.js, mocks/gql-sse.js, package.json#scripts.storybook,
+ * vitest test.projects, vitest.stryker.config), БЕЗ сліпого перезапису розбіжних файлів. Автофікс
  * (`--fix-missing`) — лише для секцій, яких немає ВЗАГАЛІ (той самий рендер, що й
  * T0-фікс concern-ів `scaffold`/`vitest-config` — переюз, не дублювання шаблонування).
  *
@@ -21,7 +21,7 @@ import { isRunAsCli } from '@7n/rules/scripts/cli-entry.mjs'
 
 import { collectInScopeVuePackages } from '../scope/main.mjs'
 import { MAIN_JS_MARKERS, missingMarkers, PREVIEW_JS_MARKERS, STORYBOOK_SCRIPT } from '../scaffold/main.mjs'
-import { renderMainJs, renderMocksGqlSse, renderPreviewJs } from '../scaffold/fix-scaffold.mjs'
+import { renderEmptyViteConfig, renderMainJs, renderMocksGqlSse, renderPreviewJs } from '../scaffold/fix-scaffold.mjs'
 import { buildFreshVitestConfig, buildStrykerConfig } from '../vitest-config/fix-vitest-config.mjs'
 import {
   BROWSER_KEY_RE,
@@ -29,9 +29,10 @@ import {
   classifyProjects,
   findProperty,
   findTestObject,
+  hasStoriesMarker,
   parseModule,
+  PROVIDER_FACTORY_RE,
   resolveVitestConfigPath,
-  STORIES_RE,
   strykerConfigPathFor
 } from '../vitest-config/main.mjs'
 
@@ -42,6 +43,7 @@ export const STATUS = Object.freeze({ MATCH: 'match', DIFFER: 'differ', MISSING:
 export const SECTION = Object.freeze({
   MAIN_JS: 'main.js',
   PREVIEW_JS: 'preview.js',
+  EMPTY_VITE_CONFIG: 'empty-vite.config.js',
   MOCKS_GQL_SSE: 'mocks/gql-sse.js',
   PACKAGE_SCRIPT: 'package.json#scripts.storybook',
   VITEST_PROJECTS: 'vitest test.projects (unit+storybook)',
@@ -103,6 +105,30 @@ function diagnoseMocksSection(entry) {
   }
 }
 
+/**
+ * Діагностика `.storybook/empty-vite.config.js` — verbatim-порівняння з канонічним
+ * стенд-ін файлом (не залежить від пакета, як і `mocks/gql-sse.js`): `main.js` посилається
+ * на нього напряму через `core.builder.options.viteConfigPath`, тому розбіжність тут
+ * ламає обхід autodiscovery `@storybook/builder-vite`, навіть якщо `main.js` канонічний.
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @returns {{ name: string, file: string, status: string, detail?: string }} секція діагностики
+ */
+function diagnoseEmptyViteConfigSection(entry) {
+  const relPath = '.storybook/empty-vite.config.js'
+  const file = relFileFor(entry, relPath)
+  const abs = join(entry.absDir, relPath)
+  if (!existsSync(abs)) return { name: SECTION.EMPTY_VITE_CONFIG, file, status: STATUS.MISSING }
+  const actual = readFileSync(abs, 'utf8')
+  const canonical = renderEmptyViteConfig()
+  if (actual === canonical) return { name: SECTION.EMPTY_VITE_CONFIG, file, status: STATUS.MATCH }
+  return {
+    name: SECTION.EMPTY_VITE_CONFIG,
+    file,
+    status: STATUS.DIFFER,
+    detail: 'вміст відрізняється від канонічного стенд-іна (storybook.mdc) — має лишатись порожнім defineConfig({})'
+  }
+}
+
 /**
  * Діагностика `package.json#scripts.storybook`.
  * @param {{ pkg: Record<string, unknown>, rootDir: string }} entry запис пакета
@@ -167,7 +193,9 @@ function diagnoseVitestProjectsSection(entry) {
   const missingHints = []
   if (!CHROMIUM_RE.test(storybookSlice)) missingHints.push('chromium-інстанс')
   if (!BROWSER_KEY_RE.test(storybookSlice)) missingHints.push('browser-mode')
-  if (!STORIES_RE.test(storybookSlice)) missingHints.push('stories-glob')
+  if (!hasStoriesMarker(storybookSlice)) missingHints.push('stories-джерело (include або storybookTest({ configDir }))')
+  if (!PROVIDER_FACTORY_RE.test(storybookSlice))
+    missingHints.push('provider-factory (playwright() з @vitest/browser-playwright)')
   if (missingHints.length > 0) {
     return { name, file, status: STATUS.DIFFER, detail: `storybook-project без: ${missingHints.join(', ')}` }
   }
@@ -216,6 +244,7 @@ export async function diagnosePackage(entry) {
   const sections = [
     diagnoseMarkerFile(entry, '.storybook/main.js', SECTION.MAIN_JS, MAIN_JS_MARKERS),
     diagnoseMarkerFile(entry, '.storybook/preview.js', SECTION.PREVIEW_JS, PREVIEW_JS_MARKERS),
+    diagnoseEmptyViteConfigSection(entry),
     diagnoseMocksSection(entry),
     diagnoseScriptSection(entry),
     diagnoseVitestProjectsSection(entry),
@@ -252,6 +281,9 @@ export async function fixMissingSections(entry, sections) {
   if (byName.get(SECTION.PREVIEW_JS)?.status === STATUS.MISSING) {
     writeFileEnsureDir(join(entry.absDir, '.storybook/preview.js'), renderPreviewJs())
   }
+  if (byName.get(SECTION.EMPTY_VITE_CONFIG)?.status === STATUS.MISSING) {
+    writeFileEnsureDir(join(entry.absDir, '.storybook/empty-vite.config.js'), renderEmptyViteConfig())
+  }
   if (byName.get(SECTION.MOCKS_GQL_SSE)?.status === STATUS.MISSING) {
     writeFileEnsureDir(join(entry.absDir, '.storybook/mocks/gql-sse.js'), renderMocksGqlSse())
   }

package/rules/storybook/ci/concern.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "requires": { "capability": "ci:github" },
+  "lint": {
+    "scope": "full",
+    "glob": [
+      "**/package.json",
+      "**/*.vue",
+      "**/.storybook/**",
+      ".github/actions/setup-playwright-chromium/action.yml",
+      ".github/workflows/lint-storybook.yml"
+    ]
+  }
+}

package/rules/storybook/ci/docs/fix-ci.md

@@ -0,0 +1,39 @@
+---
+type: JS Module
+title: fix-ci.mjs
+resource: plugins/lang-js/rules/storybook/ci/fix-ci.mjs
+docgen:
+  crc: 877b9feb
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 90
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Порожній шаблон `storybook/ci`, з якого відтворюються репо-рівневі CI-артефакти: `setup-playwright-chromium` як verbatim-копія composite action для Playwright Chromium і `.github/workflows/lint-storybook.yml` із матрицею `strategy.matrix.package`, згенерованою з фактичного списку пакетів через `collectInScopeVuePackages`. Публічні anchors: `TEMPLATE_DIR`, `renderPlaywrightAction`, `renderPackageDirsYaml`, `renderStorybookWorkflow`, `patterns`.
+
+## Поведінка
+
+- **TEMPLATE_DIR** — вказує на каталог `template/` цього concern-а як джерело канонічних CI-шаблонів.
+- **renderPlaywrightAction** — читає канонічний composite action `setup-playwright-chromium` із шаблону без змін.
+- **renderPackageDirsYaml** — перетворює список коренів пакетів у YAML-рядки для матриці Storybook CI.
+- **renderStorybookWorkflow** — збирає канонічний `.github/workflows/lint-storybook.yml`, підставляючи в нього матрицю пакетів зі скоупу репозиторію.
+- **patterns** — описує T0-правила автофіксу для відновлення відсутніх CI-файлів цього concern-а.
+
+## Публічний API
+
+- TEMPLATE_DIR — Каталог `template/` цього concern-а.
+- renderPlaywrightAction — Вміст канонічного composite action `setup-playwright-chromium` — verbatim з template.
+- renderPackageDirsYaml — Рендерить YAML-фрагмент `matrix.package` списку — по одному `- <rootDir>` на рядок, з тим
+самим відступом, що й токен-рядок у шаблоні (10 пробілів — рівень елемента списку під
+`strategy.matrix.package:`). `rootDir === '.'` (корінь монорепо) лишається `.` — валідний
+`working-directory` для GitHub Actions.
+- renderStorybookWorkflow — Вміст канонічного `.github/workflows/lint-storybook.yml` — template з підставленою
+матрицею пакетів у скоупі.
+- patterns — повертає набір шаблонів, за якими далі шукають або зіставляють потрібні значення.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/storybook/ci/docs/index.md

@@ -0,0 +1,10 @@
+---
+type: Directory Index
+title: plugins/lang-js/rules/storybook/ci
+resource: plugins/lang-js/rules/storybook/ci/
+---
+
+| Файл                    | Тип       |
+| ----------------------- | --------- |
+| [fix-ci.mjs](fix-ci.md) | JS Module |
+| [main.mjs](main.md)     | JS Module |

package/rules/storybook/ci/docs/main.md

@@ -0,0 +1,50 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/storybook/ci/main.mjs
+docgen:
+  crc: 65df5791
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 85
+  issues: internal-name:collectInScopeVuePackages,anchor-miss:(storybook.mdc),judge:inaccurate:0.96
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл фіксує канонічні репо-шляхи й маркери для storybook CI, щоб у Vue component library пакетах у scope швидко знаходити правильні `.github/actions/setup-playwright-chromium/action.yml` і `.github/workflows/lint-storybook.yml` та зіставляти їх із повідомленнями в `storybook.mdc`. Експортовані константи-рядки: PLAYWRIGHT_ACTION_REL=".github/actions/setup-playwright-chromium/action.yml" — канонічний шлях до Playwright action; STORYBOOK_WORKFLOW_REL=".github/workflows/lint-storybook.yml" — канонічний шлях до workflow linting. Маркери повідомлень: PLAYWRIGHT_ACTION_MARKERS і STORYBOOK_WORKFLOW_MARKERS, які прив’язують перевірки до повідомлень у `storybook.mdc`. Це потрібно, щоб підтримувати єдиний storybook-канон без зайвого обходу `.github` і `.git`, із кешуванням результату в межах одного прогону.
+
+## Поведінка
+
+- PLAYWRIGHT_ACTION_REL — задає репо-рівневий шлях до канонічного composite action `.github/actions/setup-playwright-chromium/action.yml`, який перевіряється як частина storybook CI.
+- STORYBOOK_WORKFLOW_REL — задає репо-рівневий шлях до канонічного workflow `.github/workflows/lint-storybook.yml`, що відповідає за швидкий storybook-лінт.
+- PLAYWRIGHT_ACTION_MARKERS — описує канонічні ознаки composite action для storybook CI, щоб гарантувати кеш Playwright і встановлення лише chromium; у повідомленнях використовується прив’язка до `storybook.mdc`.
+- STORYBOOK_WORKFLOW_MARKERS — описує канонічні ознаки workflow для storybook CI, щоб гарантувати запуск швидкого `vitest --project=storybook`; у повідомленнях використовується прив’язка до `storybook.mdc`.
+- lint — перевіряє наявність storybook CI-канону лише для репозиторіїв із Vue component library пакетами в scope; якщо таких пакетів немає, завершується без зауважень. Свідомо не зачіпає `.github` і `.git` як окремі області обходу; кешує результат у межах одного прогону.
+
+## Публічний API
+
+- PLAYWRIGHT_ACTION_REL — Repo-relative шлях канонічного composite action (не per-package — один на репозиторій).
+- STORYBOOK_WORKFLOW_REL — Repo-relative шлях канонічного workflow, що запускає `vitest --project=storybook`.
+- PLAYWRIGHT_ACTION_MARKERS — Маркери канону composite action `setup-playwright-chromium` (ADR Кластер 5): кеш
+`ms-playwright` через `actions/cache`, ключ від версії playwright, install лише chromium.
+Текстовий пошук — той самий підхід, що й `MAIN_JS_MARKERS`/`PREVIEW_JS_MARKERS` у `scaffold`.
+- STORYBOOK_WORKFLOW_MARKERS — Маркери канону `.github/workflows/lint-storybook.yml`: композитний Playwright-кеш ПІСЛЯ
+setup-bun-deps, і швидкий `vitest --project=storybook` (ADR Кластер 5 — nightly-only
+`@7n/test coverage`/mutation-testing на PR не запускається, лише цей швидкий шлях).
+- lint — Detector concern-а `storybook/ci` (ADR Кластер 5, CI-частина): для репозиторіїв з бодай
+одним Vue component library пакетом у скоупі Storybook (`collectInScopeVuePackages`) —
+канонічний composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише
+chromium) і канонічний `.github/workflows/lint-storybook.yml`, що запускає швидкий
+`vitest --project=storybook` на PR. Гейтований `requires.capability: ci:github` — спить
+у репозиторіях без плагіна `@7n/rules-ci-github` (немає `.github/workflows`).
+
+Nightly-only `@7n/test coverage` (mutation testing) — поза обсягом цього concern-а: ADR
+Кластер 5 явно розділяє швидкий PR-шлях (цей concern) і nightly mutation-прогін, який
+лишається окремою інфраструктурою `test/stryker_config`.
+
+## Гарантії поведінки
+
+- Кешує результати в межах одного прогону.
+- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/storybook/ci/fix-ci.mjs

@@ -0,0 +1,105 @@
+/**
+ * T0-autofix для concern-а `storybook/ci` (ADR Кластер 5, CI-частина): відтворює канонічний
+ * composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише chromium) і
+ * канонічний `.github/workflows/lint-storybook.yml` з `template/` цього concern-а.
+ *
+ * Обидва файли — репо-рівневі (не per-package): composite action — verbatim-копія; workflow —
+ * матриця `strategy.matrix.package` генерується з фактичного списку пакетів у скоупі
+ * (`collectInScopeVuePackages`), щоб CI реально покривав усі Storybook-пакети репозиторію.
+ */
+import { mkdirSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { readFile } from 'node:fs/promises'
+
+import { collectInScopeVuePackages } from '../scope/main.mjs'
+
+/** Каталог `template/` цього concern-а. */
+export const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), 'template')
+
+/** Токен у `lint-storybook.yml.snippet.yml`, що заміщається списком пакетів матриці. */
+const PACKAGE_DIRS_TOKEN = '__STORYBOOK_CI_PACKAGE_DIRS__'
+
+/**
+ * Вміст канонічного composite action `setup-playwright-chromium` — verbatim з template.
+ * @param {string} [templateDir] каталог template/ (за замовчуванням — цього concern-а)
+ * @returns {Promise<string>} вміст `action.yml`
+ */
+export function renderPlaywrightAction(templateDir = TEMPLATE_DIR) {
+  return readFile(join(templateDir, 'setup-playwright-chromium.action.yml'), 'utf8')
+}
+
+/**
+ * Рендерить YAML-фрагмент `matrix.package` списку — по одному `- <rootDir>` на рядок, з тим
+ * самим відступом, що й токен-рядок у шаблоні (10 пробілів — рівень елемента списку під
+ * `strategy.matrix.package:`). `rootDir === '.'` (корінь монорепо) лишається `.` — валідний
+ * `working-directory` для GitHub Actions.
+ * @param {string[]} rootDirs відносні (posix) корені пакетів у скоупі
+ * @returns {string} YAML-рядки (без завершального переносу)
+ */
+export function renderPackageDirsYaml(rootDirs) {
+  return rootDirs.map(dir => `          - ${dir}`).join('\n')
+}
+
+/**
+ * Вміст канонічного `.github/workflows/lint-storybook.yml` — template з підставленою
+ * матрицею пакетів у скоупі.
+ * @param {string[]} rootDirs відносні корені пакетів у скоупі (`collectInScopeVuePackages`)
+ * @param {string} [templateDir] каталог template/ (за замовчуванням — цього concern-а)
+ * @returns {Promise<string>} вміст `lint-storybook.yml`
+ */
+export async function renderStorybookWorkflow(rootDirs, templateDir = TEMPLATE_DIR) {
+  const raw = await readFile(join(templateDir, 'lint-storybook.yml.snippet.yml'), 'utf8')
+  const tokenLineRe = new RegExp(`^[ \\t]*${PACKAGE_DIRS_TOKEN}[ \\t]*$`, 'mu')
+  // Replacer-функція (не рядок) — уникає unicorn/no-unsafe-string-replacement:
+  // рядок-заміна мав би трактувати `$`-послідовності як спецсимволи `String#replace`.
+  return raw.replace(tokenLineRe, () => renderPackageDirsYaml(rootDirs))
+}
+
+/**
+ * Записує файл, створюючи батьківські каталоги й реєструючи запис для rollback (той самий
+ * патерн, що й `writeScaffoldFile` у `scaffold/fix-scaffold.mjs`).
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').FixContext} ctx fix-контекст рунга
+ * @param {string} absPath абсолютний шлях цільового файлу
+ * @param {string} content вміст файлу
+ * @returns {void}
+ */
+function writeCiFile(ctx, absPath, content) {
+  mkdirSync(dirname(absPath), { recursive: true })
+  ctx.recordWrite?.(absPath)
+  writeFileSync(absPath, content, 'utf8')
+}
+
+/** @type {import('@7n/rules/scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'storybook-ci-playwright-action',
+    test: violations => violations.some(v => v.reason === 'missing-playwright-action' && v.file),
+    apply: async (violations, ctx) => {
+      const target = violations.find(v => v.reason === 'missing-playwright-action' && v.file)
+      if (!target || !ctx.concernDir) return { touchedFiles: [] }
+
+      const content = await renderPlaywrightAction(join(ctx.concernDir, 'template'))
+      const abs = join(ctx.cwd, target.file)
+      writeCiFile(ctx, abs, content)
+      return { touchedFiles: [abs], message: `${target.file}: створено composite action setup-playwright-chromium` }
+    }
+  },
+  {
+    id: 'storybook-ci-workflow',
+    test: violations => violations.some(v => v.reason === 'missing-storybook-workflow' && v.file),
+    apply: async (violations, ctx) => {
+      const target = violations.find(v => v.reason === 'missing-storybook-workflow' && v.file)
+      if (!target || !ctx.concernDir) return { touchedFiles: [] }
+
+      const pkgs = await collectInScopeVuePackages(ctx.cwd)
+      const rootDirs = pkgs.map(p => p.rootDir)
+      if (rootDirs.length === 0) return { touchedFiles: [] }
+
+      const content = await renderStorybookWorkflow(rootDirs, join(ctx.concernDir, 'template'))
+      const abs = join(ctx.cwd, target.file)
+      writeCiFile(ctx, abs, content)
+      return { touchedFiles: [abs], message: `${target.file}: створено (${rootDirs.length} пакет(ів) у матриці)` }
+    }
+  }
+]

package/rules/storybook/ci/main.mjs

@@ -0,0 +1,112 @@
+/** @see ./docs/main.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { createViolationReporter } from '@7n/rules/scripts/lib/lint-surface/violation-reporter.mjs'
+import { collectInScopeVuePackages } from '../scope/main.mjs'
+import { missingMarkers } from '../scaffold/main.mjs'
+
+/** Repo-relative шлях канонічного composite action (не per-package — один на репозиторій). */
+export const PLAYWRIGHT_ACTION_REL = '.github/actions/setup-playwright-chromium/action.yml'
+
+/** Repo-relative шлях канонічного workflow, що запускає `vitest --project=storybook`. */
+export const STORYBOOK_WORKFLOW_REL = '.github/workflows/lint-storybook.yml'
+
+/**
+ * Маркери канону composite action `setup-playwright-chromium` (ADR Кластер 5): кеш
+ * `ms-playwright` через `actions/cache`, ключ від версії playwright, install лише chromium.
+ * Текстовий пошук — той самий підхід, що й `MAIN_JS_MARKERS`/`PREVIEW_JS_MARKERS` у `scaffold`.
+ */
+export const PLAYWRIGHT_ACTION_MARKERS = [
+  { token: 'ms-playwright', hint: 'кеш каталогу ms-playwright' },
+  { token: 'actions/cache@', hint: 'actions/cache для Playwright-браузерів' },
+  { token: 'playwright install chromium', hint: 'install лише chromium (не всі браузери)' }
+]
+
+/**
+ * Маркери канону `.github/workflows/lint-storybook.yml`: композитний Playwright-кеш ПІСЛЯ
+ * setup-bun-deps, і швидкий `vitest --project=storybook` (ADR Кластер 5 — nightly-only
+ * `@7n/test coverage`/mutation-testing на PR не запускається, лише цей швидкий шлях).
+ */
+export const STORYBOOK_WORKFLOW_MARKERS = [
+  { token: './.github/actions/setup-bun-deps', hint: 'setup-bun-deps перед Playwright-кроком' },
+  { token: './.github/actions/setup-playwright-chromium', hint: 'композитний Playwright-кеш' },
+  { token: '--project=storybook', hint: 'швидкий прогін лише storybook-проєкту (не повний coverage)' }
+]
+
+/**
+ * Перевіряє один репо-рівневий канонічний файл (composite action чи workflow): відсутність →
+ * `missingReason`-порушення з посиланням на `npx \@7n/rules fix storybook`; присутність без
+ * якогось маркера → `markerReason`-порушення на конкретний маркер. Той самий патерн, що й
+ * `checkCanonFile` у `scaffold/main.mjs`, але без per-package `rootDir` — файл один на репо.
+ * @param {string} cwd абсолютний корінь репозиторію
+ * @param {string} relFile posix-relative шлях файлу від кореня репозиторію
+ * @param {{ token: string, hint: string }[]} markers канонічні маркери файлу
+ * @param {string} missingReason reason для порушення "файл відсутній"
+ * @param {string} markerReason reason для порушення "маркер відсутній"
+ * @param {ReturnType<typeof createViolationReporter>} reporter reporter поточного лінту
+ * @returns {Promise<void>}
+ */
+async function checkRepoCanonFile(cwd, relFile, markers, missingReason, markerReason, reporter) {
+  const abs = join(cwd, relFile)
+  if (existsSync(abs)) {
+    const content = await readFile(abs, 'utf8')
+    for (const m of missingMarkers(content, markers)) {
+      reporter.fail(`${relFile} не відповідає канону — бракує: ${m.hint} (storybook.mdc, ADR Кластер 5)`, {
+        reason: markerReason,
+        file: relFile
+      })
+    }
+    return
+  }
+  reporter.fail(
+    `Відсутній ${relFile} — канонічний Playwright-кеш для vitest storybook-проєкту: npx @7n/rules fix storybook (storybook.mdc, ADR Кластер 5)`,
+    { reason: missingReason, file: relFile }
+  )
+}
+
+/**
+ * Detector concern-а `storybook/ci` (ADR Кластер 5, CI-частина): для репозиторіїв з бодай
+ * одним Vue component library пакетом у скоупі Storybook (`collectInScopeVuePackages`) —
+ * канонічний composite action `setup-playwright-chromium` (кеш Playwright-браузерів, лише
+ * chromium) і канонічний `.github/workflows/lint-storybook.yml`, що запускає швидкий
+ * `vitest --project=storybook` на PR. Гейтований `requires.capability: ci:github` — спить
+ * у репозиторіях без плагіна `@7n/rules-ci-github` (немає `.github/workflows`).
+ *
+ * Nightly-only `@7n/test coverage` (mutation testing) — поза обсягом цього concern-а: ADR
+ * Кластер 5 явно розділяє швидкий PR-шлях (цей concern) і nightly mutation-прогін, який
+ * лишається окремою інфраструктурою `test/stryker_config`.
+ * @param {import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту
+ * @returns {Promise<import('@7n/rules/scripts/lib/lint-surface/types.mjs').LintResult>} результат лінту
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const cwd = ctx.cwd
+
+  const pkgs = await collectInScopeVuePackages(cwd)
+  if (pkgs.length === 0) {
+    reporter.pass('storybook/ci: немає Vue component library пакетів у скоупі (storybook.mdc)')
+    return reporter.result()
+  }
+
+  await checkRepoCanonFile(
+    cwd,
+    PLAYWRIGHT_ACTION_REL,
+    PLAYWRIGHT_ACTION_MARKERS,
+    'missing-playwright-action',
+    'playwright-action-marker-missing',
+    reporter
+  )
+
+  await checkRepoCanonFile(
+    cwd,
+    STORYBOOK_WORKFLOW_REL,
+    STORYBOOK_WORKFLOW_MARKERS,
+    'missing-storybook-workflow',
+    'storybook-workflow-marker-missing',
+    reporter
+  )
+
+  return reporter.result()
+}