@7n/rules 1.0.0

package/rules/test/cargo_mutants_config/docs/fix-cargo_mutants_config.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-cargo_mutants_config.mjs
+resource: npm/rules/test/cargo_mutants_config/fix-cargo_mutants_config.mjs
+docgen:
+  crc: cf485f41
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min-retry
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Для виконання завдання мені потрібен **код або контекст** файлу `test/cargo_mutants_config`, щоб я міг переписати секцію "Overview" відповідно до наданих "ВІДОМИХ ФАКТІВ" та уникнути помилок із "ЧЕРНЕТКОЮ".
+
+## Поведінка
+
+1. Перевіряє, чи не виявлено порушення, пов'язане з відсутністю конфігураційного файлу для мутантів у Cargo-проекті.
+2. Якщо конфігураційний файл не існує в каталозі з резервною копією, виконується наступне:
+3. Збираються шляхи до всіх Cargo-маніфестів у робочому каталозі.
+4. Для кожного знайденого Cargo-маніфеста визначається цільовий шлях до файлу `mutants.toml`.
+5. Якщо цільовий файл не існує, система позначає його для запису.
+6. Створюється директорія, якщо вона відсутня.
+7. З резервної копії копіюється вміст конфігураційного файлу до цільового шляху.
+8. Якщо жоден файл не було створено, операція завершується без змін.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/cargo_mutants_config/docs/index.md

@@ -0,0 +1,12 @@
+---
+type: Directory Index
+title: npm/rules/test/cargo_mutants_config
+resource: npm/rules/test/cargo_mutants_config/
+---
+
+# npm/rules/test/cargo_mutants_config
+
+| Файл                                                        | Тип       |
+| ----------------------------------------------------------- | --------- |
+| [fix-cargo_mutants_config.mjs](fix-cargo_mutants_config.md) | JS Module |
+| [main.mjs](main.md)                                         | JS Module |

package/rules/test/cargo_mutants_config/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/test/cargo_mutants_config/main.mjs
+docgen:
+  crc: 817124cc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 95
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд: Файл перевіряє конфігурацію проекту, зокрема налаштування для мови Rust. Він забезпечує, що у директоріях, що містять файли маніфестів Cargo, існує файл `mutants.toml`, копіюючи базовий файл, якщо він відсутній.
+
+Поведінка:
+
+1. Перевіряється, чи активована логіка для мови Rust.
+2. Ідентифікуються всі файли маніфестів Cargo.
+3. Перевіряється наявність базового файлу `mutants.toml.baseline`.
+4. Для кожного знайденого файлу маніфесту Cargo, якщо файл `.cargo/mutants.toml` відсутній, він створюється, копіюючи вміст базового файлу. **[test.mdc]**
+5. Процес завершується з кодом 0, якщо всі перевірки виконані або відповідні файли не виявлені/немає порушень; з кодом 1 у разі виявлення порушень.
+
+## Поведінка
+
+Поведінка:
+
+1. Перевіряється, увімкнено чи ні правило для мови Rust.
+2. З'ясовуються всі файли маніфестів Cargo.
+3. Перевіряється наявність канонічного базового файлу `mutants.toml.baseline`.
+4. Для кожного знайденого файлу маніфесту Cargo, якщо файл `.cargo/mutants.toml` відсутній, він створюється, копіюючи вміст базового файлу.
+5. Процес завершується з кодом 0, якщо всі перевірки пройдені або якщо відповідні файли не знайдено/немає порушень; з кодом 1 у разі виявлення порушень.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/cargo_mutants_config/fix-cargo_mutants_config.mjs

