@7n/rules 1.31.0 → 1.32.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.32.0] - 2026-07-19
+
+### Changed
+
+- lint: правило test переїхало у @7n/rules-lang-js (vitest/stryker/ізоляція тестів), а концерн cargo_mutants_config — у правило rust плагіна @7n/rules-lang-rust (семантично канон rust-тулчейну; активація за glob Cargo.toml, у rust-only репо працює без lang-js) — у ядрі 23 правила, мовних правил не лишилось
+
 ## [1.31.0] - 2026-07-19
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.31.0",
+  "version": "1.32.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/rules/{test → k8s/dremio_logging}/docs/index.md

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

package/rules/k8s/dremio_logging/docs/main.md

@@ -0,0 +1,31 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/k8s/dremio_logging/main.mjs
+docgen:
+  crc: a89abb0a
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 95
+  issues: anchor-miss:(k8s.mdc),judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`zkLogbackRootLevelViolation` перевіряє повідомлення, пов’язані з надто гучним `root` у `k8s.mdc`, а `lint` збирає ці перевірки в один pass і повертає результат без зупинки процесу. Поведінка read-only: правило не пише у ФС чи БД, працює fail-safe й не кидає винятків назовні.
+
+## Поведінка
+
+- `zkLogbackRootLevelViolation` — перевіряє, чи вбудований `logback.xml` у ZooKeeper-templated файлі не тримає `root` на надто гучному рівні; повертає текст порушення з міткою `` або `null`, якщо перевірка не потрібна або рівень уже прийнятний.
+- `lint` — проходить по вказаних файлах у read-only режимі, збирає порушення для `k8s.dremio_logging` і не виводить помилки назовні; пропускає файли, які не вдалося прочитати, та позначає знайдені проблеми міткою ``.
+
+## Публічний API
+
+- zkLogbackRootLevelViolation — позначає ZooKeeper Helm-темплейт, якщо вбудований `logback.xml` має занадто гучний `root`-рівень (`info`, `debug`, `trace`) або взагалі не задає `root`; не чіпає файли, де `root` уже `warn`, `error` чи `off`.
+- lint — запускає `k8s.dremio_logging` для ZooKeeper-темплейтів у межах одного файлу, лише для читання.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/skills/taze/js/docs/index.md

@@ -4,9 +4,7 @@ title: npm/skills/taze/js
 resource: npm/skills/taze/js/
 ---
 
-| Файл                                  | Тип       |
-| ------------------------------------- | --------- |
-| [cargo-diff.mjs](cargo-diff.md)       | JS Module |
-| [diff.mjs](diff.md)                   | JS Module |
-| [orchestrate.mjs](orchestrate.md)     | JS Module |
-| [rust-provider.mjs](rust-provider.md) | JS Module |
+| Файл                                      | Тип       |
+| ----------------------------------------- | --------- |
+| [migration-cache.mjs](migration-cache.md) | JS Module |
+| [orchestrate.mjs](orchestrate.md)         | JS Module |

package/skills/taze/js/docs/migration-cache.md

