@nitra/cursor 12.11.1 → 12.11.2

package/scripts/lib/fix/t0.mjs

@@ -1,238 +1,14 @@
 /** @see ./docs/t0.md */
-import { spawnSync } from 'node:child_process'
-import { appendFileSync, existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
+import { discoverT0Patterns } from './discover-t0-patterns.mjs'
 import { runConformanceCheck } from './run-conformance-check.mjs'
-import { writeChange } from '../../../rules/release/change.mjs'
 
-const REC_REQUIRE_RE = /recommendations має містити "[^"]+"/
-const REC_MATCH_ALL_RE = /recommendations має містити "([^"]+)"/g
-const FORBIDDEN_FILE_RE = /Знайдено заборонений файл: \S+/
-const FORBIDDEN_FILE_MATCH_ALL_RE = /Знайдено заборонений файл: (\S+)/g
-// Конформність changelog: «<ws>: є релевантні зміни, але немає change-файлу».
-const MISSING_CHANGE_RE = /є релевантні зміни, але немає change-файлу/
-const MISSING_CHANGE_MATCH_ALL_RE = /(?:^|\s)([\w./@-]+): є релевантні зміни, але немає change-файлу/gm
-/** Дефолти autofix-створеного change-файлу (узгоджено з n-changelog.mdc / consistency.mjs). */
-const CHANGE_BUMP = 'patch'
-const CHANGE_SECTION = 'Changed'
-const CHANGE_FALLBACK_MESSAGE = 'оновлення'
-
-/**
- * Опис для авто-створеного change-файлу: subject останнього коміту, інакше fallback.
- * @param {string} cwd корінь репозиторію
- * @returns {string} непорожній опис
- */
-function autoChangeMessage(cwd) {
-  const r = spawnSync('git', ['log', '-1', '--format=%s'], { cwd, encoding: 'utf8' })
-  const subject = r.status === 0 ? (r.stdout ?? '').trim() : ''
-  return subject || CHANGE_FALLBACK_MESSAGE
-}
-
-/**
- * Патерни T0-auto.
- * Кожен паттерн: {
- *   id:      string         — унікальна назва паттерну (для логу)
- *   test:    (output)=>bool — чи підходить цей output до паттерну
- *   apply:   (match, cwd)=>{ ok: bool, action: string } — застосувати фікс
- * }
- */
-const PATTERNS = [
-  // ── vscode-ext-add ──────────────────────────────────────────────────────────
-  // Violation: «recommendations має містити "tsandall.opa"»
-  // Fix: додати рядок у .vscode/extensions.json#recommendations
-  {
-    id: 'vscode-ext-add',
-    test: out => REC_REQUIRE_RE.test(out),
-    apply: (out, cwd) => {
-      const matches = [...out.matchAll(REC_MATCH_ALL_RE)]
-      if (matches.length === 0) return { ok: false, action: 'no match' }
-
-      const extPath = join(cwd, '.vscode/extensions.json')
-      if (!existsSync(extPath)) {
-        return { ok: false, action: '.vscode/extensions.json не знайдено' }
-      }
-
-      let parsed
-      try {
-        parsed = JSON.parse(readFileSync(extPath, 'utf8'))
-      } catch {
-        return { ok: false, action: '.vscode/extensions.json: невалідний JSON' }
-      }
-
-      const recs = Array.isArray(parsed.recommendations) ? parsed.recommendations : []
-      const toAdd = matches.map(m => m[1]).filter(e => !recs.includes(e))
-      if (toAdd.length === 0) return { ok: false, action: 'вже є' }
-
-      parsed.recommendations = [...recs, ...toAdd]
-      writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
-      return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
-    }
-  },
-
-  // ── rm-forbidden-file ────────────────────────────────────────────────────────
-  // Violation: «Знайдено заборонений файл: package-lock.json»
-  // Fix: видалити файл
-  {
-    id: 'rm-forbidden-file',
-    test: out => FORBIDDEN_FILE_RE.test(out),
-    apply: (out, cwd) => {
-      const matches = [...out.matchAll(FORBIDDEN_FILE_MATCH_ALL_RE)]
-      if (matches.length === 0) return { ok: false, action: 'no match' }
-
-      const removed = []
-      for (const m of matches) {
-        const filePath = join(cwd, m[1])
-        if (existsSync(filePath)) {
-          rmSync(filePath, { force: true })
-          removed.push(m[1])
-        }
-      }
-      if (removed.length === 0) return { ok: false, action: 'файлів не знайдено' }
-      return { ok: true, action: `видалено: ${removed.join(', ')}` }
-    }
-  },
-
-  // ── changelog-create-change-file ─────────────────────────────────────────────
-  // Violation: «<ws>: є релевантні зміни, але немає change-файлу»
-  // Fix: створити change-файл через канонічну `writeChange` (без LLM) — той самий
-  // механізм, що autofix changelog-конформності. Прибирає ескалацію в хмару на цьому кейсі.
-  {
-    id: 'changelog-create-change-file',
-    test: out => MISSING_CHANGE_RE.test(out),
-    apply: async (out, cwd) => {
-      const workspaces = Array.from(out.matchAll(MISSING_CHANGE_MATCH_ALL_RE), m => m[1])
-      if (workspaces.length === 0) return { ok: false, action: 'no match' }
-
-      const message = autoChangeMessage(cwd)
-      const created = []
-      for (const ws of workspaces) {
-        try {
-          const rel = await writeChange({ bump: CHANGE_BUMP, section: CHANGE_SECTION, message, ws, cwd })
-          created.push(ws === '.' ? rel : join(ws, rel))
-        } catch (error) {
-          return { ok: false, action: `writeChange ${ws}: ${error.message}` }
-        }
-      }
-      return { ok: true, action: `створено change-файл (${CHANGE_BUMP}/${CHANGE_SECTION}): ${created.join(', ')}` }
-    }
-  },
-
-  // ── bun-bunfig-create ────────────────────────────────────────────────────────
-  // Violation: «Відсутній bunfig.toml — створи з [install] linker = "hoisted"»
-  // Fix: створити bunfig.toml з канонічним вмістом (bun.mdc)
-  {
-    id: 'bun-bunfig-create',
-    test: out => /Відсутній bunfig\.toml/.test(out),
-    apply: (_out, cwd) => {
-      const target = join(cwd, 'bunfig.toml')
-      if (existsSync(target)) return { ok: false, action: 'bunfig.toml вже існує' }
-      writeFileSync(target, '[install]\nlinker = "hoisted"\n', 'utf8')
-      return { ok: true, action: 'створено bunfig.toml' }
-    }
-  },
-
-  // ── bun-yarn-dir-remove ──────────────────────────────────────────────────────
-  // Violation: «Знайдено директорію .yarn — видали її»
-  // Fix: рекурсивно видалити .yarn/
-  {
-    id: 'bun-yarn-dir-remove',
-    test: out => /Знайдено директорію \.yarn/.test(out),
-    apply: (_out, cwd) => {
-      const target = join(cwd, '.yarn')
-      if (!existsSync(target)) return { ok: false, action: '.yarn не знайдено' }
-      rmSync(target, { recursive: true, force: true })
-      return { ok: true, action: 'видалено .yarn/' }
-    }
-  },
-
-  // ── style-stylelintignore-create ─────────────────────────────────────────────
-  // Violation: «.stylelintignore не існує — створи з вмістом: dist/»
-  // Fix: створити .stylelintignore з рядком dist/
-  {
-    id: 'style-stylelintignore-create',
-    test: out => /\.stylelintignore не існує/.test(out),
-    apply: (_out, cwd) => {
-      writeFileSync(join(cwd, '.stylelintignore'), 'dist/\n', 'utf8')
-      return { ok: true, action: 'створено .stylelintignore' }
-    }
-  },
-
-  // ── style-stylelintignore-dist-add ───────────────────────────────────────────
-  // Violation: «.stylelintignore не містить рядка dist/»
-  // Fix: дописати dist/ до існуючого .stylelintignore
-  {
-    id: 'style-stylelintignore-dist-add',
-    test: out => /\.stylelintignore не містить рядка dist\//.test(out),
-    apply: (_out, cwd) => {
-      const target = join(cwd, '.stylelintignore')
-      appendFileSync(target, '\ndist/\n', 'utf8')
-      return { ok: true, action: 'додано dist/ до .stylelintignore' }
-    }
-  },
-
-  // ── style-pkg-stylelint-add ──────────────────────────────────────────────────
-  // Violation: «Немає конфігу stylelint — додай "stylelint": {...} до package.json»
-  // Fix: додати поле stylelint до кореневого package.json
-  {
-    id: 'style-pkg-stylelint-add',
-    test: out => /Немає конфігу stylelint/.test(out),
-    apply: (_out, cwd) => {
-      const pkgPath = join(cwd, 'package.json')
-      if (!existsSync(pkgPath)) return { ok: false, action: 'package.json не знайдено' }
-      let pkg
-      try {
-        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
-      } catch {
-        return { ok: false, action: 'package.json: невалідний JSON' }
-      }
-      if (pkg.stylelint) return { ok: false, action: 'stylelint вже є в package.json' }
-      pkg.stylelint = { extends: '@nitra/stylelint-config' }
-      writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8')
-      return { ok: true, action: 'додано stylelint до package.json' }
-    }
-  },
-
-  // ── js-run-jsconfig-create ───────────────────────────────────────────────────
-  // Violation: «[packages/api] є каталог src/, але немає jsconfig.json»
-  // Fix: для кожного воркспейсу з violation створити канонічний jsconfig.json
-  // (NodeNext + include: src/**/*; шаблон: js-run/policy/jsconfig/template/)
-  {
-    id: 'js-run-jsconfig-create',
-    test: out => /є каталог src\/, але немає jsconfig\.json/.test(out),
-    apply: (out, cwd) => {
-      const RE = /\[([^\]]+)\] є каталог src\/, але немає jsconfig\.json/gu
-      const matches = [...out.matchAll(RE)]
-      if (matches.length === 0) return { ok: false, action: 'no match' }
-      const canonical =
-        JSON.stringify(
-          {
-            compilerOptions: {
-              lib: ['esnext'],
-              module: 'NodeNext',
-              moduleResolution: 'NodeNext',
-              target: 'esnext',
-              checkJs: false
-            },
-            include: ['src/**/*']
-          },
-          null,
-          2
-        ) + '\n'
-      const created = []
-      for (const m of matches) {
-        const ws = m[1]
-        const target = join(cwd, ws, 'jsconfig.json')
-        if (!existsSync(target)) {
-          writeFileSync(target, canonical, 'utf8')
-          created.push(ws)
-        }
-      }
-      if (created.length === 0) return { ok: false, action: 'jsconfig.json вже існує в усіх воркспейсах' }
-      return { ok: true, action: `створено jsconfig.json: ${created.join(', ')}` }
-    }
-  }
-]
+// Паттерни живуть у rule-level fix-*.mjs файлах; агрегуємо тут через discovery.
+// Top-level await: ініціалізація один раз при завантаженні модуля.
+const RULES_DIR = join(dirname(fileURLToPath(import.meta.url)), '../../../rules')
+const PATTERNS = await discoverT0Patterns(RULES_DIR)
 
 /**
  * Застосовує всі T0-auto паттерни до одного violation-output.
@@ -250,9 +26,7 @@ export async function applyT0Auto(ruleId, violationOutput, cwd) {
     // Патерн може бути sync ({ok,action}) або async (Promise) — await нормалізує обидва.
     const result = await p.apply(violationOutput, cwd)
     actions.push(`[${p.id}] ${result.action}`)
-    if (result.ok) {
-      applied = true
-    }
+    if (result.ok) applied = true
   }
 
   return { applied, actions }

package/scripts/lib/fix/vscode-ext-add.mjs

@@ -0,0 +1,45 @@
+/**
+ * Shared T0-autofix паттерн для правил із `vscode_extensions.rego`.
+ * Читає назву розширення з violation-message і додає його до
+ * `.vscode/extensions.json#recommendations`.
+ *
+ * Не прив'язаний до конкретного правила — один механізм для всіх правил,
+ * що емітують «recommendations має містити "…"».
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const REC_REQUIRE_RE = /recommendations має містити "[^"]+"/
+const REC_MATCH_ALL_RE = /recommendations має містити "([^"]+)"/g
+
+/** @type {import('./discover-t0-patterns.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'vscode-ext-add',
+    test: out => REC_REQUIRE_RE.test(out),
+    apply: (out, cwd) => {
+      const matches = [...out.matchAll(REC_MATCH_ALL_RE)]
+      if (matches.length === 0) return { ok: false, action: 'no match' }
+
+      const extPath = join(cwd, '.vscode/extensions.json')
+      if (!existsSync(extPath)) {
+        return { ok: false, action: '.vscode/extensions.json не знайдено' }
+      }
+
+      let parsed
+      try {
+        parsed = JSON.parse(readFileSync(extPath, 'utf8'))
+      } catch {
+        return { ok: false, action: '.vscode/extensions.json: невалідний JSON' }
+      }
+
+      const recs = Array.isArray(parsed.recommendations) ? parsed.recommendations : []
+      const toAdd = matches.map(m => m[1]).filter(e => !recs.includes(e))
+      if (toAdd.length === 0) return { ok: false, action: 'вже є' }
+
+      parsed.recommendations = [...recs, ...toAdd]
+      writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
+      return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
+    }
+  }
+]

package/rules/test/coverage/coverage.mjs

@@ -1,317 +0,0 @@
-/**
- * Канонічна команда `n-cursor coverage`: збирає метрики покриття + мутаційного
- * тестування з усіх провайдерів, чиє правило активне в `.n-cursor.json#rules`,
- * агрегує та записує COVERAGE.md у корінь проєкту.
- *
- * Discovery провайдерів — за `.n-cursor.json#rules`: для кожного `ruleId` зі
- * списку шукаємо `npm/rules/<ruleId>/coverage/coverage.mjs` і динамічно
- * імпортуємо. Якщо файлу немає — провайдер для цього правила відсутній (skip
- * silently, не помилка).
- *
- * Лок — прямий виклик `withLock('coverage', steps)`. Один CLI-консумер, один
- * callsite — спільна точка входу не виноситься (YAGNI, див. C4 у
- * specs/2026-05-24-coverage-rule-design.md).
- */
-import { existsSync } from 'node:fs'
-import { readFile, writeFile } from 'node:fs/promises'
-import { dirname, join } from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-
-import { applyVerdicts } from '../../../scripts/coverage-classify/apply.mjs'
-import { classify } from '../../../scripts/coverage-classify/index.mjs'
-import { collectChangedFilesSince, resolveChangedBase } from '../../../scripts/lib/changed-files.mjs'
-import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
-import { withLock } from '../../../scripts/utils/with-lock.mjs'
-
-/** Корінь `npm/rules/` — `<rules>/test/coverage` → `<rules>` */
-const RULES_DIR = dirname(dirname(dirname(fileURLToPath(import.meta.url))))
-
-/**
- * Сума двох coverage-totals.
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} a перший subtotal
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} b другий subtotal
- * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} сумарні lines/functions
- */
-export function addCoverage(a, b) {
-  return {
-    lines: { covered: a.lines.covered + b.lines.covered, total: a.lines.total + b.lines.total },
-    functions: {
-      covered: a.functions.covered + b.functions.covered,
-      total: a.functions.total + b.functions.total
-    }
-  }
-}
-
-/**
- * Сума двох mutation-counts.
- * @param {{caught:number,total:number}} a перший subtotal
- * @param {{caught:number,total:number}} b другий subtotal
- * @returns {{caught:number,total:number}} сумарні caught/total
- */
-export function addMutation(a, b) {
-  return { caught: a.caught + b.caught, total: a.total + b.total }
-}
-
-/**
- * Форматує covered/total як `XX.XX% (covered/total)`.
- * @param {{covered:number,total:number}} metric метрика lines або functions
- * @returns {string} відформатований рядок для таблиці COVERAGE.md
- */
-export function formatCoverage({ covered, total }) {
-  const percent = total === 0 ? '—' : `${((covered / total) * 100).toFixed(2)}%`
-  return `${percent} (${covered}/${total})`
-}
-
-/**
- * Форматує мутаційний score як `XX.XX%`.
- * @param {{caught:number,total:number}} metric агрегований mutation score
- * @returns {string} відформатований score або прочерк
- */
-export function formatScore({ caught, total }) {
-  return total === 0 ? '—' : `${((caught / total) * 100).toFixed(2)}%`
-}
-
-/**
- * Рендерить таблицю покриття + мутаційного тестування як Markdown.
- * Якщо будь-який рядок містить непустий `survived`, додає секцію
- * `## Вцілілі мутанти` з JSON-блоком для `/n-coverage-fix`.
- * Якщо `allowedGaps` непустий, додає секцію `## Allowed gaps` з таблицею
- * verdict/confidence/reason для кожного LLM-класифікованого мутанта.
- * Без timestamp, щоб git diff рухався лише при зміні метрик.
- * @param {Array<{area:string, coverage:{lines:{covered:number,total:number},functions:{covered:number,total:number}}, mutation:{caught:number,total:number}, survived?: Array<{file:string,line:number,col:number,mutantType:string,original:string,replacement:string}>}>} rows рядки провайдерів
- * @param {Array<{file:string, mutant:{line:number,col:number,mutantType:string,original:string,replacement:string}, verdict:{verdict:string,confidence:number,reason:string}}>} [allowedGaps] мутанти виключені класифікатором
- * @returns {string} Markdown з заголовком `# Coverage`
- */
-export function renderMarkdown(rows, allowedGaps = []) {
-  const lines = [
-    '# Coverage',
-    '',
-    '| Область | Рядки | Функції | Вбито мутацій | Score |',
-    '| --- | --- | --- | --- | --- |'
-  ]
-  for (const row of rows) {
-    lines.push(
-      `| ${row.area} | ${formatCoverage(row.coverage.lines)} | ${formatCoverage(row.coverage.functions)} | ` +
-        `${row.mutation.caught}/${row.mutation.total} | ${formatScore(row.mutation)} |`
-    )
-  }
-
-  const allSurvived = rows.flatMap(r => r.survived ?? [])
-  if (allSurvived.length > 0) {
-    lines.push('', '## Вцілілі мутанти', '', '```json', JSON.stringify(allSurvived, null, 2), '```')
-    // Зрозуміла для людини таблиця
-    for (const group of allSurvived) {
-      lines.push('', `### ${group.file}`, '', '| Рядок | Оригінал | Заміна | Тип |', '| --- | --- | --- | --- |')
-      for (const m of group.mutants) {
-        lines.push(`| ${m.line} | \`${m.original}\` | \`${m.replacement}\` | ${m.mutantType} |`)
-      }
-      if (group.exampleTest) {
-        lines.push(
-          '',
-          `**Приклад тесту** (\`${group.exampleTest.testFile}\`):`,
-          '',
-          '```js',
-          group.exampleTest.code ?? '',
-          '```'
-        )
-      }
-      if (group.recommendationText) {
-        lines.push('', '**Що треба протестувати:**', '', group.recommendationText)
-      }
-    }
-  }
-
-  if (allowedGaps.length > 0) {
-    // Group allowed gaps by file
-    const gapsByFile = new Map()
-    for (const gap of allowedGaps) {
-      if (!gapsByFile.has(gap.file)) gapsByFile.set(gap.file, [])
-      gapsByFile.get(gap.file).push(gap)
-    }
-
-    lines.push(
-      '',
-      '## Allowed gaps',
-      '',
-      `> LLM-класифікатор виключив ${allowedGaps.length} survived мутант(ів) зі знаменника mutation score.`,
-      '> Категорії: equivalent (поведінково еквівалентний), defensive (impossible state), glue/wrapper (integration test покриває).'
-    )
-
-    for (const [file, gaps] of gapsByFile) {
-      lines.push(
-        '',
-        `### ${file}`,
-        '',
-        '| Line | Mutant | Verdict | Confidence | Reason |',
-        '| --- | --- | --- | --- | --- |'
-      )
-      for (const { mutant, verdict } of gaps) {
-        const sanitizedReason = verdict.reason.replaceAll('|', String.raw`\|`).replaceAll('\n', ' ')
-        lines.push(
-          `| ${mutant.line} | \`${mutant.original}\` → \`${mutant.replacement}\` | ${verdict.verdict} | ${verdict.confidence.toFixed(2)} | ${sanitizedReason} |`
-        )
-      }
-    }
-  }
-
-  return `${lines.join('\n')}\n`
-}
-
-/**
- * Завантажує provider-модуль з `<rulesDir>/<ruleId>/coverage/coverage.mjs`.
- * Повертає null коли:
- *   - файлу немає (rule без coverage-провайдера),
- *   - файл існує, але не експортує `detect` + `collect` як функції (наприклад,
- *     `rules/test/coverage/coverage.mjs` — сам оркестратор, не провайдер).
- * @param {string} rulesDir корінь `npm/rules/`
- * @param {string} ruleId id правила з `.n-cursor.json#rules`
- * @returns {Promise<{detect:(cwd:string)=>Promise<boolean>, collect:(cwd:string)=>Promise<Array<object>>}|null>} provider-модуль або null
- */
-async function loadProvider(rulesDir, ruleId) {
-  const providerPath = join(rulesDir, ruleId, 'coverage', 'coverage.mjs')
-  if (!existsSync(providerPath)) return null
-  const mod = await import(pathToFileURL(providerPath).href)
-  if (typeof mod.detect !== 'function' || typeof mod.collect !== 'function') return null
-  return mod
-}
-
-/**
- * Будує підсумковий рядок «Разом» через сумування всіх coverage/mutation.
- * @param {Array<{area:string, coverage:object, mutation:object}>} rows рядки провайдерів без totals
- * @returns {{area:string, coverage:object, mutation:{caught:number,total:number}}} агрегований рядок «Разом»
- */
-function buildTotalsRow(rows) {
-  let totalCoverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
-  let totalMutation = { caught: 0, total: 0 }
-  for (const row of rows) {
-    totalCoverage = addCoverage(totalCoverage, row.coverage)
-    totalMutation = addMutation(totalMutation, row.mutation)
-  }
-  return { area: '**Разом**', coverage: totalCoverage, mutation: totalMutation }
-}
-
-/**
- * Читає `.n-cursor.json#coverage.classifyConfidenceThreshold` (default 1.1 — rollout mode).
- * @param {string} cwd корінь проєкту
- * @returns {Promise<number>} threshold у [0, 1.1]
- */
-async function readClassifyThreshold(cwd) {
-  try {
-    const raw = await readFile(join(cwd, '.n-cursor.json'), 'utf8')
-    const parsed = JSON.parse(raw)
-    const t = parsed?.coverage?.classifyConfidenceThreshold
-    return typeof t === 'number' && Number.isFinite(t) ? t : 1.1
-  } catch {
-    return 1.1
-  }
-}
-
-/**
- * Резолвить scope змінених файлів для `--changed`-режиму.
- *
- * Base — git merge-base поточної гілки з `main` або `origin/main`.
- * `git diff <base>` проти робочого дерева ловить committed і uncommitted однаково,
- * тож scope не залежить від того, чи крок уже закомічено.
- * @param {string} cwd корінь проєкту
- * @returns {{base: string|null, files: string[]}} base-ref і relative-posix список змінених файлів
- */
-export function resolveChangedScope(cwd) {
-  const base = resolveChangedBase(cwd)
-  return { base, files: collectChangedFilesSince(base, cwd) }
-}
-
-/**
- * Виконує coverage-pipeline: discovery провайдерів за `.n-cursor.json#rules`,
- * detect+collect для кожного, агрегація, запис COVERAGE.md.
- * При `opts.fix === true` після запису COVERAGE.md запускає агента (coverage-fix.mjs)
- * для написання тестів по вцілілих мутантах.
- * При `opts.changed === true` провайдери звужують scope до змінених від base файлів
- * для швидкого gate. Порожній scope (нема релевантних змін) — це pass (exit 0)
- * без перезапису наявного COVERAGE.md, а НЕ помилка «жодного провайдера».
- * @param {{cwd?:string, rulesDir?:string, fix?:boolean, changed?:boolean}} [opts] ін'єкція cwd/rulesDir для тестів; fix — --fix режим; changed — scope лише змінених
- * @returns {Promise<number>} exit code (0 OK, 1 коли жоден провайдер не дав даних у full-режимі)
- */
-export async function runCoverageSteps(opts = {}) {
-  const cwd = opts.cwd ?? process.cwd()
-  const rulesDir = opts.rulesDir ?? RULES_DIR
-  const config = await readNCursorConfigLite(cwd)
-  const scope = opts.changed ? resolveChangedScope(cwd) : null
-  const collectOpts = scope ? { changedFiles: scope.files, base: scope.base } : {}
-  const rows = []
-
-  for (const ruleId of config.rules) {
-    if (config.disableRules.includes(ruleId)) continue
-    const provider = await loadProvider(rulesDir, ruleId)
-    if (!provider) continue
-    if (!(await provider.detect(cwd))) continue
-    console.log(`→ ${ruleId} coverage…`)
-    rows.push(...(await provider.collect(cwd, collectOpts)))
-  }
-
-  if (rows.length === 0) {
-    // --changed: порожній scope = «нема релевантних змін» → pass, не чіпаємо COVERAGE.md.
-    if (opts.changed) {
-      console.log('✓ coverage --changed: немає змінених файлів у scope провайдерів — пропускаю')
-      return 0
-    }
-    console.error('✗ Жодного провайдера покриття не знайдено для активних правил у .n-cursor.json#rules')
-    return 1
-  }
-
-  // --changed (турнікет): рішення гейту визначає лише exit-код — vitest/Stryker кинули б помилку
-  // під час collect, якби тести/прогін упали. Тут НЕ перезаписуємо повний COVERAGE.md частковим
-  // scoped-звітом і не ганяємо LLM-класифікацію (зайвий кошт у per-step циклі).
-  if (opts.changed) {
-    console.log('✓ coverage --changed: змінені файли перевірено')
-    return 0
-  }
-
-  // LLM-класифікація survived мутантів (graceful skip без API key)
-  const allSurvived = rows.flatMap(r => r.survived ?? [])
-  let augmentedRows = rows
-  let allowedGaps = []
-  if (allSurvived.length > 0) {
-    const verdicts = await classify(allSurvived, cwd)
-    if (verdicts.length > 0) {
-      const threshold = await readClassifyThreshold(cwd)
-      const applied = applyVerdicts(rows, verdicts, threshold)
-      augmentedRows = applied.rows
-      allowedGaps = applied.allowedGaps
-    }
-  }
-
-  // Підсумок «Разом» має сенс лише коли провайдерів ≥2; для єдиного рядка він
-  // дублює його значення, тож не додаємо.
-  if (augmentedRows.filter(r => r.area !== '**Разом**').length > 1) {
-    augmentedRows.push(buildTotalsRow(augmentedRows.filter(r => r.area !== '**Разом**')))
-  }
-  const md = renderMarkdown(augmentedRows, allowedGaps)
-  // Stryker disable next-line StringLiteral: equivalent – writeFile(path, str, '') behaves identically to 'utf8' in Node/Bun
-  await writeFile(join(cwd, 'COVERAGE.md'), md, 'utf8')
-  console.log('✓ COVERAGE.md')
-
-  if (opts.fix) {
-    const { fixSurvivedMutants } = await import(new URL('../../../scripts/coverage-fix.mjs', import.meta.url).href)
-    await fixSurvivedMutants(allSurvived, cwd)
-  }
-
-  return 0
-}
-
-/**
- * CLI entrypoint для `n-cursor coverage [--fix] [--changed]`.
- * Із `--fix`: збирає метрики → запускає агента → повторно збирає метрики.
- * Без `--fix`: лише збирає метрики.
- * Із `--changed`: звужує scope до змінених від git merge-base файлів.
- * Лок охоплює кожен coverage-прогін окремо.
- * @param {{fix?:boolean, changed?:boolean}} [opts] прапори --fix / --changed
- * @returns {Promise<number>} exit code
- */
-export async function runCoverageCli(opts = {}) {
-  const code = await withLock('coverage', () => runCoverageSteps(opts))
-  if (code === 0 && opts.fix) {
-    console.log('\n♻️  Повторний coverage після агента…\n')
-    return withLock('coverage', () => runCoverageSteps({ fix: false, changed: opts.changed }))
-  }
-  return code
-}