@@ -0,0 +1,49 @@
+/**
+ * T0-autofix для `test/cargo_mutants_config` — детерміноване створення
+ * `<cargoDir>/.cargo/mutants.toml` з canonical neutral baseline там, де його ще
+ * немає. Логіку перенесено з detector-а (read-only contract: detector лише звітує
+ * `mutants-config-missing`, запис — тут).
+ *
+ * Unified lint surface: structured violations (test(violations)/apply(violations,ctx)).
+ * Цільові каталоги резолвимо повторним скануванням Cargo-маніфестів від `ctx.cwd`
+ * (idempotent: existing target пропускаємо → touchedFiles лишається порожнім).
+ */
+import { existsSync } from 'node:fs'
+import { copyFile, mkdir } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { resolveAllCargoManifests } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
+
+import { MUTANTS_CONFIG_MISSING } from './main.mjs'
+
+const BASELINE_PATH = join(
+  dirname(fileURLToPath(import.meta.url)),
+  'data',
+  'cargo_mutants_config',
+  'mutants.toml.baseline'
+)
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'test-cargo-mutants-config-create',
+    test: violations => violations.some(v => v.reason === MUTANTS_CONFIG_MISSING),
+    apply: async (violations, ctx) => {
+      if (!existsSync(BASELINE_PATH)) return { touchedFiles: [] }
+      const cwd = ctx.cwd
+      const manifests = await resolveAllCargoManifests(cwd)
+      const touchedFiles = []
+      for (const manifestPath of manifests) {
+        const target = join(dirname(manifestPath), '.cargo', 'mutants.toml')
+        if (existsSync(target)) continue
+        ctx.recordWrite?.(target)
+        await mkdir(dirname(target), { recursive: true })
+        await copyFile(BASELINE_PATH, target)
+        touchedFiles.push(target)
+      }
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `створено .cargo/mutants.toml: ${touchedFiles.join(', ')}` }
+    }
+  }
+]

package/rules/test/cargo_mutants_config/main.mjs

