@7n/rules 1.20.0 → 1.21.0

package/rules/text/run-v8r/main.mjs

@@ -44,7 +44,6 @@
  * незалежно від verbosity) і виводить у stdout окреме попередження на кожен такий файл із порадою
  * додати схему в `npm/schemas/v8r-catalog.json`.
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { basename, delimiter, dirname, isAbsolute, join } from 'node:path'
@@ -53,6 +52,7 @@ import { fileURLToPath } from 'node:url'
 
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
 
 /** Розширення, які валідує v8r — фільтр delta-списку файлів у `lint(ctx)`. */
@@ -183,31 +183,30 @@ export function stripBunNodeShimDirs(pathValue) {
  * (`lint()`) для вбудовування у violation-повідомлення, яке бачить LLM fix-worker: без нього
  * fix-ladder отримує лише "щось не пройшло" й не має шансів вгадати, що саме (спостережено —
  * усі 4 rung-и незмінно падають у timeout на v8r-порушеннях).
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} targets glob-и або конкретні шляхи файлів
  * @param {string} configPath шлях до `V8R_CONFIG_FILE`
  * @param {boolean} [verbose] друкувати повний raw stdout/stderr v8r при помилці; інакше — лише
  *   рядки `✖ …` без `ℹ`-шуму (Pre-warming the cache, Processing <file>, Found schema in …)
- * @returns {{ exitError: true } | { exitError: false, code: number, detail: string }} помилка
- *   spawn або код v8r (0/98 — трактує викликач) + деталь `✖ …`-рядків
+ * @returns {Promise<{ exitError: true } | { exitError: false, code: number, detail: string }>}
+ *   помилка spawn або код v8r (0/98 — трактує викликач) + деталь `✖ …`-рядків
  */
