@7n/rules-lang-js 0.9.0 → 0.11.0

package/rules/storybook/adopt/main.mjs

@@ -0,0 +1,382 @@
+/**
+ * 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), БЕЗ сліпого перезапису розбіжних файлів. Автофікс
+ * (`--fix-missing`) — лише для секцій, яких немає ВЗАГАЛІ (той самий рендер, що й
+ * T0-фікс concern-ів `scaffold`/`vitest-config` — переюз, не дублювання шаблонування).
+ *
+ * Circuit breaker (ADR): збій діагностики чи фіксу одного пакета деградує до
+ * `status: 'broken'` для ЦЬОГО пакета — решта пакетів прогону обробляються далі,
+ * увесь прогін ніколи не падає через один зламаний пакет.
+ *
+ * Викликається зі скіла (`npm/skills/storybook/SKILL.md`, `--adopt`):
+ *   bun node_modules/@7n/rules-lang-js/rules/storybook/adopt/main.mjs [--fix-missing] [--cwd <path>] [rootDir...]
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+
+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 { buildFreshVitestConfig, buildStrykerConfig } from '../vitest-config/fix-vitest-config.mjs'
+import {
+  BROWSER_KEY_RE,
+  CHROMIUM_RE,
+  classifyProjects,
+  findProperty,
+  findTestObject,
+  hasStoriesMarker,
+  parseModule,
+  PROVIDER_FACTORY_RE,
+  resolveVitestConfigPath,
+  strykerConfigPathFor
+} from '../vitest-config/main.mjs'
+
+/** Статуси однієї секції діагностики (діагностика ≠ lint-violation — тут завжди 4 значення). */
+export const STATUS = Object.freeze({ MATCH: 'match', DIFFER: 'differ', MISSING: 'missing' })
+
+/** Канонічні назви секцій (стабільні — на них зав'язаний `--fix-missing`-switch). */
+export const SECTION = Object.freeze({
+  MAIN_JS: 'main.js',
+  PREVIEW_JS: 'preview.js',
+  MOCKS_GQL_SSE: 'mocks/gql-sse.js',
+  PACKAGE_SCRIPT: 'package.json#scripts.storybook',
+  VITEST_PROJECTS: 'vitest test.projects (unit+storybook)',
+  STRYKER_CONFIG: 'vitest.stryker.config'
+})
+
+/**
+ * posix-relative шлях файлу пакета від кореня репозиторію (для звіту/сообщений).
+ * @param {{ rootDir: string }} entry запис пакета
+ * @param {string} suffix шлях файлу відносно кореня пакета
+ * @returns {string} відносний шлях від кореня репозиторію
+ */
+function relFileFor(entry, suffix) {
+  return entry.rootDir === '.' ? suffix : `${entry.rootDir}/${suffix}`
+}
+
+/**
+ * Діагностика файлу, канон якого перевіряється текстовими маркерами (main.js/preview.js).
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @param {string} relPath шлях файлу відносно кореня пакета (`.storybook/main.js`)
+ * @param {string} sectionName ім'я секції звіту
+ * @param {{ token: string, hint: string }[]} markers канонічні маркери файлу
+ * @returns {{ name: string, file: string, status: string, detail?: string }} одна секція діагностики
+ */
+function diagnoseMarkerFile(entry, relPath, sectionName, markers) {
+  const file = relFileFor(entry, relPath)
+  const abs = join(entry.absDir, relPath)
+  if (!existsSync(abs)) return { name: sectionName, file, status: STATUS.MISSING }
+  const content = readFileSync(abs, 'utf8')
+  const missing = missingMarkers(content, markers)
+  if (missing.length === 0) return { name: sectionName, file, status: STATUS.MATCH }
+  return {
+    name: sectionName,
+    file,
+    status: STATUS.DIFFER,
+    detail: `бракує: ${missing.map(m => m.hint).join(', ')}`
+  }
+}
+
+/**
+ * Діагностика `.storybook/mocks/gql-sse.js` — verbatim-порівняння з канонічним helper-ом
+ * (одне джерело істини протоколу graphql-sse, mocking.mdc — не переносити копію в пакет).
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @returns {{ name: string, file: string, status: string, detail?: string }} секція діагностики
+ */
+function diagnoseMocksSection(entry) {
+  const relPath = '.storybook/mocks/gql-sse.js'
+  const file = relFileFor(entry, relPath)
+  const abs = join(entry.absDir, relPath)
+  if (!existsSync(abs)) return { name: SECTION.MOCKS_GQL_SSE, file, status: STATUS.MISSING }
+  const actual = readFileSync(abs, 'utf8')
+  const canonical = renderMocksGqlSse()
+  if (actual === canonical) return { name: SECTION.MOCKS_GQL_SSE, file, status: STATUS.MATCH }
+  return {
+    name: SECTION.MOCKS_GQL_SSE,
+    file,
+    status: STATUS.DIFFER,
+    detail: 'вміст відрізняється від канонічного helper-а (mocking.mdc) — одне джерело істини, не дублюй логіку вручну'
+  }
+}
+
+/**
+ * Діагностика `package.json#scripts.storybook`.
+ * @param {{ pkg: Record<string, unknown>, rootDir: string }} entry запис пакета
+ * @returns {{ name: string, file: string, status: string, detail?: string }} секція діагностики
+ */
+function diagnoseScriptSection(entry) {
+  const file = relFileFor(entry, 'package.json')
+  const current = /** @type {{ scripts?: Record<string, unknown> }} */ (entry.pkg)?.scripts?.storybook
+  if (current === undefined) return { name: SECTION.PACKAGE_SCRIPT, file, status: STATUS.MISSING }
+  if (current === STORYBOOK_SCRIPT) return { name: SECTION.PACKAGE_SCRIPT, file, status: STATUS.MATCH }
+  return {
+    name: SECTION.PACKAGE_SCRIPT,
+    file,
+    status: STATUS.DIFFER,
+    detail: `зараз '${current}', канон '${STORYBOOK_SCRIPT}'`
+  }
+}
+
+/**
+ * Діагностика `test.projects` наявного vitest-конфіга (unit+storybook, browser-mode маркери).
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @returns {{ name: string, file: string, status: string, detail?: string }} секція діагностики
+ */
+function diagnoseVitestProjectsSection(entry) {
+  const name = SECTION.VITEST_PROJECTS
+  const vitestConfigPath = resolveVitestConfigPath(entry.absDir)
+  if (!vitestConfigPath) {
+    return { name, file: relFileFor(entry, 'vitest.config.mjs'), status: STATUS.MISSING }
+  }
+  const file = relFileFor(entry, vitestConfigPath.slice(entry.absDir.length + 1))
+  const src = readFileSync(vitestConfigPath, 'utf8')
+
+  let parsed
+  try {
+    parsed = parseModule(vitestConfigPath, src)
+  } catch (error) {
+    return { name, file, status: STATUS.DIFFER, detail: `не парситься (${error.message}) — перевір вручну` }
+  }
+  if (parsed.errors?.length) {
+    return { name, file, status: STATUS.DIFFER, detail: 'syntax error — перевір вручну' }
+  }
+
+  const testObj = findTestObject(parsed.program)
+  if (!testObj) {
+    return { name, file, status: STATUS.DIFFER, detail: 'немає test-блоку (defineConfig({ test: {...} }))' }
+  }
+
+  const projectsProp = findProperty(testObj, 'projects')
+  if (!projectsProp) {
+    return { name, file, status: STATUS.MISSING, detail: 'test.projects відсутній' }
+  }
+  if (projectsProp.value?.type !== 'ArrayExpression') {
+    return { name, file, status: STATUS.DIFFER, detail: 'test.projects не статичний масив (spread/змінна)' }
+  }
+
+  const { hasUnit, storybookSlice } = classifyProjects(src, projectsProp.value)
+  if (!hasUnit || !storybookSlice) {
+    const missingParts = [hasUnit ? null : "'unit'", storybookSlice ? null : "'storybook'"].filter(Boolean)
+    return { name, file, status: STATUS.DIFFER, detail: `бракує ${missingParts.join(' і ')} у test.projects` }
+  }
+
+  const missingHints = []
+  if (!CHROMIUM_RE.test(storybookSlice)) missingHints.push('chromium-інстанс')
+  if (!BROWSER_KEY_RE.test(storybookSlice)) missingHints.push('browser-mode')
+  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(', ')}` }
+  }
+
+  return { name, file, status: STATUS.MATCH }
+}
+
+/**
+ * Діагностика ізольованого `vitest.stryker.config.*` — байтове порівняння з канонічним
+ * baseline-рендером (fix-vitest-config.mjs, той самий генератор).
+ * @param {{ absDir: string, rootDir: string }} entry запис пакета
+ * @returns {Promise<{ name: string, file: string, status: string, detail?: string }>} секція діагностики
+ */
+async function diagnoseStrykerSection(entry) {
+  const name = SECTION.STRYKER_CONFIG
+  const vitestConfigPath = resolveVitestConfigPath(entry.absDir)
+  if (!vitestConfigPath) {
+    return { name, file: relFileFor(entry, 'vitest.stryker.config.mjs'), status: STATUS.MISSING }
+  }
+  const strykerPath = strykerConfigPathFor(vitestConfigPath)
+  const file = relFileFor(entry, strykerPath.slice(entry.absDir.length + 1))
+  if (!existsSync(strykerPath)) {
+    return { name, file, status: STATUS.MISSING }
+  }
+  const actual = readFileSync(strykerPath, 'utf8')
+  const canonical = await buildStrykerConfig(entry.absDir)
+  if (actual === canonical) return { name, file, status: STATUS.MATCH }
+  return {
+    name,
+    file,
+    status: STATUS.DIFFER,
+    detail:
+      'вміст відрізняється від канонічного baseline (vitest-config.mdc) — @stryker-mutator/vitest-runner крашиться на browser-mode projects, перевір вручну'
+  }
+}
+
+/**
+ * Діагностика одного пакета в скоупі по секціях. Ніколи не кидає — збій окремої
+ * секції (парсинг/IO) відображається як секція `differ`, а не виняток, що впав
+ * би на весь пакет; лишається на розсуд `diagnosePackage` (circuit breaker рівня
+ * пакета — тут не потрібен, бо секції вже ізольовані одна від одної).
+ * @param {import('../scope/main.mjs').InScopePackage} entry пакет у скоупі
+ * @returns {Promise<{ rootDir: string, status: 'canonical'|'missing-files'|'differs', sections: object[] }>} діагностика пакета
+ */
+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),
+    diagnoseMocksSection(entry),
+    diagnoseScriptSection(entry),
+    diagnoseVitestProjectsSection(entry),
+    await diagnoseStrykerSection(entry)
+  ]
+  let status = 'canonical'
+  if (sections.some(s => s.status === STATUS.DIFFER)) status = 'differs'
+  else if (sections.some(s => s.status === STATUS.MISSING)) status = 'missing-files'
+  return { rootDir: entry.rootDir, status, sections }
+}
+
+/**
+ * Генерує канонічний вміст лише для секцій зі статусом `missing` одного пакета
+ * (adopt-автофікс НІКОЛИ не чіпає секції зі статусом `differ` — інструкція
+ * для агента/людини, не сліпий перезапис). Кожна секція фіксується незалежно;
+ * збій однієї не блокує решту (той самий circuit-breaker принцип, лише на дрібнішому рівні).
+ * @param {import('../scope/main.mjs').InScopePackage} entry пакет у скоупі
+ * @param {object[]} sections секції діагностики пакета (`diagnosePackage().sections`)
+ * @returns {Promise<string[]>} абсолютні шляхи записаних файлів
+ */
+export async function fixMissingSections(entry, sections) {
+  const written = []
+  const writeFileEnsureDir = (absPath, content) => {
+    mkdirSync(dirname(absPath), { recursive: true })
+    writeFileSync(absPath, content, 'utf8')
+    written.push(absPath)
+  }
+
+  const byName = new Map(sections.map(s => [s.name, s]))
+
+  if (byName.get(SECTION.MAIN_JS)?.status === STATUS.MISSING) {
+    writeFileEnsureDir(join(entry.absDir, '.storybook/main.js'), renderMainJs(entry.absDir))
+  }
+  if (byName.get(SECTION.PREVIEW_JS)?.status === STATUS.MISSING) {
+    writeFileEnsureDir(join(entry.absDir, '.storybook/preview.js'), renderPreviewJs())
+  }
+  if (byName.get(SECTION.MOCKS_GQL_SSE)?.status === STATUS.MISSING) {
+    writeFileEnsureDir(join(entry.absDir, '.storybook/mocks/gql-sse.js'), renderMocksGqlSse())
+  }
+  if (byName.get(SECTION.PACKAGE_SCRIPT)?.status === STATUS.MISSING) {
+    const pkgPath = join(entry.absDir, 'package.json')
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+    pkg.scripts = pkg.scripts && typeof pkg.scripts === 'object' ? pkg.scripts : {}
+    pkg.scripts.storybook = STORYBOOK_SCRIPT
+    writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8')
+    written.push(pkgPath)
+  }
+  if (byName.get(SECTION.VITEST_PROJECTS)?.status === STATUS.MISSING && !resolveVitestConfigPath(entry.absDir)) {
+    // test.projects відсутній ЛИШЕ через відсутність усього vitest-конфіга — augment
+    // наявного (без відсутнього test-блоку) свідомо поза adopt-автофіксом: секція вже
+    // позначена `differ` (не `missing`) для такого випадку, сюди він не потрапляє.
+    const fresh = await buildFreshVitestConfig(entry.absDir)
+    writeFileEnsureDir(fresh.path, fresh.content)
+  }
+  if (byName.get(SECTION.STRYKER_CONFIG)?.status === STATUS.MISSING) {
+    const vitestConfigPath = resolveVitestConfigPath(entry.absDir) ?? join(entry.absDir, 'vitest.config.mjs')
+    const strykerPath = strykerConfigPathFor(vitestConfigPath)
+    writeFileEnsureDir(strykerPath, await buildStrykerConfig(entry.absDir))
+  }
+
+  return written
+}
+
+/**
+ * Adopt-прогін усіх (чи обраних) пакетів у скоупі. Circuit breaker (ADR Кластер 8):
+ * збій діагностики/фіксу ОДНОГО пакета деградує до `status: 'broken'` для нього —
+ * решта пакетів обробляються далі, весь прогін ніколи не падає через один зламаний.
+ * @param {string} cwd абсолютний корінь консюмер-репо
+ * @param {{ fixMissing?: boolean, rootDirs?: string[] }} [opts] `fixMissing` — генерувати
+ *   відсутні секції; `rootDirs` — звузити прогін до цих коренів пакетів (порожньо/відсутнє → усі в скоупі)
+ * @returns {Promise<{ rootDir: string, status: string, sections?: object[], written?: string[], error?: string }[]>} результати за пакетами
+ */
+export async function runAdopt(cwd, opts = {}) {
+  const fixMissing = opts.fixMissing === true
+  const wantedRoots = Array.isArray(opts.rootDirs) && opts.rootDirs.length > 0 ? new Set(opts.rootDirs) : null
+
+  const allPkgs = await collectInScopeVuePackages(cwd)
+  const pkgs = wantedRoots ? allPkgs.filter(p => wantedRoots.has(p.rootDir)) : allPkgs
+
+  const results = []
+  for (const entry of pkgs) {
+    try {
+      const diagnosis = await diagnosePackage(entry)
+      const written = fixMissing ? await fixMissingSections(entry, diagnosis.sections) : []
+      results.push({ ...diagnosis, written })
+    } catch (error) {
+      results.push({
+        rootDir: entry.rootDir,
+        status: 'broken',
+        error: error instanceof Error ? error.message : String(error)
+      })
+    }
+  }
+  return results
+}
+
+/** Іконка статусу пакета (`package.status`) для рядка звіту. */
+const PACKAGE_STATUS_ICONS = Object.freeze({ canonical: '✅', 'missing-files': '➕' })
+/** Іконка статусу секції (`STATUS.*`) для рядка звіту. */
+const SECTION_STATUS_ICONS = Object.freeze({ [STATUS.MATCH]: '  ✓', [STATUS.MISSING]: '  +' })
+
+/**
+ * Рядки звіту одного НЕ зламаного пакета (статус + секції + перелік згенерованого).
+ * @param {{ rootDir: string, status: string, sections: object[], written?: string[] }} r результат одного пакета
+ * @returns {string[]} рядки звіту
+ */
+function formatPackageLines(r) {
+  const label = r.rootDir === '.' ? 'корінь' : r.rootDir
+  const lines = [`${PACKAGE_STATUS_ICONS[r.status] ?? '⚠️ '} [${label}] ${r.status}`]
+  for (const s of r.sections) {
+    const sIcon = SECTION_STATUS_ICONS[s.status] ?? '  ✗'
+    const suffix = s.detail ? ` — ${s.detail}` : ''
+    lines.push(`${sIcon} ${s.name} (${s.file}): ${s.status}${suffix}`)
+  }
+  if (r.written && r.written.length > 0) {
+    lines.push(`  згенеровано: ${r.written.join(', ')}`)
+  }
+  return lines
+}
+
+/**
+ * Форматує людський звіт по результатах `runAdopt` (українською, для виводу скіла в CLI).
+ * @param {Awaited<ReturnType<typeof runAdopt>>} results результати `runAdopt`
+ * @returns {string} багаторядковий текстовий звіт
+ */
+export function formatReport(results) {
+  if (results.length === 0) {
+    return 'storybook adopt: немає Vue component library пакетів у скоупі (storybook.mdc → scope/main.mjs)'
+  }
+  const lines = []
+  for (const r of results) {
+    if (r.status === 'broken') {
+      const label = r.rootDir === '.' ? 'корінь' : r.rootDir
+      lines.push(`⚠️  [${label}] діагностика впала (circuit breaker, пропущено): ${r.error}`)
+      continue
+    }
+    lines.push(...formatPackageLines(r))
+  }
+  return lines.join('\n')
+}
+
+/**
+ * CLI-вхід: `bun .../storybook/adopt/main.mjs [--fix-missing] [--cwd <path>] [rootDir...]`.
+ * @returns {Promise<void>} завершення прогону (друкує звіт, exit-код — кількість `differs`/`broken`)
+ */
+async function runCli() {
+  const args = process.argv.slice(2)
+  const fixMissing = args.includes('--fix-missing')
+  const cwdIdx = args.indexOf('--cwd')
+  const cwd = cwdIdx !== -1 && args[cwdIdx + 1] ? args[cwdIdx + 1] : process.cwd()
+  const rootDirs = args.filter((a, i) => !a.startsWith('--') && args[i - 1] !== '--cwd')
+
+  const results = await runAdopt(cwd, { fixMissing, rootDirs })
+  console.log(formatReport(results))
+  const hasIssues = results.some(r => r.status === 'differs' || r.status === 'broken')
+  process.exitCode = hasIssues ? 1 : 0
+}
+
+if (isRunAsCli(import.meta.url)) {
+  await runCli()
+}

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} пакет(ів) у матриці)` }
+    }
+  }
+]