@@ -0,0 +1,62 @@
+/**
+ * @see ./docs/cargo_mutants_config.md
+ *
+ * Read-only detector: лише ЗВІТУЄ про відсутній `<cargoDir>/.cargo/mutants.toml`.
+ * Створення canonical baseline — окремий T0-fix (`fix-cargo_mutants_config.mjs`),
+ * не в detector-і (`lint --no-fix` ніколи не мутує дерево).
+ */
+import { existsSync } from 'node:fs'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { readNRulesConfigLite } from '../../../scripts/lib/read-n-rules-config-lite.mjs'
+import { resolveAllCargoManifests } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const BASELINE_PATH = join(HERE, 'data', 'cargo_mutants_config', 'mutants.toml.baseline')
+
+/** Стабільний reason для відсутнього `.cargo/mutants.toml` (T0 матчиться за ним). */
+export const MUTANTS_CONFIG_MISSING = 'mutants-config-missing'
+
+/**
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx Контекст лінту (cwd, перелік файлів тощо).
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} Результат лінту з переліком порушень.
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const cwd = ctx.cwd
+  const config = await readNRulesConfigLite(cwd)
+
+  // Self-gate: rust має бути enabled
+  if (!config.rules.includes('rust') || config.disableRules.includes('rust')) {
+    return reporter.result()
+  }
+
+  const manifests = await resolveAllCargoManifests(cwd)
+  if (manifests.length === 0) {
+    // rust enabled, але Cargo.toml ще немає — silently skip (manifest може з'явитися пізніше)
+    return reporter.result()
+  }
+
+  if (!existsSync(BASELINE_PATH)) {
+    reporter.fail(`.cargo/mutants.toml canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @7n/rules`)
+    return reporter.result()
+  }
+
+  for (const manifestPath of manifests) {
+    const cargoDir = dirname(manifestPath)
+    const target = join(cargoDir, '.cargo', 'mutants.toml')
+
+    if (existsSync(target)) {
+      reporter.pass(`.cargo/mutants.toml існує (${relative(cwd, target)})`)
+      continue
+    }
+
+    reporter.fail(
+      `.cargo/mutants.toml відсутній (${relative(cwd, target)}) — запусти \`npx @7n/rules lint test\` для генерації canonical baseline (test.mdc)`,
+      { reason: MUTANTS_CONFIG_MISSING, file: relative(cwd, target) }
+    )
+  }
+  return reporter.result()
+}

package/rules/test/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test
+resource: npm/rules/test/
+---
+
+# npm/rules/test
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/test/location/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "structural",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/*.test.mjs"]
+  }
+}

package/rules/test/location/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/test/location
+resource: npm/rules/test/location/
+---
+
+# npm/rules/test/location
+
+| Файл                | Тип       |
+| ------------------- | --------- |
+| [main.mjs](main.md) | JS Module |

package/rules/test/location/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/test/location/main.mjs
+docgen:
+  crc: 6906cc92
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд
+Файл гарантує відповідність усіх тестових файлів встановленому розташуванню. Він сканує репозиторій, щоб підтвердити, що всі файли з розширенням `*.test.mjs` знаходяться у директорії `tests`.
+
+Поведінка
+Запускає `main` для перевірки коректності розташування всіх тестових файлів (`*.test.mjs`). Сканує репозиторій, ігноруючи директорії, визначені у конфігурації. Для кожного тестового файлу перевіряє його наявність у каталозі `tests`. Якщо тест виявлено поза директорією `tests`, фіксується його повний відносний шлях. У випадку відсутності порушень, інформується, що всі тестові файли розташовані коректно (test.mdc). Якщо виявлено порушення, для кожного файлу, що не відповідає правилам (test.mdc), повідомляється його шлях та необхідність переміщення до відповідної піддиректорії `tests`.
+
+## Поведінка
+
+1. Запускає `main` для перевірки розташування всіх тестових файлів з розширенням `*.test.mjs`.
+2. Сканує репозиторій, ігноруючи директорії, вказані в конфігурації.
+3. Для кожного знайденого тестового файлу перевіряє, чи він знаходиться в каталозі з назвою `tests`.
+4. Якщо тест знайдено поза директорією `tests`, фіксує його повний відносний шлях.
+5. Якщо порушень немає, повідомляє, що всі тестові файли розташовані коректно (test.mdc).
+6. Якщо порушення виявлено, для кожного файлу, що порушує правила (test.mdc), повідомляє шлях та вказує, що тест має бути переміщено до відповідної піддиректорії `tests`.
+
+## Публічний API
+
+- main — Встановлює, чи знаходяться файли, призначені для тестування, у відповідному каталозі `tests/` (test.mdc).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/location/location.mdc

@@ -0,0 +1,52 @@
+## Розміщення тестових файлів у каталозі `tests/`
+
+JS-тести у пакеті лежать у **піддиректорії `tests/`** поряд із кодом, який тестується, а **не безпосередньо біля джерельного файлу**.
+
+```
+rules/foo/js/bar/
+├── check.mjs               ← JS-джерело
+└── tests/
+    └── check.test.mjs      ← тест check.mjs
+```
+
+**Чому так:**
+
+- Каталог-з-кодом залишається чистим: продакшен-модулі, политики, темплейти не миготять серед тестових файлів.
+- Один погляд на дерево показує, що піде у npm tarball (все, крім `tests/` і `__fixtures__/` — їх ловить `package.json#files` через негативні globs).
+- Якщо тест переростає у мульти-файловий — він уже у власному каталозі, без хаотичного розкидання.
+
+**Виняток — Rego unit-тести (`*_test.rego`):** лишаються **поряд із полісі-файлом** відповідно до загальноприйнятого OPA/Conftest community-патерну. `conftest verify -p <dir>` рекурсивно підхоплює їх незалежно від місця в каталозі.
+
+```
+rules/foo/policy/package_json/
+├── package_json.rego       ← Rego-правило
+├── package_json_test.rego  ← Rego unit-тести (поряд, не у tests/)
+└── target.json
+```
+
+**Спеціальні випадки:**
+
+- **Integration-тести на рівні пакета** — у `<root>/tests/` (наприклад `npm/tests/`). Це не «біля файлу», а виокремлений каталог для тестів, що покривають весь пакет.
+- **Fixtures**: `__fixtures__/` (для shared) і `fixtures/` (для rule-specific) також живуть **усередині `tests/`**: `tests/__fixtures__/...` і `tests/fixtures/...`.
+- **Test helpers** (`test-helpers.mjs`) можуть лишатися у `scripts/utils/` як shared infra — конвенція стосується файлів `*.test.mjs`.
+
+**Гарантії tarball-чистоти** через `package.json#files`:
+
+```json
+"files": [
+  "...",
+  "!**/*.test.mjs",
+  "!**/*_test.rego",
+  "!**/__fixtures__/**",
+  "!**/fixtures/**",
+  "!**/test-helpers.mjs"
+]
+```
+
+Recursive globs ловлять файли всередині `tests/` так само, як ловили б їх біля джерела.
+
+`npx @7n/rules fix test` (concern `location`) проходить деревом пакета й перевіряє: **кожен `*.test.mjs` файл лежить усередині каталогу з ім'ям `tests`** (точне співпадіння басенейму батьківської директорії). Файли поза цим каталогом репортуються з порадою куди їх перенести.
+
+`*_test.rego` перевіркою **не охоплюються** — вони не переміщуються.
+
+Пропускаються: `node_modules`, `.git`, `dist`, `build`, `.venv`, `venv`, шляхи з `.n-rules.json:ignore`.

package/rules/test/location/main.mjs

@@ -0,0 +1,70 @@
+/** @see ./docs/location.md */
+import { basename, dirname, relative } from 'node:path'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
+import { walkDir } from '../../../scripts/utils/walkDir.mjs'
+
+const TESTS_DIR_NAME = 'tests'
+
+/**
+ * Чи файл є JS-тестом (`*.test.mjs`).
+ * @param {string} absPath абсолютний шлях
+ * @returns {boolean} true для шляхів із суфіксом `.test.mjs`
+ */
+function isTestFile(absPath) {
+  return basename(absPath).endsWith('.test.mjs')
+}
+
+/**
+ * Перевіряє, чи лежить тест у каталозі з іменем `tests`.
+ * @param {string} absPath абсолютний шлях до тесту
+ * @returns {boolean} `true`, якщо басенейм батьківської директорії — `tests`
+ */
+function isInsideTestsDir(absPath) {
+  return basename(dirname(absPath)) === TESTS_DIR_NAME
+}
+
+/**
+ * Перевіряє розміщення тестових файлів у каталозі `tests/` (test.mdc).
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки
+ */
+export async function lint(ctx) {
+  const reporter = createViolationReporter(ctx)
+  const { pass, fail } = reporter
+
+  const cwd = ctx.cwd
+  const ignorePaths = await loadCursorIgnorePaths(cwd)
+
+  /** @type {string[]} */
+  const offenders = []
+  let totalTests = 0
+
+  await walkDir(
+    cwd,
+    absPath => {
+      if (!isTestFile(absPath)) {
+        return
+      }
+      totalTests++
+      if (!isInsideTestsDir(absPath)) {
+        offenders.push(relative(cwd, absPath))
+      }
+    },
+    ignorePaths
+  )
+
+  if (offenders.length === 0) {
+    pass(`Всі ${totalTests} файлів *.test.mjs у каталозі tests/ (test.mdc)`)
+    return reporter.result()
+  }
+
+  for (const offenderPath of offenders) {
+    const parentDir = dirname(offenderPath)
+    const base = basename(offenderPath)
+    fail(`${offenderPath}: тест має лежати у tests/ — перенеси у ${parentDir}/${TESTS_DIR_NAME}/${base} (test.mdc)`)
+  }
+
+  return reporter.result()
+}

package/rules/test/main.json

@@ -0,0 +1 @@
+{ "auto": "завжди" }

package/rules/test/main.mdc

@@ -0,0 +1,26 @@
+---
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.mjs (якщо js enabled) і .cargo/mutants.toml (якщо rust enabled).
+version: '2.8'
+globs: "**/{.n-rules.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
+alwaysApply: false
+---
+
+Правило **test** керує розміщенням тестових файлів, безпекою ізоляції тестів (заборона `process.chdir`, відносних шляхів у FS, ручного store/restore console), налаштуванням Vitest/Stryker baseline та конфігурацією cargo-mutants для Rust.
+
+## Покриття + мутаційне тестування
+
+Канонічна команда — `npx @7n/test coverage` (пакет `@7n/test`, **не** `@7n/rules` — цей пакет лише постачає providers, оркестратор живе окремо): збирає метрики покриття (`vitest run --coverage`, `cargo llvm-cov` тощо) і мутаційного тестування (Stryker з vitest-runner + `coverageAnalysis: 'perTest'`, `cargo-mutants`) з усіх активних провайдерів у `.n-rules.json#rules` і пише `COVERAGE.md` у корінь проєкту.
+
+**Scoped-режим `--changed`:** `npx @7n/test coverage --changed` звужує scope до файлів, змінених від git merge-base поточної гілки з `main` або `origin/main`. У changed-режимі `COVERAGE.md` **не** перезаписується і LLM-класифікація не запускається.
+
+**`--fix`:** `npx @7n/test coverage --fix` — після збору метрик агент виправляє survived-мутанти й повторює coverage.
+
+Провайдери живуть у `npm/rules/<rule>/coverage/coverage.mjs` (цей пакет, `@7n/rules`). Оркестратор — у `@7n/test` (`npm/src/coverage/coverage.mjs`), який резолвить providers з `node_modules/@7n/rules/rules`. Проєкт-споживач має мати `@7n/test` як devDependency, аби `npx @7n/test coverage` резолвився без мережевого fetch щоразу.
+
+У `package.json` (корінь) має бути `scripts.coverage` із викликом `npx @7n/test coverage`.
+
+### Multi-workspace iteration
+
+У monorepo `@7n/test coverage` ітерує усі workspaces з власним `package.json` і агрегує метрики lcov + Stryker у єдиний `JS`-рядок `COVERAGE.md`. Workspace без тестів пропускається без помилки.
+
+- [package.json.contains.json](./package_json/template/package.json.contains.json)