@@ -0,0 +1,38 @@
+---
+type: JS Module
+title: migration-cache.mjs
+resource: npm/skills/taze/js/migration-cache.mjs
+docgen:
+  crc: 5f264929
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Модуль надає `DEFAULT_CACHE_DIR`, `migrationCacheKey`, `readMigrationCache`, `writeMigrationCache` і `withKnownMigrationNotes` для роботи з локальним кешем відомих результатів аналізу міграцій у межах прогону. Він зберігає та повторно читає вже відомі записи, а `withKnownMigrationNotes` підставляє їх у промпт, щоб не повторювати дослідження там, де результат уже є. Модуль fail-safe: не кидає винятків назовні й за окремих помилок повертає порожнє значення, зокрема `null`.
+
+## Поведінка
+
+- `DEFAULT_CACHE_DIR` — стандартний спільний каталог для кешу міграцій на цій машині, щоб різні репозиторії могли повторно використовувати вже відомі результати.
+- `migrationCacheKey` — перетворює назву пакета і діапазон версій на стабільний безпечний ключ для кешу.
+- `readMigrationCache` — читає кешований запис міграції для потрібної пари версій; якщо запису немає або він пошкоджений, мовчки повертає `null`.
+- `writeMigrationCache` — зберігає результат аналізу міграції в кеш, щоб наступні запуски на цій машині могли його повторити без нового дослідження.
+- `withKnownMigrationNotes` — додає до промпта підсумок уже відомої міграції з кешу й підказує пропустити повторне дослідження та перейти до перевірки використання в поточному проєкті.
+
+## Публічний API
+
+- DEFAULT_CACHE_DIR — Спільний каталог кешу міграцій для всіх репозиторіїв на цій машині; не прив’язаний до конкретного worktree.
+- migrationCacheKey — Перетворює `` на безпечне ім’я файлу для спільного кешу між репо.
+- readMigrationCache — Повертає збережений запис міграції для ``, якщо його вже обробляли в іншому repo/worktree; відсутній або пошкоджений запис дає `null`.
+- writeMigrationCache — Записує результат LLM-обробки для ``, щоб не повторювати дослідження changelog для такого ж bump-а.
+- withKnownMigrationNotes — Додає до prompt короткий підсумок знайденої міграції і, якщо є кеш, пропускає дослідження changelog/diff на користь пошуку використання в поточному проєкті.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
+- Кешує результати в межах одного прогону.

package/rules/test/cargo_mutants_config/cargo_mutants_config.mdc

