@7n/rules 1.20.0 → 1.21.0

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/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
 ---

package/rules/rego/conftest_verify/main.mjs

@@ -7,9 +7,9 @@
  */
 import { resolve } from 'node:path'
 import { existsSync } from 'node:fs'
-import { spawnSync } from 'node:child_process'
 
 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'
 
 const LINT_TARGETS = ['npm/rules']
@@ -19,23 +19,25 @@ const LINT_TARGETS = ['npm/rules']
  * @param {string} bin абсолютний шлях до бінарника
  * @param {string[]} args аргументи
  * @param {string} cwd робоча директорія
- * @returns {{ status: number, output: string }} код завершення й обрізаний stdout+stderr
+ * @returns {Promise<{ status: number, output: string }>} код завершення й обрізаний stdout+stderr
  */
-function runStep(bin, args, cwd) {
-  const result = spawnSync(bin, args, { cwd, encoding: 'utf8', env: process.env, shell: false })
-  if (result.error) {
-    return { status: 1, output: `Не вдалося запустити ${bin}: ${result.error.message}` }
+async function runStep(bin, args, cwd) {
+  let result
+  try {
+    result = await spawnAsync(bin, args, { cwd, env: process.env })
+  } catch (error) {
+    return { status: 1, output: `Не вдалося запустити ${bin}: ${error.message}` }
   }
   const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim().slice(0, 2000)
-  return { status: result.status ?? 1, output }
+  return { status: result.exitCode ?? 1, output }
 }
 
 /**
  * Detector rego/conftest_verify (read-only).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат зі зібраними violations
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = resolve(ctx.cwd)
@@ -46,7 +48,7 @@ export function lint(ctx) {
   const conftest = resolveCmd('conftest')
   if (!conftest) return reporter.result() // conftest відсутній → пропускаємо verify (старий код повертав 0)
 
-  const verifyRes = runStep(conftest, ['verify', ...targets.flatMap(t => ['-p', t])], root)
+  const verifyRes = await runStep(conftest, ['verify', ...targets.flatMap(t => ['-p', t])], root)
   if (verifyRes.status !== 0) {
     const verifySuffix = verifyRes.output ? `\n${verifyRes.output}` : ''
     fail(`lint-rego: conftest verify — помилка (код ${verifyRes.status})${verifySuffix}`, 'conftest-verify-violation')

package/rules/rego/lib/docs/run-external-tool.md

@@ -3,7 +3,7 @@ type: JS Module
 title: run-external-tool.mjs
 resource: npm/rules/rego/lib/run-external-tool.mjs
 docgen:
-  crc: 0f1da640
+  crc: ca820179
   model: openai-codex/gpt-5.4-mini
   score: 100
   issues: judge:inaccurate:0.99

package/rules/rego/lib/run-external-tool.mjs

@@ -5,7 +5,8 @@
  */
 import { existsSync } from 'node:fs'
 import { resolve } from 'node:path'
-import { spawnSync } from 'node:child_process'
+
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 
 /** Full-режим (ctx.files undefined): корінь policy-дерева, якщо існує. */
 export const FULL_TARGET = 'npm/rules'
@@ -44,13 +45,15 @@ export function resolveTargets(files, root) {
  * @param {string} bin абсолютний шлях до бінарника
  * @param {string[]} args аргументи
  * @param {string} cwd робоча директорія
- * @returns {{ status: number, output: string }} код завершення й обрізаний stdout+stderr
+ * @returns {Promise<{ status: number, output: string }>} код завершення й обрізаний stdout+stderr
  */
-export function runStep(bin, args, cwd) {
-  const result = spawnSync(bin, args, { cwd, encoding: 'utf8', env: process.env, shell: false })
-  if (result.error) {
-    return { status: 1, output: `Не вдалося запустити ${bin}: ${result.error.message}` }
+export async function runStep(bin, args, cwd) {
+  let result
+  try {
+    result = await spawnAsync(bin, args, { cwd, env: process.env })
+  } catch (error) {
+    return { status: 1, output: `Не вдалося запустити ${bin}: ${error.message}` }
   }
   const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim().slice(0, 2000)
-  return { status: result.status ?? 1, output }
+  return { status: result.exitCode ?? 1, output }
 }

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rego/opa_check/main.mjs
 docgen:
-  crc: e2f54bd8
+  crc: d5d66b52
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.96

package/rules/rego/opa_check/main.mjs

@@ -14,9 +14,9 @@ import { resolveTargets, runStep } from '../lib/run-external-tool.mjs'
 /**
  * Detector rego/opa_check (read-only).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат зі зібраними violations
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = resolve(ctx.cwd)
@@ -25,7 +25,7 @@ export function lint(ctx) {
   if (targets.length === 0) return reporter.result()
 
   const opa = ensureTool('opa')
-  const opaRes = runStep(opa, ['check', '--strict', ...targets], root)
+  const opaRes = await runStep(opa, ['check', '--strict', ...targets], root)
   if (opaRes.status !== 0) {
     const opaSuffix = opaRes.output ? `\n${opaRes.output}` : ''
     fail(`lint-rego: opa check --strict — помилка (код ${opaRes.status})${opaSuffix}`, 'opa-check-violation')

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rego/regal/main.mjs
 docgen:
-  crc: c628819a
+  crc: a101cc38
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.96

package/rules/rego/regal/main.mjs

@@ -14,9 +14,9 @@ import { resolveTargets, runStep } from '../lib/run-external-tool.mjs'
 /**
  * Detector rego/regal (read-only).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону.
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат зі зібраними violations
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const root = resolve(ctx.cwd)
@@ -25,7 +25,7 @@ export function lint(ctx) {
   if (targets.length === 0) return reporter.result()
 
   const regal = ensureTool('regal')
-  const regalRes = runStep(regal, ['lint', ...targets], root)
+  const regalRes = await runStep(regal, ['lint', ...targets], root)
   if (regalRes.status !== 0) {
     const regalSuffix = regalRes.output ? `\n${regalRes.output}` : ''
     fail(`lint-rego: regal lint — помилка (код ${regalRes.status})${regalSuffix}`, 'regal-lint-violation')

package/rules/security/scan/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/security/scan/main.mjs
 docgen:
-  crc: 254fe129
+  crc: a57f9d26
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/rules/security/scan/main.mjs

@@ -2,18 +2,18 @@
  * lint-поверхня security/scan: read-only detector секретів (`trufflehog` filesystem скан
  * усього репо). Фіксу немає — детектор лише сигналить про знайдені секрети.
  */
-import { spawnSync } from 'node:child_process'
-
 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'
 
 /**
  * Detector security/scan: trufflehog filesystem скан (read-only). Якщо бінарника немає —
- * скан пропускається (як і раніше при відсутності інструмента).
+ * скан пропускається (як і раніше при відсутності інструмента). Async (не блокує event loop) —
+ * детектор може виконуватись у parallel lane `detectAll()` (ADR 260716-1354).
  * @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 cwd = ctx.cwd
@@ -26,7 +26,7 @@ export function lint(ctx) {
     }
   }
 
-  const r = spawnSync(
+  const r = await spawnAsync(
     trufflehog,
     [
       'filesystem',
@@ -37,12 +37,12 @@ export function lint(ctx) {
       '--results=verified,unknown',
       '--fail'
     ],
-    { cwd, encoding: 'utf8', shell: false }
+    { cwd }
   )
-  if (r.status !== 0) {
+  if (r.exitCode !== 0) {
     const out = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim().slice(0, 4000)
     const outSuffix = out ? `\n${out}` : ''
-    fail(`security/scan: trufflehog знайшов секрети (код ${r.status})${outSuffix}`, 'secret-found')
+    fail(`security/scan: trufflehog знайшов секрети (код ${r.exitCode})${outSuffix}`, 'secret-found')
   }
   return reporter.result()
 }

package/rules/style/lint/docs/fix-lint.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-lint.mjs
 resource: npm/rules/style/lint/fix-lint.mjs
 docgen:
-  crc: ef3a0112
+  crc: 140458e8
 ---
 
 ## Огляд

package/rules/style/lint/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/style/lint/main.mjs
 docgen:
-  crc: fe57567b
+  crc: cd4833fb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/style/lint/fix-lint.mjs

@@ -7,11 +7,11 @@
  * режимі), форматує їх і повертає лише фактично змінені. Запис permanent. Відсутній
  * stylelint → no-op.
  */
-import { spawnSync } from 'node:child_process'
 import { readFileSync } from 'node:fs'
 import { resolve } from 'node:path'
 
 import { filterStyleFiles, resolveStylelint } from './main.mjs'
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 
 /**
  * Вміст файлу або null, якщо не читається.
@@ -31,12 +31,12 @@ function readOrNull(abs) {
  * css/scss/vue через `git ls-files`.
  * @param {string} cwd корінь
  * @param {string[]|undefined} ctxFiles файли з контексту (дельта) або undefined (повний режим)
- * @returns {string[]} posix-relative шляхи
+ * @returns {Promise<string[]>} posix-relative шляхи
  */
-function listStyleFiles(cwd, ctxFiles) {
+async function listStyleFiles(cwd, ctxFiles) {
   if (ctxFiles !== undefined) return filterStyleFiles(ctxFiles)
-  const r = spawnSync('git', ['ls-files', '-z', '--', '*.css', '*.scss', '*.vue'], { cwd, encoding: 'utf8' })
-  if (r.status !== 0) return []
+  const r = await spawnAsync('git', ['ls-files', '-z', '--', '*.css', '*.scss', '*.vue'], { cwd })
+  if (r.exitCode !== 0) return []
   return (r.stdout ?? '').split('\0').filter(Boolean)
 }
 
@@ -46,15 +46,15 @@ export const patterns = [
     id: 'style-stylelint-fix',
     standalone: true, // §8 Phase 2: apply бере ctx.files (не violations), stylelint --fix сам ре-аналізує
     test: violations => violations.some(v => v.reason === 'stylelint-violation'),
-    apply: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const stylelint = resolveStylelint(ctx.cwd)
       if (!stylelint) return { touchedFiles: [] }
-      const files = listStyleFiles(ctx.cwd, ctx.files)
+      const files = await listStyleFiles(ctx.cwd, ctx.files)
       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)]))
-      spawnSync(stylelint, ['--fix', ...files], { cwd: ctx.cwd, encoding: 'utf8' })
+      await spawnAsync(stylelint, ['--fix', ...files], { cwd: ctx.cwd })
 
       const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
       for (const a of touchedFiles) ctx.recordWrite?.(a)

package/rules/style/lint/main.mjs

@@ -3,12 +3,12 @@
  * Per-file (ctx.files) або весь проєкт (ctx.files === undefined). Якщо stylelint
  * недоступний — крок пропускається (без npx-автовстановлення).
  */
-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'
 
 const STYLE_EXT_RE = /\.(?:css|scss|vue)$/u
 
@@ -34,9 +34,9 @@ export function resolveStylelint(cwd) {
 /**
  * Detector style/lint (read-only).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат зі зібраними violations
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат зі зібраними violations
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const reporter = createViolationReporter(ctx)
   const { fail } = reporter
   const cwd = ctx.cwd
@@ -58,11 +58,11 @@ export function lint(ctx) {
     return reporter.result()
   }
 
-  const r = spawnSync(stylelint, targets, { cwd, encoding: 'utf8', shell: false })
-  if (r.status !== 0) {
+  const r = await spawnAsync(stylelint, targets, { cwd, shell: false })
+  if (r.exitCode !== 0) {
     const out = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim().slice(0, 2000)
     const outSuffix = out ? `\n${out}` : ''
-    fail(`lint-style: stylelint — порушення (код ${r.status ?? 1}, style.mdc)${outSuffix}`, 'stylelint-violation')
+    fail(`lint-style: stylelint — порушення (код ${r.exitCode ?? 1}, style.mdc)${outSuffix}`, 'stylelint-violation')
   }
   return reporter.result()
 }

package/rules/text/cspell-fix/docs/fix-worker.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-worker.mjs
 resource: npm/rules/text/cspell-fix/fix-worker.mjs
 docgen:
-  crc: 59f849d4
+  crc: f7dc29a5
   model: openai-codex/gpt-5.5
 ---
 

package/rules/text/cspell-fix/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/cspell-fix/main.mjs
 docgen:
-  crc: 22853b73
+  crc: 8a2b75ff
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/rules/text/cspell-fix/fix-worker.mjs

@@ -40,7 +40,7 @@ export async function fixWorker(violations, ctx) {
   const bin = resolveCmd('npx')
   if (!bin) return { touchedFiles: [] }
 
-  const first = detectCspell(ctx.cwd, bin, ctx.files)
+  const first = await detectCspell(ctx.cwd, bin, ctx.files)
   if (first.code === 0) return { touchedFiles: [] }
 
   const words = unknownWords(first.out)