package/rules/test/no-bun-test-import/concern.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/*.test.mjs", "**/*.test.js"]
+  }
+}

package/rules/test/no-bun-test-import/docs/fix-no-bun-test-import.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: fix-no-bun-test-import.mjs
+resource: npm/rules/test/no-bun-test-import/fix-no-bun-test-import.mjs
+docgen:
+  crc: a2204707
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей файл забезпечує автоматичне виправлення імпортів у контексті `test/no-bun-test-import`. Він сканує файли та замінює декларації імпорту з `bun:test` на їхні еквіваленти з `vitest` (такі як `describe`, `test`, `it`, `expect`, `beforeEach`, `beforeAll`, `afterEach`, `afterAll`). Мета полягає в уніфікації тестового середовища за допомогою `vitest`. Зауважте, що імпорти, які містять `mock`, `spyOn` або `jest`, не підлягають автоматичній заміні, оскільки вони вимагають ручного коригування місць виклику API (`vi.fn`/`vi.spyOn`).
+
+## Поведінка
+
+Поведінка:
+1. Ініціалізувати процес автофіксу для виявлених порушень, пов'язаних із використанням `bun-test-import`.
+2. Ітеративно обробити кожен файл, у якому виявлено такі порушення.
+3. Для кожного файлу прочитати його вміст.
+4. Виявити імпорти з `bun:test`, які можуть бути замінені на еквівалент у `vitest`.
+5. Замінити ці імпорти з кінця файлу до початку, щоб уникнути зсуву позицій наступних матчів.
+6. Записати змінений вміст назад у файл.
+7. Після обробки всіх файлів повернути перелік змінених файлів та повідомлення про застосовані зміни.
+8. Використовувати наданий об'єкт `patterns` для визначення логіки обробки.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/rules/test/no-bun-test-import/docs/index.md

