@7n/rules 1.20.0 → 1.20.1

package/rules/php/cs_fixer/main.mjs

@@ -4,11 +4,11 @@
  * bundled `php/check` (spec docs/specs/2026-07-02-text-check-per-file-split-design.md "Рішення
  * python/php/rego") — php-cs-fixer приймає список конкретних файлів аргументом.
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 
 /** Розширення `.php` — фільтр delta-списку файлів у `lint(ctx)`. */
 const PHP_EXT_RE = /\.php$/u
@@ -23,11 +23,12 @@ function vendorBin(root) {
 }
 
 /**
- * Detector php/cs_fixer (read-only).
+ * Detector php/cs_fixer (read-only). Async (не блокує event loop) — детектор може виконуватись
+ * у parallel lane `detectAll()` (ADR 260716-1354).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = ctx.cwd
@@ -40,9 +41,9 @@ export function lint(ctx) {
   const abs = vendorBin(root)
   if (!abs) return reporter.result() // php-cs-fixer відсутній у vendor/bin → пропущено
 
-  const r = spawnSync(abs, ['fix', '--dry-run', '--diff', ...targets], { cwd: root, encoding: 'utf8', shell: false })
-  if (r.status !== 0) {
-    const code = typeof r.status === 'number' ? r.status : 1
+  const r = await spawnAsync(abs, ['fix', '--dry-run', '--diff', ...targets], { cwd: root })
+  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-php: PHP-CS-Fixer (dry-run) — помилка (код ${code}, php.mdc)${outSuffix}`, 'php-cs-fixer-violation')

package/rules/php/phpcs/docs/main.md

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/php/phpcs/main.mjs
 docgen:
-  crc: 3da9ada2
+  crc: 389cb568
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/php/phpcs/main.mjs

@@ -4,11 +4,11 @@
  * Виділено з колишнього bundled `php/check` (spec
  * docs/specs/2026-07-02-text-check-per-file-split-design.md "Рішення python/php/rego").
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync, statSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 
 /** Розширення `.php` — фільтр delta-списку файлів у `lint(ctx)`. */
 const PHP_EXT_RE = /\.php$/u
@@ -38,11 +38,12 @@ function vendorBin(root) {
 }
 
 /**
- * Detector php/phpcs (read-only).
+ * Detector php/phpcs (read-only). Async (не блокує event loop) — детектор може виконуватись
+ * у parallel lane `detectAll()` (ADR 260716-1354).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = ctx.cwd
@@ -55,13 +56,13 @@ export function lint(ctx) {
   const abs = vendorBin(root)
   if (!abs) return reporter.result() // phpcs відсутній у vendor/bin → пропущено
 
-  const r = spawnSync(abs, ['--standard=Security', '--ignore=*/vendor/*,*/node_modules/*,*/.git/*', ...targets], {
-    cwd: root,
-    encoding: 'utf8',
-    shell: false
-  })
-  if (r.status !== 0) {
-    const code = typeof r.status === 'number' ? r.status : 1
+  const r = await spawnAsync(
+    abs,
+    ['--standard=Security', '--ignore=*/vendor/*,*/node_modules/*,*/.git/*', ...targets],
+    { cwd: root }
+  )
+  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-php: phpcs (Security) — помилка (код ${code}, php.mdc)${outSuffix}`, 'phpcs-violation')

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

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/php/project/main.mjs
 docgen:
-  crc: 0a3716eb
+  crc: b2bd6168
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   issues: judge:inaccurate:0.97
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/php/project/main.mjs

@@ -7,12 +7,12 @@
  * audit. Не входять у delta-план (§5): спрацьовують лише через `n-rules lint --full` або
  * scoped `n-rules lint php`.
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { join, resolve } 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'
 
 /**
  * @param {string} root корінь
@@ -25,19 +25,20 @@ function vendorBin(root, name) {
 }
 
 /**
- * Запускає тул і, на ненульовий код, реєструє порушення.
+ * Запускає тул і, на ненульовий код, реєструє порушення. Async (не блокує event loop) —
+ * детектор може виконуватись у parallel lane `detectAll()` (ADR 260716-1354).
  * @param {string} label назва кроку
  * @param {string} abs абсолютний шлях
  * @param {string[]} args аргументи команди.
  * @param {string} cwd робочий каталог.
  * @param {(msg: string, reason: string) => void} fail колбек реєстрації порушення.
  * @param {string} reason машиночитна причина порушення.
- * @returns {boolean} true якщо OK, false якщо порушення
+ * @returns {Promise<boolean>} true якщо OK, false якщо порушення
  */
-function runTool(label, abs, args, cwd, fail, reason) {
-  const r = spawnSync(abs, args, { cwd, encoding: 'utf8', shell: false })
-  if (r.status === 0) return true
-  const code = typeof r.status === 'number' ? r.status : 1
+async function runTool(label, abs, args, cwd, fail, reason) {
+  const r = await spawnAsync(abs, 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-php: ${label} — помилка (код ${code}, php.mdc)${outSuffix}`, reason)
@@ -45,11 +46,11 @@ function runTool(label, abs, args, cwd, fail, reason) {
 }
 
 /**
- * Detector php/project (read-only).
+ * Detector php/project (read-only). Async — `runTool` викликає `spawnAsync` (ADR 260716-1354).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = ctx.cwd
@@ -62,7 +63,9 @@ export function lint(ctx) {
     return reporter.result()
   }
 
-  if (!runTool('composer audit', composer, ['audit', '--no-interaction'], root, fail, 'composer-audit-violation')) {
+  if (
+    !(await runTool('composer audit', composer, ['audit', '--no-interaction'], root, fail, 'composer-audit-violation'))
+  ) {
     return reporter.result()
   }
 
@@ -71,18 +74,18 @@ export function lint(ctx) {
    * @param {string} label назва кроку.
    * @param {string[]} args аргументи інструменту.
    * @param {string} reason машиночитна причина порушення.
-   * @returns {boolean} true якщо OK / пропущено
+   * @returns {Promise<boolean>} true якщо OK / пропущено
    */
-  function runOptionalVendorTool(binName, label, args, reason) {
+  async function runOptionalVendorTool(binName, label, args, reason) {
     const abs = vendorBin(root, binName)
     if (!abs) return true // тул відсутній у vendor/bin → крок пропущено
-    return runTool(label, abs, args, root, fail, reason)
+    return await runTool(label, abs, args, root, fail, reason)
   }
 
-  if (!runOptionalVendorTool('phpstan', 'PHPStan', ['analyse', '--no-progress'], 'phpstan-violation')) {
+  if (!(await runOptionalVendorTool('phpstan', 'PHPStan', ['analyse', '--no-progress'], 'phpstan-violation'))) {
     return reporter.result()
   }
-  runOptionalVendorTool('psalm', 'Psalm', ['--no-cache'], 'psalm-violation')
+  await runOptionalVendorTool('psalm', 'Psalm', ['--no-cache'], 'psalm-violation')
 
   return reporter.result()
 }

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

@@ -3,9 +3,8 @@ type: JS Module
 title: uv-run.mjs
 resource: npm/rules/python/lib/uv-run.mjs
 docgen:
-  crc: 6aba3ab1
+  crc: 1d697d71
   model: openai-codex/gpt-5.4-mini
-  tier: cloud-min
   score: 100
   issues: judge:inaccurate:0.97
   judgeModel: openai-codex/gpt-5.4-mini

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

@@ -3,35 +3,39 @@
  * `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'
+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 {boolean} true якщо інструмент доступний
+ * @returns {Promise<boolean>} true якщо інструмент доступний
  */
-export function uvToolAvailable(uv, tool) {
-  const r = spawnSync(uv, ['run', '--frozen', tool, '--version'], { stdio: 'ignore', shell: false })
-  return r.status === 0
+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 {{uv: string, targets: string[]}|null} preflight-результат, або null (рано вийти).
+ * @returns {Promise<{uv: string, targets: string[]}|null>} preflight-результат, або null (рано вийти).
  */
-export function preparePythonRun(ctx, fail, tool) {
+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))
@@ -42,7 +46,7 @@ export function preparePythonRun(ctx, fail, tool) {
     fail('lint-python: `uv` не знайдено в PATH (потрібен при наявному pyproject.toml, python.mdc)', 'uv-missing')
     return null
   }
-  if (!uvToolAvailable(uv, tool)) return null // tool недоступний у uv-середовищі → пропущено
+  if (!(await uvToolAvailable(uv, tool))) return null // tool недоступний у uv-середовищі → пропущено
 
   return { uv, targets }
 }

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/mypy/main.mjs
 docgen:
-  crc: 7cc910e3
+  crc: 189c5b15
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/python/mypy/main.mjs

@@ -5,28 +5,29 @@
  * 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 { 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 {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const cwd = ctx.cwd
 
-  const prepared = preparePythonRun(ctx, fail, 'mypy')
+  const prepared = await 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 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')

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

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/project/main.mjs
 docgen:
-  crc: b47f2997
+  crc: 2426a5fa
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   judgeModel: openai-codex/gpt-5.4-mini
 ---

package/rules/python/project/main.mjs

@@ -5,27 +5,29 @@
  * lockfile-аудит і ліцензійна перевірка project-wide за природою, не входять у delta-план
  * (§5): спрацьовують лише через `n-rules lint --full` або scoped `n-rules lint python`.
  */
-import { spawnSync } from 'node:child_process'
 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 {boolean} true якщо OK
+ * @returns {Promise<boolean>} true якщо OK
  */
-function runTool(label, cmd, args, cwd, fail, reason) {
-  const r = spawnSync(cmd, args, { cwd, encoding: 'utf8', shell: false })
-  if (r.status === 0) return true
-  const code = typeof r.status === 'number' ? r.status : 1
+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)
@@ -33,30 +35,32 @@ function runTool(label, cmd, args, cwd, fail, reason) {
 }
 
 /**
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string} uv шлях до бінарника uv.
  * @param {string} tool ім'я інструменту в uv-середовищі.
- * @returns {boolean} true якщо інструмент доступний
+ * @returns {Promise<boolean>} true якщо інструмент доступний
  */
-function uvToolAvailable(uv, tool) {
-  const r = spawnSync(uv, ['run', '--frozen', tool, '--version'], { stdio: 'ignore', shell: false })
-  return r.status === 0
+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 {boolean} true якщо OK / пропущено
+ * @returns {Promise<boolean>} true якщо OK / пропущено
  */
-function checkPipLicenses(uv, cwd, fail) {
-  if (!uvToolAvailable(uv, 'pip-licenses')) return true // недоступний → пропущено
-  const r = spawnSync(uv, ['run', '--frozen', 'pip-licenses', '--from=mixed', '--format=spdx-json'], {
-    cwd,
-    encoding: 'utf8',
-    shell: false
+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.status !== 0) {
+  if (r.exitCode !== 0) {
     fail('lint-python: pip-licenses — помилка виконання', 'pip-licenses-error')
     return false
   }
@@ -90,10 +94,12 @@ function checkPipLicenses(uv, cwd, fail) {
 
 /**
  * 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 {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const cwd = ctx.cwd
@@ -106,10 +112,14 @@ export function lint(ctx) {
     return reporter.result()
   }
 
-  if (!runTool('uv lock --check', uv, ['lock', '--check'], cwd, fail, 'uv-lock-violation')) return reporter.result()
-  if (!runTool('uv sync --frozen', uv, ['sync', '--frozen'], cwd, fail, 'uv-sync-violation')) 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()
+  }
 
-  checkPipLicenses(uv, cwd, fail)
+  await checkPipLicenses(uv, cwd, fail)
 
   return reporter.result()
 }

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

@@ -3,9 +3,8 @@ type: JS Module
 title: fix-ruff.mjs
 resource: npm/rules/python/ruff/fix-ruff.mjs
 docgen:
-  crc: c2dc5eb6
+  crc: e0a79f8d
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/python/ruff/main.mjs
 docgen:
-  crc: 00e5708a
+  crc: aa3519c3
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

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

@@ -4,11 +4,11 @@
  * (spec docs/specs/2026-07-02-text-check-per-file-split-design.md "Рішення python/php/rego").
  * Відсутній `uv` → no-op.
  */
-import { spawnSync } from 'node:child_process'
 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, якщо не читається.
@@ -25,12 +25,14 @@ function readOrNull(abs) {
 
 /**
  * Tracked *.py файли проєкту (через git).
+ * Async (не блокує event loop) — може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string} cwd корінь
- * @returns {string[]} posix-relative шляхи
+ * @returns {Promise<string[]>} posix-relative шляхи
  */
-function listPyFiles(cwd) {
-  const r = spawnSync('git', ['ls-files', '-z', '--', '*.py'], { cwd, encoding: 'utf8' })
-  if (r.status !== 0) return []
+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)
 }
 
@@ -41,17 +43,17 @@ export const patterns = [
     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: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const uv = resolveCmd('uv')
       if (!uv) return { touchedFiles: [] }
-      const files = listPyFiles(ctx.cwd)
+      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, encoding: 'utf8', shell: false }
-      spawnSync(uv, ['run', '--frozen', 'ruff', 'check', '--fix', '.'], opts)
-      spawnSync(uv, ['run', '--frozen', 'ruff', 'format', '.'], opts)
+      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)

package/rules/python/ruff/main.mjs

@@ -5,24 +5,25 @@
  * "Рішення python/php/rego") — ruff сам транзитивно підвантажує імпортовані модулі
  * (follow-imports), тож коректний і на підмножині переданих файлів.
  */
-import { spawnSync } from 'node:child_process'
-
 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 {boolean} true якщо OK
+ * @returns {Promise<boolean>} true якщо OK
  */
-function runRuffStep(label, uv, args, cwd, fail, reason) {
-  const r = spawnSync(uv, ['run', '--frozen', 'ruff', ...args], { cwd, encoding: 'utf8', shell: false })
-  if (r.status === 0) return true
-  const code = typeof r.status === 'number' ? r.status : 1
+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)
@@ -32,21 +33,21 @@ function runRuffStep(label, uv, args, cwd, fail, reason) {
 /**
  * Detector python/ruff (read-only).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінту.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із порушеннями
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із порушеннями
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const cwd = ctx.cwd
 
-  const prepared = preparePythonRun(ctx, fail, 'ruff')
+  const prepared = await preparePythonRun(ctx, fail, 'ruff')
   if (!prepared) return reporter.result()
   const { uv, targets } = prepared
 
-  if (!runRuffStep('ruff check', uv, ['check', ...targets], cwd, fail, 'ruff-check-violation')) {
+  if (!(await runRuffStep('ruff check', uv, ['check', ...targets], cwd, fail, 'ruff-check-violation'))) {
     return reporter.result()
   }
-  runRuffStep('ruff format --check', uv, ['format', '--check', ...targets], cwd, fail, 'ruff-format-violation')
+  await runRuffStep('ruff format --check', uv, ['format', '--check', ...targets], cwd, fail, 'ruff-format-violation')
 
   return reporter.result()
 }

package/rules/rego/conftest_verify/docs/main.md

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rego/conftest_verify/main.mjs
 docgen:
-  crc: 2ef485ea
+  crc: e95d6632
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  tier: local-min
   score: 100
   judgeModel: openai-codex/gpt-5.4-mini
 ---