@@ -1,18 +0,0 @@
-## Налаштування mutation-testing для Rust: `.cargo/mutants.toml`
-
-Якщо у `.n-rules.json#rules` присутнє правило `rust` — правило `test` створює `.cargo/mutants.toml` у каталозі **кожного** Cargo.toml-маніфесту: кореневий `Cargo.toml`, `<workspace>/src-tauri/Cargo.toml` (Tauri-патерн) і `<workspace>/Cargo.toml` (flat workspace).
-
-Канон cargo-mutants config: [mutants.toml.baseline](./data/cargo_mutants_config/mutants.toml.baseline)
-
-**Customization** (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерн лише забезпечує наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.
-
-### Універсальний baseline і framework-specific tuning
-
-Правило `test` відповідає лише за **універсальний baseline** mutation-testing:
-
-- створює `.cargo/mutants.toml` для Rust crates (порожній, з коментарем);
-- не робить припущень про framework/app shell;
-- не виключає platform glue, generated wrappers або binary entrypoints;
-- framework-specific tuning (`--lib`/`--tests`, `exclude_globs` для app-shell і platform bridge файлів) належить відповідним правилам (`tauri`, `capacitor` тощо).
-
-Якщо інше правило спеціалізує mutation-behavior — воно зобов'язане **доповнювати** існуючий `.cargo/mutants.toml` без дублювання (додавати лише відсутні ключі) і **не перетирати** ручні налаштування. Послідовний запуск `npx @7n/rules fix test` після `fix tauri` не має скидати tauri-tuning, і навпаки — повторний `fix tauri` не дублює секції.

package/rules/test/cargo_mutants_config/concern.json

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

package/rules/test/cargo_mutants_config/data/cargo_mutants_config/mutants.toml.baseline

@@ -1,7 +0,0 @@
-# .cargo/mutants.toml — universal cargo-mutants baseline (test.mdc).
-# Цей baseline нейтральний: він не робить припущень про framework/app shell,
-# не виключає platform glue, generated wrappers або binary entrypoints.
-# Framework-specific tuning (Tauri, Capacitor тощо) належить відповідним
-# правилам — вони без дублювання доповнюють цей файл, не перетирають його.
-# cargo-mutants має робочі defaults; цей файл — стартова точка для customization.
-# Документація: https://mutants.rs/

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

@@ -1,31 +0,0 @@
----
-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

@@ -1,12 +0,0 @@
----
-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

@@ -1,36 +0,0 @@
----
-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

@@ -1,49 +0,0 @@
-/**
- * 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

@@ -1,62 +0,0 @@
-/**
- * @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/lib/collect-test-file-offenders.mjs

@@ -1,49 +0,0 @@
-/** @see ../docs/collect-test-file-offenders.md */
-import { readFile } from 'node:fs/promises'
-import { basename, relative } from 'node:path'
-
-import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
-import { walkDir } from '../../../scripts/utils/walkDir.mjs'
-
-/**
- * Чи файл — JS-тест (`*.test.mjs` / `*.test.js`).
- * @param {string} absPath абсолютний шлях
- * @returns {boolean} `true` для `.test.{mjs,js}` файлів
- */
-export function isTestFile(absPath) {
-  const name = basename(absPath)
-  return name.endsWith('.test.mjs') || name.endsWith('.test.js')
-}
-
-/**
- * Обходить репо (поважаючи `.n-rules.json:ignore`), збирає `*.test.{mjs,js}` файли
- * і прогонить кожен через `findOffenders(body)` — спільний скелет для per-file
- * regex/parse-based test-конвенцій (напр. `no-console-store-restore`, `vitest-api-conventions`).
- * @param {string} cwd корінь репозиторію
- * @param {(body: string) => Array<{line: number}>} findOffenders детектор порушень у тілі файлу
- * @returns {Promise<{ testFiles: string[], offenders: Array<{file: string, line: number}> }>} усі тестові файли й знайдені порушення (з relative-шляхом)
- */
-export async function collectTestFileOffenders(cwd, findOffenders) {
-  const ignorePaths = await loadCursorIgnorePaths(cwd)
-
-  /** @type {string[]} */
-  const testFiles = []
-  await walkDir(
-    cwd,
-    absPath => {
-      if (isTestFile(absPath)) testFiles.push(absPath)
-    },
-    ignorePaths
-  )
-
-  /** @type {Array<{file: string, line: number}>} */
-  const offenders = []
-  for (const absPath of testFiles) {
-    const body = await readFile(absPath, 'utf8')
-    for (const o of findOffenders(body)) {
-      offenders.push({ file: relative(cwd, absPath), ...o })
-    }
-  }
-
-  return { testFiles, offenders }
-}

package/rules/test/lib/docs/collect-test-file-offenders.md

@@ -1,30 +0,0 @@
----
-type: JS Module
-title: collect-test-file-offenders.mjs
-resource: npm/rules/test/lib/collect-test-file-offenders.mjs
-docgen:
-  crc: d1c3db48
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Файл знаходить JS-тести `*.test.mjs` і `*.test.js` у репозиторії з урахуванням `.n-rules.json` та повертає для кожного з них відносні шляхи до offenders. Це дає змогу окремо перевіряти, які саме тестові файли виходять за межі правил проєкту, без додаткового парсингу чи нормалізації результату.
-
-## Поведінка
-
-- `isTestFile` — визначає, чи шлях належить до JS-тесту `*.test.mjs` або `*.test.js`.
-- `collectTestFileOffenders` — знаходить усі тестові файли в репозиторії з урахуванням `.n-rules.json` та збирає для них знайдені порушення з відносними шляхами.
-
-## Публічний API
-
-- isTestFile — Розпізнає JS-файли з тестовою назвою `*.test.mjs` або `*.test.js`.
-- collectTestFileOffenders — Обходить репозиторій з урахуванням `.n-rules.json:ignore`, знаходить `*.test.{mjs,js}` і проганяє кожен файл через `findOffenders` для спільних test-конвенцій на кшталт `no-console-store-restore` і `vitest-api-conventions`.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

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

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

package/rules/test/location/concern.json

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

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

@@ -1,11 +0,0 @@
----
-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

@@ -1,36 +0,0 @@
----
-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

@@ -1,52 +0,0 @@
-## Розміщення тестових файлів у каталозі `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

@@ -1,70 +0,0 @@
-/** @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

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