@@ -0,0 +1,10 @@
+---
+type: Directory Index
+title: npm/rules/test/no-bun-test-import
+resource: npm/rules/test/no-bun-test-import/
+---
+
+| Файл                                                    | Тип       |
+| ------------------------------------------------------- | --------- |
+| [fix-no-bun-test-import.mjs](fix-no-bun-test-import.md) | JS Module |
+| [main.mjs](main.md)                                     | JS Module |

package/rules/test/no-bun-test-import/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/test/no-bun-test-import/main.mjs
+docgen:
+  crc: a74d8bc5
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min-retry
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Огляд
+Цей компонент аналізує тестові файли проекту для модернізації тестового фреймворку. Він ідентифікує імпорти з `bun:test` та перевіряє їхню сумісність для потенційного переходу на `vitest`, згенерувавши відповідні порушення для виправлення.
+
+Поведінка
+findBunTestImports виявляє імпорти з `bun:test` у коді, визначаючи, які з них можуть бути безпечно замінені на `vitest`.
+lint перевіряє тестові файли на наявність імпортів з `bun:test`, генеруючи порушення, якщо імпорт не може бути автоматично виправлений (test.mdc).
+
+## Поведінка
+
+Поведінка
+findBunTestImports знаходить усі імпорти з `bun:test` у коді, визначаючи, які з них можуть бути безпечно замінені на `vitest`.
+lint перевіряє тестові файли на наявність імпортів з `bun:test`, генеруючи порушення, якщо імпорт не може бути автоматично виправлений (test.mdc).
+
+## Публічний API
+
+findBunTestImports — шукає усі імпорти з `bun:test` у коді файлу, щоб уникнути повторного аналізу.
+lint — гарантує, що тестові файли не імпортують модулі з `bun:test`, оскільки Vitest не може їх знайти.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/test/no-bun-test-import/fix-no-bun-test-import.mjs

