@7n/rules 1.20.1 → 1.22.0

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

@@ -1,42 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/project/main.mjs
-docgen:
-  crc: 2426a5fa
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  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).

package/rules/python/project/main.mjs

@@ -1,125 +0,0 @@
-/**
- * lint-поверхня python/project: read-only detector (`uv lock --check` + `uv sync --frozen` +
- * `pip-licenses`), перейменовано з колишнього bundled `python/check` (spec
- * docs/specs/2026-07-02-text-check-per-file-split-design.md §5-A). `full`, без `lint.glob` —
- * lockfile-аудит і ліцензійна перевірка project-wide за природою, не входять у delta-план
- * (§5): спрацьовують лише через `n-rules lint --full` або scoped `n-rules lint python`.
- */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-import { getBronzeAndAbove, isSpdxAllowed } from '../../../scripts/lib/blue-oak.mjs'
-
-/**
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} label назва кроку.
- * @param {string} cmd команда для запуску.
- * @param {string[]} args аргументи команди.
- * @param {string} cwd робочий каталог.
- * @param {(msg: string, reason: string) => void} fail колбек реєстрації порушення.
- * @param {string} reason машиночитна причина порушення.
- * @returns {Promise<boolean>} true якщо OK
- */
-async function runTool(label, cmd, args, cwd, fail, reason) {
-  const r = await spawnAsync(cmd, args, { cwd })
-  if (r.exitCode === 0) return true
-  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: ${label} — помилка (код ${code}, python.mdc)${outSuffix}`, reason)
-  return false
-}
-
-/**
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} uv шлях до бінарника uv.
- * @param {string} tool ім'я інструменту в uv-середовищі.
- * @returns {Promise<boolean>} true якщо інструмент доступний
- */
-async function uvToolAvailable(uv, tool) {
-  const r = await spawnAsync(uv, ['run', '--frozen', tool, '--version'])
-  return r.exitCode === 0
-}
-
-/**
- * Перевірка ліцензій залежностей через pip-licenses (read-only).
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} uv шлях до бінарника uv.
- * @param {string} cwd робочий каталог.
- * @param {(msg: string, reason: string) => void} fail колбек реєстрації порушення.
- * @returns {Promise<boolean>} true якщо OK / пропущено
- */
-async function checkPipLicenses(uv, cwd, fail) {
-  if (!(await uvToolAvailable(uv, 'pip-licenses'))) return true // недоступний → пропущено
-  const r = await spawnAsync(uv, ['run', '--frozen', 'pip-licenses', '--from=mixed', '--format=spdx-json'], {
-    cwd
-  })
-  if (r.exitCode !== 0) {
-    fail('lint-python: pip-licenses — помилка виконання', 'pip-licenses-error')
-    return false
-  }
-  const allowed = getBronzeAndAbove()
-  let doc
-  try {
-    doc = JSON.parse(r.stdout)
-  } catch {
-    doc = null
-  }
-  const packages = doc?.packages ?? []
-  const violations = packages.filter(pkg => {
-    const lic = pkg.licenseDeclared ?? pkg.licenseConcluded ?? 'NOASSERTION'
-    return !isSpdxAllowed(lic, allowed)
-  })
-  if (violations.length > 0) {
-    const list = violations
-      .map(
-        pkg =>
-          `  ✗ ${pkg.name}@${pkg.versionInfo ?? '?'}: ${pkg.licenseDeclared ?? pkg.licenseConcluded ?? 'NOASSERTION'}`
-      )
-      .join('\n')
-    fail(
-      `lint-python: pip-licenses — ${violations.length} пакет(ів) поза Blue Oak Bronze+ (python.mdc)\n${list}`,
-      'license-violation'
-    )
-    return false
-  }
-  return true
-}
-
-/**
- * Detector python/project (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
-
-  if (!existsSync(join(cwd, 'pyproject.toml'))) return reporter.result()
-
-  const uv = resolveCmd('uv')
-  if (!uv) {
-    fail('lint-python: `uv` не знайдено в PATH (потрібен при наявному pyproject.toml, python.mdc)', 'uv-missing')
-    return reporter.result()
-  }
-
-  if (!(await runTool('uv lock --check', uv, ['lock', '--check'], cwd, fail, 'uv-lock-violation'))) {
-    return reporter.result()
-  }
-  if (!(await runTool('uv sync --frozen', uv, ['sync', '--frozen'], cwd, fail, 'uv-sync-violation'))) {
-    return reporter.result()
-  }
-
-  await checkPipLicenses(uv, cwd, fail)
-
-  return reporter.result()
-}

package/rules/python/pyproject_toml/concern.json

@@ -1,9 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "policy": {
-    "files": {
-      "single": "pyproject.toml"
-    }
-  }
-}

package/rules/python/pyproject_toml/pyproject_toml.mdc

@@ -1,29 +0,0 @@
-## Rego-gate: перевірка `pyproject.toml`
-
-Rego-пакет: `python.pyproject_toml`
-
-Цільовий файл: `pyproject.toml`
-
-Дві групи правил:
-
-**1. Заборона Poetry** — перевіряє заборонені під-таблиці `[tool.*]` за deny-template (drift-safe через `--data template`): [pyproject.toml.deny.toml](./template/pyproject.toml.deny.toml)
-
-**2. PEP 621** — метадані проєкту мають бути у секції **`[project]`** (PEP 621), а **не** в `[tool.poetry]`. Обовʼязкові поля:
-
-- `[project].name` — назва пакета (непорожній рядок);
-- `[project].version` — статична версія (непорожній рядок);
-- `[project].requires-python` — мінімальна версія Python (наприклад `>=3.12`);
-- `[project].dependencies` — залежності (навіть порожній список `[]`).
-
-Канонічний цільовий вигляд: [pyproject.toml.snippet.toml](./template/pyproject.toml.snippet.toml)
-
-## Залежності та lock-файл (uv)
-
-Залежності додаються командою `uv add <pkg>`; dev-залежності — `uv add --dev <pkg>`. Lock-файл — **`uv.lock`** (іде в коміт, оновлюється командою `uv lock`).
-
-## Міграція з Poetry на uv
-
-1. Прибери `[tool.poetry]` і `poetry.lock` / `poetry.toml`.
-2. Перенеси метадані в `[project]` (name, version, requires-python, dependencies) за PEP 621.
-3. Згенеруй lock: `uv lock` → `uv.lock`.
-4. Dev-залежності: `uv add --dev ruff mypy …`.

package/rules/python/pyproject_toml/pyproject_toml.rego

@@ -1,53 +0,0 @@
-# Перевірка `pyproject.toml` (python.mdc).
-#
-# Канон надходить через --data: { "template": { "deny": ... } }
-# Структура --data сформована з template/pyproject.toml.deny.toml.
-# FS-перевірки (`poetry.lock`, `poetry.toml`, `uv.lock`, `package.json`) — у JS.
-#
-# Дві групи правил:
-#   1. Заборона Poetry — `[tool.poetry]` (та інші заборонені під-таблиці `tool`)
-#      керується deny-template, drift-safe.
-#   2. PEP 621 — `[project].name` і `[project].version` обовʼязкові (структурна
-#      вимога без канонічного літералу, тому inline).
-package python.pyproject_toml
-
-import rego.v1
-
-# ── Заборона Poetry (deny-template керує переліком) ──────────────────────────
-
-deny contains msg if {
-	some key, reason in object.get(data.template.deny, "tool", {})
-	key in object.keys(object.get(input, "tool", {}))
-	msg := sprintf("pyproject.toml: [tool.%s] — %s", [key, reason])
-}
-
-# ── PEP 621: обовʼязкові [project].* ─────────────────────────────────────────
-
-deny contains msg if {
-	not project_field_set("name")
-	msg := "pyproject.toml: відсутній [project].name (PEP 621 — мігруй з [tool.poetry], python.mdc)"
-}
-
-deny contains msg if {
-	not project_field_set("version")
-	msg := "pyproject.toml: відсутній статичний [project].version (PEP 621, python.mdc)"
-}
-
-deny contains msg if {
-	not project_field_set("requires-python")
-	msg := "pyproject.toml: відсутній [project].requires-python (наприклад '>=3.12') (PEP 621, python.mdc)"
-}
-
-deny contains msg if {
-	not project_key_exists("dependencies")
-	msg := "pyproject.toml: відсутній [project].dependencies (навіть порожній список `[]`) (PEP 621, python.mdc)"
-}
-
-project_field_set(key) if {
-	value := object.get(object.get(input, "project", {}), key, "")
-	value != ""
-}
-
-project_key_exists(key) if {
-	key in object.keys(object.get(input, "project", {}))
-}

package/rules/python/pyproject_toml/template/pyproject.toml.deny.toml

@@ -1,2 +0,0 @@
-[tool]
-poetry = "Poetry заборонено: мігруй на uv + PEP 621 [project] (python.mdc)"

package/rules/python/pyproject_toml/template/pyproject.toml.snippet.toml

@@ -1,12 +0,0 @@
-# Канонічний цільовий вигляд після міграції з Poetry на uv (PEP 621).
-# Метадані — у [project] (а не [tool.poetry]); dev-залежності додавай через
-# `uv add --dev <pkg>` (uv тримає їх у [dependency-groups].dev або [tool.uv]).
-[project]
-name = "your-package"
-version = "0.1.0"
-requires-python = ">=3.12"
-dependencies = []
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"

package/rules/python/ruff/concern.json

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

package/rules/python/ruff/docs/fix-ruff.md

@@ -1,33 +0,0 @@
----
-type: JS Module
-title: fix-ruff.mjs
-resource: npm/rules/python/ruff/fix-ruff.mjs
-docgen:
-  crc: e0a79f8d
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-T0-autofix для `python/ruff` забезпечує детерміновані виправлення та форматування файлів проєкту (`ruff check --fix` та `ruff format`), якщо інструмент `uv` доступний. Його призначення — стандартизувати код, порівнюючи зміни, внесені через автоматичні інструменти, з початковим вмістом.
-
-## Поведінка
-
-Поведінка
-1. Перевіряє, чи доступна команда `uv`. Якщо ні, жодних дій не виконує.
-2. Визначає список усіх файлів `.py` у проєкті, використовуючи інструмент `git`.
-3. Зберігає поточний вміст усіх знайдених `.py` файлів.
-4. Виконує команду `ruff check --fix` у всіх файлах проєкту, щоб автоматично виправити порушення.
-5. Виконує команду `ruff format` у всіх файлах проєкту, щоб застосувати стандарт форматування.
-6. Порівнює поточний вміст файлів із вмістом до виправлення.
-7. Якщо вміст файлу змінився, цей файл позначається як змінений.
-8. Якщо були змінені файли, результат повідомляється, а ці файли реєструються як змінені.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

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

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/ruff/main.mjs
-docgen:
-  crc: aa3519c3
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей детектор працює у **read-only** режимі та здійснює перевірку форматування та синтаксису Python-коду в заданому робочому каталозі. Він використовує `ruff` (зокрема, `ruff check` та `ruff format --check`) через `uv run --frozen` для аналізу цільових файлів, гарантуючи відповідність коду правилам, визначеним у `pyproject.toml`. Детектор аналізує наданий набір файлів (`ctx.files`) або весь проєкт (`.`), використовуючи транзитивне підвантаження імпортованих модулів для коректної перевірки. Результат містить зареєстровані порушення, виявлені під час перевірки.
-
-## Поведінка
-
-1. Якщо у робочому каталозі відсутній файл `pyproject.toml`, обробка припиняється.
-2. Визначаються цільові файли для аналізу: або наданий список файлів, або всі файли у робочому каталозі з розширенням `.py`.
-3. Якщо цільових файлів немає, обробка припиняється.
-4. Перевіряється доступність бінарника `uv` у системному шляху. Якщо його немає, реєстрація порушення про помилку з `uv` і обробка припиняється.
-5. Перевіряється доступність інструменту `ruff` у середовищі `uv`. Якщо він недоступний, обробка припиняється.
-6. Викликається `lint` для виконання перевірки синтаксису та логіки за допомогою `ruff check` для всіх цільових файлів.
-7. Якщо `ruff check` завершується з помилкою, це фіксується як порушення.
-8. Викликається `lint` для перевірки форматування коду за допомогою `ruff format --check` для всіх цільових файлів.
-9. Результат аналізу повертається з зареєстрованими порушеннями.
-
-## Публічний API
-
-lint — виявляє проблеми у коді за допомогою парсера python/ruff (только читання).
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/python/ruff/fix-ruff.mjs

@@ -1,65 +0,0 @@
-/**
- * T0-autofix для `python/ruff` — детерміновані `ruff check --fix` + `ruff format` (через
- * `uv run --frozen`), перенесено з колишнього `python/check/fix-check.mjs`
- * (spec docs/specs/2026-07-02-text-check-per-file-split-design.md "Рішення python/php/rego").
- * Відсутній `uv` → no-op.
- */
-import { readFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-
-import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
-import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
-
-/**
- * Вміст файлу або null, якщо не читається.
- * @param {string} abs абсолютний шлях
- * @returns {string|null} вміст або null
- */
-function readOrNull(abs) {
-  try {
-    return readFileSync(abs, 'utf8')
-  } catch {
-    return null
-  }
-}
-
-/**
- * Tracked *.py файли проєкту (через git).
- * Async (не блокує event loop) — може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} cwd корінь
- * @returns {Promise<string[]>} posix-relative шляхи
- */
-async function listPyFiles(cwd) {
-  const r = await spawnAsync('git', ['ls-files', '-z', '--', '*.py'], { cwd })
-  if (r.exitCode !== 0) return []
-  return (r.stdout ?? '').split('\0').filter(Boolean)
-}
-
-/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
-export const patterns = [
-  {
-    id: 'python-ruff-fix',
-    standalone: true, // §8 Phase 2: ruff check --fix + format самі ре-аналізують, test() не потрібен
-    test: violations =>
-      violations.some(v => v.reason === 'ruff-check-violation' || v.reason === 'ruff-format-violation'),
-    apply: async (violations, ctx) => {
-      const uv = resolveCmd('uv')
-      if (!uv) return { touchedFiles: [] }
-      const files = await listPyFiles(ctx.cwd)
-      if (files.length === 0) return { touchedFiles: [] }
-
-      const abs = files.map(f => resolve(ctx.cwd, f))
-      const before = new Map(abs.map(a => [a, readOrNull(a)]))
-      const opts = { cwd: ctx.cwd }
-      await spawnAsync(uv, ['run', '--frozen', 'ruff', 'check', '--fix', '.'], opts)
-      await spawnAsync(uv, ['run', '--frozen', 'ruff', 'format', '.'], opts)
-
-      const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
-      for (const a of touchedFiles) ctx.recordWrite?.(a)
-      return touchedFiles.length > 0
-        ? { touchedFiles, message: `ruff check --fix + format: ${touchedFiles.length} файл(ів)` }
-        : { touchedFiles: [] }
-    }
-  }
-]

package/rules/python/ruff/main.mjs

@@ -1,53 +0,0 @@
-/**
- * lint-поверхня python/ruff: read-only detector (`ruff check` + `ruff format --check`, через
- * `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") — ruff сам транзитивно підвантажує імпортовані модулі
- * (follow-imports), тож коректний і на підмножині переданих файлів.
- */
-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'
-
-/**
- * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
- * (ADR 260716-1354).
- * @param {string} label назва кроку.
- * @param {string} uv шлях до бінарника uv.
- * @param {string[]} args аргументи ruff (без `uv run --frozen ruff`-префіксу).
- * @param {string} cwd робочий каталог.
- * @param {(msg: string, opts: object) => void} fail колбек реєстрації порушення.
- * @param {string} reason машиночитна причина порушення.
- * @returns {Promise<boolean>} true якщо OK
- */
-async function runRuffStep(label, uv, args, cwd, fail, reason) {
-  const r = await spawnAsync(uv, ['run', '--frozen', 'ruff', ...args], { cwd })
-  if (r.exitCode === 0) return true
-  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: ${label} — помилка (код ${code}, python.mdc)${outSuffix}`, reason)
-  return false
-}
-
-/**
- * Detector python/ruff (read-only).
- * @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, 'ruff')
-  if (!prepared) return reporter.result()
-  const { uv, targets } = prepared
-
-  if (!(await runRuffStep('ruff check', uv, ['check', ...targets], cwd, fail, 'ruff-check-violation'))) {
-    return reporter.result()
-  }
-  await runRuffStep('ruff format --check', uv, ['format', '--check', ...targets], cwd, fail, 'ruff-format-violation')
-
-  return reporter.result()
-}

package/rules/python/tooling/concern.json

@@ -1,15 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "config",
-  "lint": {
-    "scope": "full",
-    "glob": [
-      "pyproject.toml",
-      "uv.lock",
-      "poetry.lock",
-      "poetry.toml",
-      "package.json",
-      ".github/workflows/lint-python.yml"
-    ]
-  }
-}

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

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

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

@@ -1,35 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/python/tooling/main.mjs
-docgen:
-  crc: 98ec5b8e
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 90
-  issues: surzhik,judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей файл відповідає за перевірку відповідності проєкту встановленим правилам, визначеним у `python.mdc`. Він підтверджує наявність ключових конфігураційних файлів, зокрема `package.json`, що визначає залежності проекту. Дозволена функціональність обмежена лише читанням файлової системи та бази даних; жодних операцій запису в ці ресурси не виконується. Основна логіка роботи реалізована у публічній функції `main`.
-
-## Поведінка
-
-main виявляє відповідність проєкту правилам (python.mdc) за наявності необхідних файлів та конфігурацій.
-
-1. Перевіряє наявність `pyproject.toml` у корені.
-2. Перевіряє наявність `uv.lock`, повідомляючи про необхідність його генерації, якщо він відсутній.
-3. Перевіряє відсутність артефактів Poetry (`poetry.lock`, `poetry.toml`), оскільки підтримується лише `uv` (python.mdc).
-4. Перевіряє наявність `package.json` у корені.
-5. Перевіряє наявність файлу робочого процесу `.github/workflows/lint-python.yml`, необхідного для відповідності (python.mdc).
-   Не перевіряє шляхи, що містять `.github` або `.git`.
-
-## Публічний API
-
-main — перевіряє, чи відповідає проєкт вимогам, визначеним у правилах `python.mdc`.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Свідомо пропускає шляхи: `.github`, `.git`.

package/rules/python/tooling/main.mjs

@@ -1,45 +0,0 @@
-/** @see ./docs/tooling.md */
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
-
-/**
- * Перевіряє відповідність проєкту правилам python.mdc.
- * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
- */
-export function lint(ctx) {
-  const cwd = ctx.cwd
-  const reporter = createViolationReporter(ctx)
-  const { pass, fail } = reporter
-
-  if (!existsSync(join(cwd, 'pyproject.toml'))) {
-    return Promise.resolve(reporter.result())
-  }
-
-  if (existsSync(join(cwd, 'uv.lock'))) {
-    pass('uv.lock є')
-  } else {
-    fail('uv.lock не знайдено — згенеруй `uv lock` (python.mdc, без Poetry)')
-  }
-
-  // Poetry-артефакти заборонені: uv є єдиним пакет-менеджером (python.mdc).
-  for (const poetryFile of ['poetry.lock', 'poetry.toml']) {
-    if (existsSync(join(cwd, poetryFile))) {
-      fail(`${poetryFile} знайдено — прибери Poetry, мігруй на uv (python.mdc)`)
-    } else {
-      pass(`${poetryFile} відсутній`)
-    }
-  }
-
-  if (existsSync(join(cwd, 'package.json'))) {
-    pass('package.json є')
-  } else {
-    fail('package.json не знайдено в корені — додай (python.mdc)')
-  }
-
-  // Existence/структуру lint-python.yml вимагає провайдер-плагін @7n/rules-ci-github
-  // (mixin python/lint_python_yml) — ядро провайдер-агностичне.
-  return Promise.resolve(reporter.result())
-}

package/rules/python/tooling/tooling.mdc

@@ -1,22 +0,0 @@
-## Перевірка наявності uv-toolchain і відсутності Poetry
-
-JS-перевірка (`npm/rules/python/tooling/main.mjs`) запускається, якщо в корені репо є `pyproject.toml`. Перевіряє:
-
-- `uv.lock` — має існувати (зафіксувати командою `uv lock`);
-- `poetry.lock` / `poetry.toml` — мають **бути відсутніми** (Poetry заборонено);
-- `package.json` — має бути у корені (js-обгортка lint є частиною монорепо);
-- `.github/workflows/lint-python.yml` — має існувати (структуру перевіряє Rego-полісі `python.lint_python_yml`).
-
-Якщо `pyproject.toml` відсутній — перевірка пропускається з кодом 0 (проєкт не Python).
-
-## lint-python: JS-детектори за concern
-
-Інструменти uv-екосистеми не мають єдиного CLI-обходу репо, тому python-лінт делегується у JS-детектори. Запуск — через **`n-rules lint python`** (CI — `--no-fix`); окремого `package.json`-скрипта немає.
-
-Три концерни (кожен — окремий per-file чи project-wide детектор):
-
-- `npm/rules/python/project/main.mjs` — `uv lock --check` + `uv sync --frozen` + ліцензійний аудит (`pip-licenses`); project-wide, поза delta-планом (лише `n-rules lint --full` або scoped `n-rules lint python`);
-- `npm/rules/python/ruff/main.mjs` (+ `fix-ruff.mjs`) — `ruff check` + `ruff format --check` (детект), `ruff check --fix` + `ruff format` (autofix); per-file;
-- `npm/rules/python/mypy/main.mjs` — `mypy` (лише детект, немає autofix); per-file.
-
-Якщо `pyproject.toml` у корені відсутній — усі концерни виходять без порушень (проєкт не Python). Якщо `pyproject.toml` є, але `uv` не знайдено в PATH — це помилка. `ruff`/`mypy`-кроки запускаються лише якщо інструмент доступний у середовищі (інакше крок пропускається з повідомленням).

package/rules/rust/applies/concern.json

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

package/rules/rust/applies/docs/index.md

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