-function runOneV8rInvocation(targets, configPath, verbose = false) {
+async function runOneV8rInvocation(targets, configPath, verbose = false) {
   const bunPath = resolveCmd('bun') ?? process.execPath
-  const result = spawnSync(bunPath, ['x', 'v8r', ...targets], {
-    encoding: 'utf8',
-    maxBuffer: 50 * 1024 * 1024,
-    shell: false,
-    stdio: ['ignore', 'pipe', 'pipe'],
-    env: { ...env, PATH: stripBunNodeShimDirs(env.PATH), V8R_CONFIG_FILE: configPath }
-  })
-
-  if (result.error) {
-    process.stderr.write(`${result.error.message}\n`)
+  let result
+  try {
+    result = await spawnAsync(bunPath, ['x', 'v8r', ...targets], {
+      env: { ...env, PATH: stripBunNodeShimDirs(env.PATH), V8R_CONFIG_FILE: configPath }
+    })
+  } catch (error) {
+    process.stderr.write(`${error.message}\n`)
     return { exitError: true }
   }
 
   warnAboutRemoteSchemaFallback(result.stderr ?? '')
 
-  const exitCode = result.status ?? 1
+  const exitCode = result.exitCode ?? 1
   let detail = ''
   if (exitCode !== 0 && exitCode !== 98) {
     detail = extractFailureLines(`${result.stdout ?? ''}\n${result.stderr ?? ''}`)
@@ -225,12 +224,15 @@ function runOneV8rInvocation(targets, configPath, verbose = false) {
  * Запускає послідовні виклики v8r по glob-ам (full-режим); не змінює process.exitCode.
  * Один виклик на glob навмисно (не batch) — v8r падає з кодом 98, якщо хоч один переданий
  * glob не знаходить файлів, і тоді решта розширень не перевіряються в тому ж виклику.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354). Виклики по glob-ам лишаються строго послідовними (не Promise.all) — той
+ * самий один-виклик-на-glob підхід, лише блокуючий spawnSync замінено на await у циклі.
  * @param {string[]} [globs] патерни; за замовчуванням DEFAULT_V8R_GLOBS
  * @param {boolean} [verbose] друкувати повний raw вивід v8r при помилці (див. runOneV8rInvocation)
- * @returns {{ code: number, detail: string }} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
+ * @returns {Promise<{ code: number, detail: string }>} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
  *   каталогу схем, інше — код v8r; `detail` — рядки `✖ …` (порожньо, якщо `code` не про валідацію)
  */
-export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
+export async function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
   if (!existsSync(V8R_CATALOG_PATH)) {
     process.stderr.write(
       `run-v8r: не знайдено каталог схем за шляхом ${V8R_CATALOG_PATH} (очікується npm/schemas/v8r-catalog.json у пакеті)\n`
@@ -241,7 +243,7 @@ export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
   const configPath = writeResolvedV8rConfig()
 
   for (const pattern of globs) {
-    const r = runOneV8rInvocation([pattern], configPath, verbose)
+    const r = await runOneV8rInvocation([pattern], configPath, verbose)
     if (r.exitError) return { code: 1, detail: '' }
     if (r.code !== 0 && r.code !== 98) return { code: r.code, detail: r.detail }
   }
@@ -251,12 +253,14 @@ export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
 /**
  * Запускає v8r по конкретному списку файлів (delta-режим) — один виклик, не по одному glob-у,
  * бо кожен переданий шлях уже існує (не glob), тож код 98 "порожній glob" тут не виникає.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} files абсолютні або відносні до cwd v8r-процесу шляхи файлів
  * @param {boolean} [verbose] друкувати повний raw вивід v8r при помилці (див. runOneV8rInvocation)
- * @returns {{ code: number, detail: string }} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
+ * @returns {Promise<{ code: number, detail: string }>} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
  *   каталогу схем, інше — код v8r; `detail` — рядки `✖ …` (порожньо, якщо `code` не про валідацію)
  */
-export function runV8rWithFiles(files, verbose = false) {
+export async function runV8rWithFiles(files, verbose = false) {
   if (files.length === 0) return { code: 0, detail: '' }
   if (!existsSync(V8R_CATALOG_PATH)) {
     process.stderr.write(
@@ -266,7 +270,7 @@ export function runV8rWithFiles(files, verbose = false) {
   }
 
   const configPath = writeResolvedV8rConfig()
-  const r = runOneV8rInvocation(files, configPath, verbose)
+  const r = await runOneV8rInvocation(files, configPath, verbose)
   if (r.exitError) return { code: 1, detail: '' }
   return { code: r.code === 98 ? 0 : r.code, detail: r.detail }
 }
@@ -285,28 +289,29 @@ function v8rFailMessage(detail) {
 /**
  * Detector text/run-v8r: read-only v8r по `ctx.files` (delta) або за дефолтними glob-ами (full).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат detector-а
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат detector-а
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
 
   const verbose = ctx.verbose === true
 
   if (ctx.files === undefined) {
-    const { code, detail } = runV8rWithGlobs(DEFAULT_V8R_GLOBS, verbose)
+    const { code, detail } = await runV8rWithGlobs(DEFAULT_V8R_GLOBS, verbose)
     if (code !== 0) fail(v8rFailMessage(detail), 'v8r')
     return reporter.result()
   }
 
   const files = ctx.files.filter(f => V8R_EXT_RE.test(f))
   if (files.length === 0) return reporter.result()
-  const { code, detail } = runV8rWithFiles(files, verbose)
+  const { code, detail } = await runV8rWithFiles(files, verbose)
   if (code !== 0) fail(v8rFailMessage(detail), 'v8r')
   return reporter.result()
 }
 
 if (isRunAsCli(import.meta.url)) {
   const globs = process.argv.length > 2 ? process.argv.slice(2) : DEFAULT_V8R_GLOBS
-  process.exitCode = runV8rWithGlobs(globs).code
+  const { code } = await runV8rWithGlobs(globs)
+  process.exitCode = code
 }

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/scripts/lib/lint-surface/blocking-inventory.mjs

@@ -6,47 +6,18 @@
  * `execSync` (прямо або через спільний helper), бо це блокує event loop цілком і
  * зробило б паралельний пул ілюзорним.
  *
- * Нова міграція (наступний shared helper на `spawnAsync`, за протоколом
- * `runConftestBatch`/`runOxlintJson`): переведи helper → онови caller-и (`await`) →
- * прибери відповідний запис звідси → розшир `docs/blocking-inventory-guard.test.mjs`
- * (guard-тест сам перевірить, що жоден із них більше не викликає `spawnSync`/`execSync`).
- */
-
-/**
- * Concern-и з прямим `spawnSync`/`execSync` у власному `main.mjs` — кожен спавнить свій
- * зовнішній тул напряму, ще не через `spawnAsync`.
- */
-const DIRECT_SPAWN_CONCERNS = [
-  'text/run-dotenv-linter',
-  'text/oxfmt',
-  'text/cspell-fix',
-  'text/run-v8r',
-  'text/run-shellcheck',
-  'image-compress/check',
-  'php/phpcs',
-  'php/project',
-  'php/cs_fixer',
-  'js/jscpd_duplicates',
-  'k8s/manifests',
-  'style/lint',
-  'bun/licensee',
-  'python/ruff',
-  'python/project',
-  'python/mypy',
-  'security/scan',
-  'rust/check',
-  'rego/conftest_verify'
-]
-
-/**
- * Concern-и, чий detector сам не викликає `spawnSync`/`execSync`, але делегує спільному
- * helper-у, який його викликає: `docker/lib/docker-hadolint.mjs` (hadolint) і
- * `rego/lib/run-external-tool.mjs` (regal/opa).
+ * Список зараз порожній: усі 22 concern-и, що на момент ADR мали прямий чи
+ * shared-helper `spawnSync`/`execSync`, мігровано на `spawnAsync`
+ * (`npm/scripts/utils/spawn-async.mjs`). Інвентар лишається як живий guard —
+ * `tests/blocking-inventory.test.mjs` сканує активні concern-и репо і провалиться,
+ * щойно новий (чи regressed) concern звернеться до `spawnSync`/`execSync` без
+ * відповідного запису тут.
+ *
+ * Протокол для нового blocking concern-а: перевести на `spawnAsync` → оновити
+ * caller-и (`await`) → якщо міграція ще не завершена, додати запис сюди на час
+ * переходу; guard-тест сам підтвердить, коли можна прибрати.
  */
-const SHARED_HELPER_CONCERNS = ['docker/lint', 'rego/regal', 'rego/opa_check']
-
-/** Повний serial-lane список: `${ruleId}/${concernId}` — 19 прямих + 3 через shared helper = 22. */
-export const SERIAL_LANE_CONCERNS = new Set([...DIRECT_SPAWN_CONCERNS, ...SHARED_HELPER_CONCERNS])
+export const SERIAL_LANE_CONCERNS = new Set()
 
 /**
  * Чи concern лишається у serial lane `detectAll()` (недоведений non-blocking).
@@ -55,5 +26,6 @@ export const SERIAL_LANE_CONCERNS = new Set([...DIRECT_SPAWN_CONCERNS, ...SHARED
  * @returns {boolean} true — serial lane; false — parallel-safe
  */
 export function isSerialLane(ruleId, concernId) {
+  // eslint-disable-next-line sonarjs/no-empty-collection -- навмисно порожній зараз (протокол вище); живий registry, не dead code
   return SERIAL_LANE_CONCERNS.has(`${ruleId}/${concernId}`)
 }

package/scripts/lib/lint-surface/docs/blocking-inventory.md

@@ -3,9 +3,8 @@ type: JS Module
 title: blocking-inventory.mjs
 resource: npm/scripts/lib/lint-surface/blocking-inventory.mjs
 docgen:
-  crc: 2e0e8624
+  crc: dce1fafd
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/scripts/utils/docs/spawn-async.md

@@ -3,9 +3,8 @@ type: JS Module
 title: spawn-async.mjs
 resource: npm/scripts/utils/spawn-async.mjs
 docgen:
-  crc: cc5d92e0
+  crc: 0e8ce2ef
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/scripts/utils/spawn-async.mjs

@@ -43,15 +43,18 @@ class AbortError extends Error {
  * @param {number} [opts.killGraceMs] пауза між `SIGTERM` і ескалацією до `SIGKILL` (дефолт 5000)
  * @param {string} [opts.cwd] робочий каталог дочірнього процесу
  * @param {Record<string, string>} [opts.env] оточення дочірнього процесу
+ * @param {string} [opts.input] дані для запису в stdin дочірнього процесу (`utf8`, аналог
+ *   `spawnSync`-опції `input`); stdin закривається (`end`) одразу після запису
  * @returns {Promise<SpawnAsyncResult>} нормалізований результат виконання
  */
 export async function spawnAsync(cmd, args, opts = {}) {
-  const { signal, timeoutMs, killGraceMs = 5000, ...spawnOpts } = opts
+  const { signal, timeoutMs, killGraceMs = 5000, input, ...spawnOpts } = opts
   if (signal?.aborted) throw new AbortError()
 
   const child = spawn(cmd, args, spawnOpts)
   child.stdout?.setEncoding('utf8')
   child.stderr?.setEncoding('utf8')
+  if (input !== undefined) child.stdin?.end(input, 'utf8')
 
   let stdout = ''
   let stderr = ''

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,32 +0,0 @@
----
-type: JS Module
-title: uv-run.mjs
-resource: npm/rules/python/lib/uv-run.mjs
-docgen:
-  crc: 6aba3ab1
-  model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
-  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,48 +0,0 @@
-/**
- * Спільний preflight обох python-детекторів (`mypy`, `ruff`) — обидва per-file: приймають
- * `ctx.files`, інакше `.` (весь проєкт), обидва йдуть через `uv run --frozen`. Виділено зі
- * спільного дубльованого коду (jscpd) обох `main.mjs`.
- */
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-
-/** Розширення `.py` — фільтр delta-списку файлів у `lint(ctx)`. */
-export const PY_EXT_RE = /\.py$/u
-
-/**
- * @param {string} uv шлях до бінарника uv.
- * @param {string} tool ім'я інструменту в uv-середовищі.
- * @returns {boolean} true якщо інструмент доступний
- */
-export function uvToolAvailable(uv, tool) {
-  const r = spawnSync(uv, ['run', '--frozen', tool, '--version'], { stdio: 'ignore', shell: false })
-  return r.status === 0
-}
-
-/**
- * Спільний preflight: pyproject.toml, delta/full-цілі, резолв `uv`, доступність `tool` у
- * uv-середовищі. Викликач рано виходить (`reporter.result()`), коли повертається `null` —
- * `fail()` для випадку відсутнього `uv` уже викликаний усередині.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @param {(msg: string, opts: object) => void} fail колбек реєстрації порушення.
- * @param {string} tool ім'я інструменту (`mypy`|`ruff`) для перевірки доступності.
- * @returns {{uv: string, targets: string[]}|null} preflight-результат, або null (рано вийти).
- */
-export 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 (!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: 7cc910e3
-  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,36 +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 { spawnSync } from 'node:child_process'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { preparePythonRun } from '../lib/uv-run.mjs'
-
-/**
- * Detector python/mypy (read-only).
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
- */
-export function lint(ctx) {
-  const reporter = createViolationReporter(ctx)
-  const { fail } = reporter
-  const cwd = ctx.cwd
-
-  const prepared = preparePythonRun(ctx, fail, 'mypy')
-  if (!prepared) return reporter.result()
-  const { uv, targets } = prepared
-
-  const r = spawnSync(uv, ['run', '--frozen', 'mypy', ...targets], { cwd, encoding: 'utf8', shell: false })
-  if (r.status !== 0) {
-    const code = typeof r.status === 'number' ? r.status : 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"
-  }
-}

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

@@ -1,43 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/project/main.mjs
-docgen:
-  crc: b47f2997
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
-  score: 100
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Огляд
-Цей детектор забезпечує перевірку цілісності оточення Python на рівні всього проекту. Він діагностує відповідність файлів блокування та ліцензій, виконуючи аудит на основі повного набору залежностей, а не лише змін у межах дельти.
-
-Поведінка
-Система перевіряє наявність файлу `pyproject.toml` у робочому каталозі; відсутність файлу призводить до успішного завершення.
-Визначає виконуваний файл `uv`; у разі відсутності він повідомляє про це (python.mdc).
-Виконує аудит цілісності файлу блокування за допомогою `uv lock --check`. Виявлені порушення фіксуються (python.mdc), і виконання негайно припиняється.
-Виконує збірку оточення через `uv sync --frozen`. Будь-які помилки фіксуються (python.mdc), зупиняючи процес.
-Сканує ліцензії усіх залежностей за допомогою `pip-licenses`. Якщо інструмент недоступний, перевірка пропускається. При помилці інструменту фіксується порушення (python.mdc). Якщо знайдено пакети, ліцензії яких не відповідають критеріям Blue Oak Bronze+, фіксується порушення (python.mdc) із переліком відповідних пакетів.
-Процес роботи є read-only, він не змінює файлової системи чи бази даних. Усі помилки перехоплюються з механізмом fail-safe, і винятки назовні не генеруються. На етапі виконання жодного кешування не відбувається.
-
-## Поведінка
-
-Поведінка:
-1. Перевіряє наявність файлу `pyproject.toml` у робочому каталозі. Якщо його немає, операція завершується успішно.
-2. Знаходить виконуваний файл `uv`. Якщо він не знайдений, операція завершується з повідомленням про відсутність `uv` (python.mdc).
-3. Виконує перевірку цілісності блокування за допомогою `uv lock --check`. Якщо виникає помилка, фіксує порушення (python.mdc) та завершує роботу.
-4. Виконує збірку оточення за допомогою `uv sync --frozen`. Якщо виникає помилка, фіксує порушення (python.mdc) та завершує роботу.
-5. Виконує перевірку ліцензій залежностей за допомогою `pip-licenses`. Якщо інструмент недоступний, перевірка пропускається. Якщо виникає помилка виконання, фіксує порушення (python.mdc). Якщо знайдено пакети з ліцензіями, що не відповідають критеріям Blue Oak Bronze+, фіксує порушення (python.mdc), перелічуючи знахідки.
-6. Повертає результат виконання перевірок.
-
-## Публічний API
-
-lint — знаходить проблеми в коді Python для даного проєкту.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).