@@ -0,0 +1,51 @@
+/**
+ * T0-autofix для `test/no-bun-test-import`: переписує `from 'bun:test'` на
+ * `from 'vitest'` у import-декларацій, чиї специфікатори мають прямий 1:1
+ * еквівалент у vitest (describe/test/it/expect/beforeEach/beforeAll/afterEach/afterAll). Import-и з
+ * mock/spyOn/jest тощо НЕ чіпаються — там потрібне ручне виправлення call-sites
+ * (`vi.fn`/`vi.spyOn` мають інший API за межами самого import), детектор лишає
+ * їх як violation для ручного/LLM-ladder фіксу.
+ */
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { findBunTestImports } from './main.mjs'
+
+const QUOTED_BUN_TEST_RE = /(['"])bun:test\1/u
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'rewrite-bun-test-import-to-vitest',
+    test: violations => violations.some(v => v.reason === 'bun-test-import' && v.data?.fixable),
+    apply: async (violations, ctx) => {
+      const files = [
+        ...new Set(violations.filter(v => v.reason === 'bun-test-import' && v.data?.fixable).map(v => v.file))
+      ]
+
+      const touchedFiles = []
+      for (const file of files) {
+        const absPath = join(ctx.cwd, file)
+        const content = await readFile(absPath, 'utf8')
+        const found = findBunTestImports(content)
+        if (found.length === 0) continue
+
+        let next = content
+        // Заміняємо з кінця файлу до початку, щоб офсети попередніх матчів не зсувались.
+        for (const imp of found.toReversed()) {
+          if (!imp.fixable) continue
+          const rewritten = imp.raw.replace(QUOTED_BUN_TEST_RE, (_match, quote) => `${quote}vitest${quote}`)
+          next = next.slice(0, imp.start) + rewritten + next.slice(imp.end)
+        }
+        if (next === content) continue
+
+        ctx.recordWrite?.(absPath)
+        await writeFile(absPath, next, 'utf8')
+        touchedFiles.push(absPath)
+      }
+
+      if (touchedFiles.length === 0) return { touchedFiles: [] }
+      return { touchedFiles, message: `bun:test → vitest: ${touchedFiles.join(', ')}` }
+    }
+  }
+]