@7n/rules 1.20.1 → 1.22.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.22.0] - 2026-07-18
+
+### Added
+
+- taze: по завершенню переносить зміни з автоствореного worktree назад у вихідне дерево (untracked) і прибирає worktree
+
+### Changed
+
+- taze: worktree-only гейт сам створює .worktrees/branch-taze і продовжує там замість throw-and-stop
+
+## [1.21.0] - 2026-07-18
+
+### Changed
+
+- Фаза 3 spec lang-plugins-extraction: lint-правила `rust` і `python` (main.mdc, концерни, rego, шаблони) виїхали з ядра у плагіни `@7n/rules-lang-rust`/`@7n/rules-lang-python` (contributes.rules) — резолвляться через resolveRulesDirs, автодетект/дзеркала/auto-rules працюють без змін для репо з активними плагінами. Mixin-теки CI-плагінів (Rego-gate lint-rust.yml/lint-python.yml) доповнюють правила плагінів-власників, як і раніше
+
 ## [1.20.1] - 2026-07-18
 
 ### Changed

package/package.json

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

package/scripts/lib/docs/resolve-plugins.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-plugins.mjs
 resource: npm/scripts/lib/resolve-plugins.mjs
 docgen:
-  crc: ab45e0ca
+  crc: 17248373
 ---
 
 Резолв плагінів @7n/rules: визначає, які пакети-плагіни активні у проєкті, де їхні `rules/`-каталоги, які capabilities вони надають і які handlers надають.

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

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrate.mjs
 resource: npm/skills/taze/js/orchestrate.mjs
 docgen:
-  crc: b675f6e7
+  crc: bce1f492
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.98

package/skills/taze/js/orchestrate.mjs

@@ -1,8 +1,8 @@
 /** @see ./docs/orchestrate.md */
 import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
-import { copyFile, rm } from 'node:fs/promises'
-import { join } from 'node:path'
+import { copyFile, mkdir, rm } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
 import { pathToFileURL } from 'node:url'
 
 import { assertEcosystemProvider } from '../../../scripts/lib/plugin-api.mjs'
@@ -81,28 +81,122 @@ export async function callRunner(runner, prompt, cwd, deps = {}) {
 }
 
 /**
- * Перевіряє, що `cwd` — ізольований worktree (`main.json.worktree: true`,
- * той самий контракт, що й для інших worktree-only скілів). Раніше цю
- * гарантію тримав агент, читаючи SKILL.md-preflight як частину промпту;
- * оркестратор більше НЕ годує SKILL.md жодному викликові, тож без цієї
- * перевірки `bunx taze -w -r latest`/`bun install` мовчки виконались би
- * прямо в основному дереві виклику. Кидає, якщо `git rev-parse --show-toplevel`
- * не містить `.worktrees` як сегмент шляху (покриває і `npx \@7n/mt worktree
- * create`-конвенцію `.worktrees/`, і сесійну `.claude/worktrees/`).
+ * Гарантує, що подальші кроки оркестратора виконуються в ізольованому
+ * worktree (`main.json.worktree: true`, той самий контракт, що й для інших
+ * worktree-only скілів). Оркестратор не годує SKILL.md жодному агенту, тож
+ * замість покладатись на агента, що читає SKILL.md-preflight, сам детерміновано
+ * створює worktree конвенцією `<current-branch>-taze` (`npx \@7n/mt worktree
+ * create`) і ставить залежності — щоб `bunx taze -w -r latest`/`bun install`
+ * ніколи не виконались прямо в основному дереві виклику. `autoCreated: true`
+ * сигналить викликачеві, що після завершення прогону варто перенести зміни
+ * назад (`bringChangesBackToOriginal`) і прибрати worktree
+ * (`removeAutoCreatedWorktree`) — а не лишати сирітське дерево.
  * @param {string} cwd каталог для перевірки
  * @param {typeof spawnSync} spawnFn інжект для тестів
- * @returns {void}
+ * @param {(line: string) => void} log колбек прогресу
+ * @returns {{ cwd: string, autoCreated: boolean, branchArg: string|null }} `autoCreated: false` — `cwd` без змін
+ *   (вже worktree); `autoCreated: true` — `cwd` щойно створеного worktree і `branchArg`, з яким його створено
  */
-function assertRunningInWorktree(cwd, spawnFn) {
-  const result = spawnFn('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
-  const toplevel = result.status === 0 ? result.stdout.trim() : ''
+function ensureRunningInWorktree(cwd, spawnFn, log) {
+  const toplevelResult = spawnFn('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
+  const toplevel = toplevelResult.status === 0 ? toplevelResult.stdout.trim() : ''
   const segments = new Set(toplevel.replaceAll('\\', '/').split('/'))
-  if (!segments.has('.worktrees')) {
+  if (segments.has('.worktrees')) return { cwd, autoCreated: false, branchArg: null }
+
+  const branchResult = spawnFn('git', ['branch', '--show-current'], { cwd, encoding: 'utf8' })
+  const currentBranch = branchResult.status === 0 ? branchResult.stdout.trim() : ''
+  if (!currentBranch) {
     throw new Error(
-      `taze: "${cwd}" не в ізольованому worktree (git toplevel: "${toplevel || '?'}"). ` +
-        'main.json.worktree=true вимагає окремого дерева — створи його спершу (див. SKILL.md preflight), не запускай taze в основному дереві.'
+      `taze: "${cwd}" не в ізольованому worktree (git toplevel: "${toplevel || '?'}"), і поточну гілку визначити не вдалось ` +
+        '(detached HEAD?) — автоматичне створення worktree за конвенцією `<current-branch>-taze` неможливе. Перейди на гілку вручну.'
     )
   }
+
+  const branchArg = `${currentBranch}-taze`
+  const pathSegment = branchArg.replaceAll('/', '-')
+  log(`⚠️ "${cwd}" не в ізольованому worktree — створюю ".worktrees/${pathSegment}"...`)
+  runCommand('npx', ['@7n/mt', 'worktree', 'create', branchArg, 'n-taze: worktree-only skill'], cwd, spawnFn)
+
+  const newCwd = join(cwd, '.worktrees', pathSegment)
+  log('📥 bun install (bootstrap нового дерева)...')
+  runCommand('bun', ['install'], newCwd, spawnFn)
+  return { cwd: newCwd, autoCreated: true, branchArg }
+}
+
+/**
+ * Переносить зміни з автоствореного worktree назад у вихідне дерево як
+ * **untracked/незакомічені** правки (просте копіювання файлів, без git
+ * merge/cherry-pick) — так само, як їх бачив би користувач, якби сам
+ * працював у вихідному дереві. Джерело істини — `git status --porcelain`
+ * у worktree: для кожного шляху копіює файл, якщо він існує (модифікація/
+ * додавання), або видаляє його у вихідному дереві, якщо existsSync каже,
+ * що в worktree його вже нема (видалення). Перейменування (`old -> new` у
+ * porcelain) переносять лише нову назву — стара лишається як була, це
+ * прийнятний компроміс: taze не перейменовує файли сам, ефект можливий
+ * лише як побічний результат LLM-рефакторингу.
+ * @param {string} worktreeCwd автостворений worktree, з якого переносимо
+ * @param {string} originalCwd вихідне дерево, куди переносимо
+ * @param {typeof spawnSync} spawnFn інжект для тестів
+ * @param {(line: string) => void} log колбек прогресу
+ * @param {{ copyFile?: (src: string, dest: string) => Promise<void>, rm?: (path: string, opts?: object) => Promise<void>, mkdir?: (path: string, opts?: object) => Promise<void> }} [deps] інжекти для тестів
+ * @returns {Promise<string[]>} відносні шляхи перенесених файлів
+ */
+export async function bringChangesBackToOriginal(worktreeCwd, originalCwd, spawnFn, log, deps = {}) {
+  const copy = deps.copyFile ?? copyFile
+  const removeFile = deps.rm ?? rm
+  const makeDir = deps.mkdir ?? mkdir
+
+  const statusResult = spawnFn('git', ['status', '--porcelain'], { cwd: worktreeCwd, encoding: 'utf8' })
+  if (statusResult.status !== 0) {
+    log(
+      `⚠️ Не вдалось прочитати git status у "${worktreeCwd}" — зміни НЕ перенесені назад, worktree лишиться для ручного розбору.`
+    )
+    return []
+  }
+
+  const lines = statusResult.stdout.split('\n').filter(Boolean)
+  if (lines.length === 0) {
+    log('ℹ️ Worktree без змін — нічого переносити назад.')
+    return []
+  }
+
+  const brought = []
+  for (const line of lines) {
+    const rest = line.slice(3)
+    const relPath = rest.includes(' -> ') ? rest.split(' -> ', 2)[1] : rest
+    const srcPath = join(worktreeCwd, relPath)
+    const destPath = join(originalCwd, relPath)
+    if (existsSync(srcPath)) {
+      await makeDir(dirname(destPath), { recursive: true })
+      await copy(srcPath, destPath)
+    } else {
+      await removeFile(destPath, { force: true })
+    }
+    brought.push(relPath)
+  }
+  log(`📤 Перенесено назад у "${originalCwd}" як untracked: ${brought.join(', ')}`)
+  return brought
+}
+
+/**
+ * Прибирає автостворений worktree разом з його ефемерною git-гілкою
+ * (`npx \@7n/mt worktree remove <branch>`) — викликати лише ПІСЛЯ
+ * `bringChangesBackToOriginal`, інакше зміни згорять разом з деревом.
+ * Не кидає при провалі — це прибирання, а не крок, від якого залежить
+ * результат прогону; провал лише логується, worktree лишається для
+ * ручного розбору.
+ * @param {string} branchArg гілка, з якою worktree був створений (з `ensureRunningInWorktree`)
+ * @param {string} originalCwd вихідне дерево, звідки виконати `npx \@7n/mt worktree remove`
+ * @param {typeof spawnSync} spawnFn інжект для тестів
+ * @param {(line: string) => void} log колбек прогресу
+ * @returns {void}
+ */
+export function removeAutoCreatedWorktree(branchArg, originalCwd, spawnFn, log) {
+  log(`🧹 Прибираю автостворений worktree "${branchArg}"...`)
+  const result = spawnFn('npx', ['@7n/mt', 'worktree', 'remove', branchArg], { cwd: originalCwd, encoding: 'utf8' })
+  if (result.status !== 0) {
+    log(`⚠️ Не вдалось прибрати worktree "${branchArg}" — приберіть вручну (${result.stderr || result.stdout})`)
+  }
 }
 
 /**
@@ -329,62 +423,79 @@ export function formatReport({ minorPatch, totalChanged, results, ecosystems = [
  * @returns {Promise<{ ok: boolean, report: string, results: Array<object>, ecosystems: Array<object> }>} результат
  */
 export async function runTazeOrchestrator(options = {}) {
-  const cwd = options.cwd ?? process.cwd()
   const runner = options.runner ?? 'pi'
   const log = options.log ?? (line => console.log(line))
   const deps = options.deps ?? {}
   const spawnFn = deps.spawnFn ?? spawnSync
   const call = deps.callRunner ?? callRunner
 
-  assertRunningInWorktree(cwd, spawnFn)
-
-  // npm/bun-гілка активна лише за кореневим package.json — на чисто-Python/Rust
-  // репо `bun install` падає з exit 1, і без цього гейта весь прогін гинув би
-  // до екосистемних провайдерів. Той самий принцип «тиші», що й для мовних
-  // екосистем: немає сигналу — немає ані кроків, ані згадки у звіті.
-  const npmPresent = existsSync(join(cwd, 'package.json'))
-  let diff = { major: [], minorPatch: 0, totalChanged: 0 }
-  const results = []
-  if (npmPresent) {
-    log('📦 Бекап package.json...')
-    const backedUpWorkspaces = await backupWorkspacePackageFiles(cwd, deps)
-
-    log('⬆️  bunx taze -w -r latest...')
-    runCommand('bunx', ['taze', '-w', '-r', 'latest'], cwd, spawnFn)
-    log('📥 bun install...')
-    runCommand('bun', ['install'], cwd, spawnFn)
-
-    const collectDiff = deps.collectTazeDiff ?? collectTazeDiff
-    diff = await collectDiff(cwd)
-    log(`🔍 diff: ${diff.major.length} major, ${diff.minorPatch} minor/patch`)
+  const originalCwd = options.cwd ?? process.cwd()
+  const worktree = ensureRunningInWorktree(originalCwd, spawnFn, log)
+  const cwd = worktree.cwd
 
-    for (const entry of diff.major) {
-      log(`🔧 ${entry.pkg} (${entry.workspace}): ${entry.from} → ${entry.to}...`)
-      const outcome = await call(runner, buildDependencyPrompt(entry), cwd, deps)
-      results.push({ ...entry, ...outcome })
-      log(outcome.ok ? `  ✅ ${entry.pkg}` : `  ❌ ${entry.pkg}: ${outcome.error}`)
+  try {
+    // npm/bun-гілка активна лише за кореневим package.json — на чисто-Python/Rust
+    // репо `bun install` падає з exit 1, і без цього гейта весь прогін гинув би
+    // до екосистемних провайдерів. Той самий принцип «тиші», що й для мовних
+    // екосистем: немає сигналу — немає ані кроків, ані згадки у звіті.
+    const npmPresent = existsSync(join(cwd, 'package.json'))
+    let diff = { major: [], minorPatch: 0, totalChanged: 0 }
+    const results = []
+    if (npmPresent) {
+      log('📦 Бекап package.json...')
+      const backedUpWorkspaces = await backupWorkspacePackageFiles(cwd, deps)
+
+      log('⬆️  bunx taze -w -r latest...')
+      runCommand('bunx', ['taze', '-w', '-r', 'latest'], cwd, spawnFn)
+      log('📥 bun install...')
+      runCommand('bun', ['install'], cwd, spawnFn)
+
+      const collectDiff = deps.collectTazeDiff ?? collectTazeDiff
+      diff = await collectDiff(cwd)
+      log(`🔍 diff: ${diff.major.length} major, ${diff.minorPatch} minor/patch`)
+
+      for (const entry of diff.major) {
+        log(`🔧 ${entry.pkg} (${entry.workspace}): ${entry.from} → ${entry.to}...`)
+        const outcome = await call(runner, buildDependencyPrompt(entry), cwd, deps)
+        results.push({ ...entry, ...outcome })
+        log(outcome.ok ? `  ✅ ${entry.pkg}` : `  ❌ ${entry.pkg}: ${outcome.error}`)
+      }
+
+      await cleanupBackups(cwd, backedUpWorkspaces, deps)
+    } else {
+      log('⏭ npm/bun: кореневого package.json немає — гілка пропущена')
     }
 
-    await cleanupBackups(cwd, backedUpWorkspaces, deps)
-  } else {
-    log('⏭ npm/bun: кореневого package.json немає — гілка пропущена')
-  }
+    const providers = deps.ecosystemProviders ?? (await loadPluginTazeProviders(cwd, log, deps))
+    const ecosystems = []
+    for (const provider of providers) {
+      ecosystems.push(await runEcosystem(provider, { cwd, runner, log, deps, spawnFn, call }))
+    }
 
-  const providers = deps.ecosystemProviders ?? (await loadPluginTazeProviders(cwd, log, deps))
-  const ecosystems = []
-  for (const provider of providers) {
-    ecosystems.push(await runEcosystem(provider, { cwd, runner, log, deps, spawnFn, call }))
+    const report = formatReport({
+      minorPatch: diff.minorPatch,
+      totalChanged: diff.totalChanged,
+      results,
+      ecosystems,
+      npmPresent
+    })
+    log(report)
+
+    const ecosystemsOk = ecosystems.every(eco => eco.error === null && eco.results.every(r => r.ok))
+    return { ok: results.every(r => r.ok) && ecosystemsOk, report, results, ecosystems }
+  } finally {
+    // Лише для АВТОстворених worktree — якщо викликач уже сидів у своєму
+    // worktree (worktree.autoCreated === false), це не наш worktree і не
+    // нам його чіпати/прибирати. `finally` — щоб зміни поверталися і
+    // сирітський worktree прибирався навіть при кинутому винятку всередині
+    // try (падіння bunx/diff/провайдера), а не лише при успішному прогоні.
+    if (worktree.autoCreated) {
+      try {
+        await bringChangesBackToOriginal(cwd, originalCwd, spawnFn, log, deps)
+      } catch (error) {
+        log(`⚠️ Перенесення змін назад провалилось: ${error instanceof Error ? error.message : String(error)}`)
+      }
+      removeAutoCreatedWorktree(worktree.branchArg, originalCwd, spawnFn, log)
+    }
   }
-
-  const report = formatReport({
-    minorPatch: diff.minorPatch,
-    totalChanged: diff.totalChanged,
-    results,
-    ecosystems,
-    npmPresent
-  })
-  log(report)
-
-  const ecosystemsOk = ecosystems.every(eco => eco.error === null && eco.results.every(r => r.ok))
-  return { ok: results.every(r => r.ok) && ecosystemsOk, report, results, ecosystems }
 }

package/rules/python/applies/concern.json

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

package/rules/python/applies/docs/main.md

@@ -1,29 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/applies/main.mjs
-docgen:
-  crc: 871eb5c6
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.97
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Перевіряє наявність файлу `pyproject.toml` у корені репозиторію для визначення, чи має застосовуватися правило до проєктів, що використовують Python. Публічні функції `applies` та `main` реалізують цю логіку.
-
-## Поведінка
-
-applies визначає, чи застосовне правило, перевіряючи наявність файлу `pyproject.toml` у корені репозиторію.
-main повідомляє про успішне знаходження файлу `pyproject.toml`, що підтверджує застосування правила для Python.
-
-## Публічний API
-
-- applies — визначає загальні налаштування та конфігурацію.
-- main — виводить загальний контекст, тоді як спеціалізовані блоки виконують конкретні перевірки.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/python/applies/main.mjs

@@ -1,24 +0,0 @@
-/** @see ./docs/applies.md */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-
-/**
- * @param {string} [cwd] корінь репозиторію (`process.cwd()` у звичайному прогоні)
- * @returns {Promise<boolean>} `true` — правило застосовне; `false` — пропустити
- */
-export function applies(cwd = process.cwd()) {
-  return Promise.resolve(existsSync(join(cwd, 'pyproject.toml')))
-}
-
-/**
- * Друкує короткий context-pass — самі перевірки виконують інші concerns.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат context-pass
- */
-export function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  reporter.pass('pyproject.toml знайдено в корені — застосовую python.mdc')
-  return Promise.resolve(reporter.result())
-}

package/rules/python/docs/index.md

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

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

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

package/rules/python/lib/docs/uv-run.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: uv-run.mjs
-resource: npm/rules/python/lib/uv-run.mjs
-docgen:
-  crc: 1d697d71
-  model: openai-codex/gpt-5.4-mini
-  score: 100
-  issues: judge:inaccurate:0.97
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Спільний preflight для Python-детекторів `mypy` і `ruff`, виділений зі спільного дубльованого коду з `main.mjs`. Використовує `PY_EXT_RE`, щоб залишати лише Python-цілі; для `ctx.files` запускає перевірку по вибраних файлах, а без них — по всьому проєкту через `.`. За наявності `uvToolAvailable` готує запуск обох детекторів через `uv run --frozen`; `preparePythonRun` формує однаковий контракт підготовки для обох інструментів.
-
-## Поведінка
-
-- `PY_EXT_RE` — визначає, чи файл належить до Python-цілей для delta-лінту.
-- `uvToolAvailable` — перевіряє, чи доступний Python-інструмент у середовищі `uv`.
-- `preparePythonRun` — готує спільний preflight для Python-лінтерів: пропускає без `pyproject.toml`, відсікає нерелевантні файли, перевіряє наявність `uv` і доступність інструменту, після чого повертає готові цілі для запуску через `uv run --frozen`.
-
-## Публічний API
-
-- PY_EXT_RE — Відібрає лише Python-файли з delta-списку для `lint`.
-- uvToolAvailable — Підтверджує, що `uv` доступний у середовищі.
-- preparePythonRun — Готує запуск Python-цілі: звіряє `pyproject.toml`, визначає delta або full-обсяг, знаходить `uv` і перевіряє, чи є потрібний `tool`; якщо підготовка не вдалася, викликач завершує `reporter.result` раніше.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/python/lib/uv-run.mjs

@@ -1,52 +0,0 @@
-/**
- * Спільний preflight обох python-детекторів (`mypy`, `ruff`) — обидва per-file: приймають
- * `ctx.files`, інакше `.` (весь проєкт), обидва йдуть через `uv run --frozen`. Виділено зі
- * спільного дубльованого коду (jscpd) обох `main.mjs`.
- */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-
-/** Розширення `.py` — фільтр delta-списку файлів у `lint(ctx)`. */
-export const PY_EXT_RE = /\.py$/u
-
-/**
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} uv шлях до бінарника uv.
- * @param {string} tool ім'я інструменту в uv-середовищі.
- * @returns {Promise<boolean>} true якщо інструмент доступний
- */
-export async function uvToolAvailable(uv, tool) {
-  const r = await spawnAsync(uv, ['run', '--frozen', tool, '--version'])
-  return r.exitCode === 0
-}
-
-/**
- * Спільний preflight: pyproject.toml, delta/full-цілі, резолв `uv`, доступність `tool` у
- * uv-середовищі. Викликач рано виходить (`reporter.result()`), коли повертається `null` —
- * `fail()` для випадку відсутнього `uv` уже викликаний усередині.
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @param {(msg: string, opts: object) => void} fail колбек реєстрації порушення.
- * @param {string} tool ім'я інструменту (`mypy`|`ruff`) для перевірки доступності.
- * @returns {Promise<{uv: string, targets: string[]}|null>} preflight-результат, або null (рано вийти).
- */
-export async function preparePythonRun(ctx, fail, tool) {
-  if (!existsSync(join(ctx.cwd, 'pyproject.toml'))) return null
-
-  const targets = ctx.files === undefined ? ['.'] : ctx.files.filter(f => PY_EXT_RE.test(f))
-  if (targets.length === 0) return null
-
-  const uv = resolveCmd('uv')
-  if (!uv) {
-    fail('lint-python: `uv` не знайдено в PATH (потрібен при наявному pyproject.toml, python.mdc)', 'uv-missing')
-    return null
-  }
-  if (!(await uvToolAvailable(uv, tool))) return null // tool недоступний у uv-середовищі → пропущено
-
-  return { uv, targets }
-}

package/rules/python/main.json

@@ -1 +0,0 @@
-{ "auto": { "glob": "pyproject.toml" } }

package/rules/python/main.mdc

@@ -1,8 +0,0 @@
----
-description: Python — пакет-менеджер uv (без Poetry), PEP 621, lint-python
-globs: "**/*.py,pyproject.toml,uv.lock,.github/workflows/lint-python.yml"
-alwaysApply: false
-version: '1.0'
----
-
-Python-проєкти ведуться **виключно** на [uv](https://docs.astral.sh/uv/) — єдиний пакет-менеджер і резолвер. **Poetry заборонено.** Середовище: `uv sync --frozen` (строго з `uv.lock`).

package/rules/python/mypy/concern.json

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

package/rules/python/mypy/docs/main.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/mypy/main.mjs
-docgen:
-  crc: 189c5b15
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Please provide the draft section "overview" that needs revision, according to the context and requirements.
-
-## Поведінка
-
-1. Перевіряє наявність файлу `pyproject.toml` у кореневій директорії проєкту. Якщо його немає, перевірка не виконується.
-2. Визначає цільові файли для перевірки: або всі `.py` файли у проєкті, або лише ті, що передані в контекст.
-3. Перевіряє наявність у системному шляху інструмента `uv` та доступності `mypy` у середовищі `uv`. Якщо `uv` або `mypy` недоступні, перевірка пропускається.
-4. Запускає `mypy` через `uv run --frozen` для визначених цільових файлів, передаючи поточну робочу директорію проєкту як робочу директорію для виконання.
-5. Якщо `mypy` завершується з ненульовим кодом, фіксується порушення з виводом команди та кодом помилки.
-6. Якщо `mypy` завершується успішно, результати перевірки вважаються позитивними.
-
-## Публічний API
-
-lint — виявляє помилки в коді Python за допомогою mypy.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/python/mypy/main.mjs

@@ -1,37 +0,0 @@
-/**
- * lint-поверхня python/mypy: read-only detector (`mypy`, через `uv run --frozen`). Per-file:
- * приймає `ctx.files`, інакше `.` (весь проєкт). Виділено з колишнього bundled `python/check`
- * (spec docs/specs/2026-07-02-text-check-per-file-split-design.md "Рішення python/php/rego") —
- * mypy сам транзитивно підвантажує імпортовані модулі (follow-imports), тож дає коректні
- * діагнози й на підмножині переданих файлів. Немає fix capability (mypy — detect-only).
- */
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-import { preparePythonRun } from '../lib/uv-run.mjs'
-
-/**
- * Detector python/mypy (read-only).
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
- */
-export async function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  const { fail } = reporter
-  const cwd = ctx.cwd
-
-  const prepared = await preparePythonRun(ctx, fail, 'mypy')
-  if (!prepared) return reporter.result()
-  const { uv, targets } = prepared
-
-  const r = await spawnAsync(uv, ['run', '--frozen', 'mypy', ...targets], { cwd })
-  if (r.exitCode !== 0) {
-    const code = typeof r.exitCode === 'number' ? r.exitCode : 1
-    const out = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim().slice(0, 2000)
-    const outSuffix = out ? `\n${out}` : ''
-    fail(`lint-python: mypy — помилка (код ${code}, python.mdc)${outSuffix}`, 'mypy-violation')
-  }
-
-  return reporter.result()
-}

package/rules/python/project/concern.json

@@ -1,6 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "lint": {
-    "scope": "full"
-  }
-}