@7n/rules 1.20.0 → 1.21.0

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

@@ -16,11 +16,11 @@
  * typo лишаються → cspell повертає !=0 → exit 1 (людина доправляє одруки вручну).
  */
 import { env } from 'node:process'
-import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 
 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'
 
 /** Слово у рядку cspell: `<file>:<line>:<col> - Unknown word (xxx)`. */
@@ -44,21 +44,18 @@ export const fixModel = () => env.N_LOCAL_MIN_MODEL || ''
  * рядок (`--no-summary` НЕ передається) лишається — з нього парситься `FILES_CHECKED_RE`.
  * @param {string} cwd корінь
  * @param {string} bin шлях до cspell (npx/локальний)
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} [files] явний перелік файлів (delta); без нього — `cspell .`
  * @param {boolean} [verbose] показати повний нативний вивід cspell (включно з прогресом)
- * @returns {{ code:number, out:string }} код + обʼєднаний stdout/stderr
+ * @returns {Promise<{ code:number, out:string }>} код + обʼєднаний stdout/stderr
  */
-export function detectCspell(cwd, bin, files, verbose = false) {
+export async function detectCspell(cwd, bin, files, verbose = false) {
   const targets = files === undefined ? ['.'] : files
   const quietArgs = verbose ? [] : ['--no-progress']
-  const r = spawnSync(bin, ['cspell', ...quietArgs, ...targets], {
-    cwd,
-    encoding: 'utf8',
-    maxBuffer: 32 * 1024 * 1024,
-    env: process.env
-  })
+  const r = await spawnAsync(bin, ['cspell', ...quietArgs, ...targets], { cwd, env: process.env })
   const out = `${r.stdout ?? ''}${r.stderr ?? ''}`
-  const code = typeof r.status === 'number' ? r.status : 1
+  const code = typeof r.exitCode === 'number' ? r.exitCode : 1
   // cspell повертає !=0 і коли жоден переданий файл не пройшов ignorePaths
   // (`.cspell.json`) — «Files checked: 0» означає «нічого перевіряти», не порушення.
   const checked = FILES_CHECKED_RE.exec(out)
@@ -138,19 +135,21 @@ export function appendWordsToDict(cwd, words) {
 /**
  * cspell-крок lint-text: read-only детект (нуль мутацій). LLM-класифікація знахідок
  * і поповнення `.cspell.json#words` живуть у `fix-worker.mjs` (Central Runner Pipeline).
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} [files] явний перелік файлів (delta); без нього — `cspell .`
  * @param {string} [cwd] корінь
  * @param {boolean} [verbose] показати повний нативний вивід cspell (включно з прогресом)
- * @returns {number} 0 — чисто; 1 — лишились знахідки / помилка середовища
+ * @returns {Promise<number>} 0 — чисто; 1 — лишились знахідки / помилка середовища
  */
-export function runCspellText(files, cwd = process.cwd(), verbose = false) {
+export async function runCspellText(files, cwd = process.cwd(), verbose = false) {
   const bin = resolveCmd('npx')
   if (!bin) {
     process.stderr.write('❌ npx не знайдено в PATH (cspell).\n')
     return 1
   }
 
-  const first = detectCspell(cwd, bin, files, verbose)
+  const first = await detectCspell(cwd, bin, files, verbose)
   if (first.code === 0) {
     // «Files checked: 0» при явно переданих файлах — легітимно (усі під ignorePaths),
     // але так само виглядає зламане середовище (спостережено 2026-07-12: cspell-gitignore
@@ -174,12 +173,12 @@ export function runCspellText(files, cwd = process.cwd(), verbose = false) {
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
  * @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
   if (ctx.files !== undefined && ctx.files.length === 0) return reporter.result()
 
-  const code = runCspellText(ctx.files, ctx.cwd, ctx.verbose === true)
+  const code = await runCspellText(ctx.files, ctx.cwd, ctx.verbose === true)
   if (code !== 0) fail('cspell знайшов порушення правопису (text.mdc)', 'cspell')
   return reporter.result()
 }

package/rules/text/oxfmt/docs/fix-oxfmt.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-oxfmt.mjs
 resource: npm/rules/text/oxfmt/fix-oxfmt.mjs
 docgen:
-  crc: 3c8ca96c
+  crc: 41767068
 ---
 
 ## Огляд

package/rules/text/oxfmt/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/oxfmt/main.mjs
 docgen:
-  crc: 40c037c0
+  crc: df5242e9
 ---
 
 ## Огляд

package/rules/text/oxfmt/fix-oxfmt.mjs

@@ -6,11 +6,11 @@
  * (`data.kind === 'oxfmt-unformatted'`); re-detect підтверджує результат. Запис permanent.
  * Тул відсутній у PATH → 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, якщо не читається.
@@ -30,7 +30,7 @@ export const patterns = [
   {
     id: 'text-oxfmt-write',
     test: violations => violations.some(v => v.data?.kind === 'oxfmt-unformatted' && v.file),
-    apply: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const oxfmt = resolveCmd('oxfmt')
       if (!oxfmt) return { touchedFiles: [] }
       const files = [
@@ -40,7 +40,7 @@ export const patterns = [
 
       const abs = files.map(f => resolve(ctx.cwd, f))
       const before = new Map(abs.map(a => [a, readOrNull(a)]))
-      spawnSync(oxfmt, ['--write', ...files], { cwd: ctx.cwd, encoding: 'utf8' })
+      await spawnAsync(oxfmt, ['--write', ...files], { cwd: ctx.cwd })
 
       const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
       for (const a of touchedFiles) ctx.recordWrite?.(a)

package/rules/text/oxfmt/main.mjs

@@ -6,23 +6,24 @@
  * `.oxfmtrc.json` (включно з `ignorePatterns`). Автофікс (`oxfmt --write`) — окремий T0
  * `fix-oxfmt.mjs`, не в detector-і. Тул відсутній у PATH → SKIP (не violation), як інші зовнішні.
  */
-import { spawnSync } from 'node:child_process'
 import { relative, 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'
 
-const JSON_MAX_BUFFER = 64 * 1024 * 1024
 const FMT_EXT_RE = /\.(?:m?[jt]s|c[jt]s|jsx|tsx|vue|css|scss)$/u
 // Безконфліктна formatter-домена: oxfmt-типи, що їх не форматує інше тулінг (md/json/yaml — поза).
 const FMT_GLOB = '**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts,vue,css,scss}'
 
 /**
  * Detector: повертає по одному violation на кожен неформатований файл.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону (cwd, files)
- * @returns {import('../../../scripts/lib/lint-surface/types.mjs').LintResult} результат із violation на кожен неформатований файл
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат із violation на кожен неформатований файл
  */
-export function lint(ctx) {
+export async function lint(ctx) {
   const { cwd, files } = ctx
   const reporter = createViolationReporter(ctx)
   const oxfmt = resolveCmd('oxfmt')
@@ -31,7 +32,7 @@ export function lint(ctx) {
   const targets = files === undefined ? [FMT_GLOB] : files.filter(f => FMT_EXT_RE.test(f))
   if (targets.length === 0) return reporter.result()
 
-  const r = spawnSync(oxfmt, ['--list-different', ...targets], { cwd, encoding: 'utf8', maxBuffer: JSON_MAX_BUFFER })
+  const r = await spawnAsync(oxfmt, ['--list-different', ...targets], { cwd })
   const unformatted = (r.stdout ?? '')
     .split('\n')
     .map(s => s.trim())

package/rules/text/run-dotenv-linter/docs/fix-run-dotenv-linter.md

@@ -3,9 +3,8 @@ type: JS Module
 title: fix-run-dotenv-linter.mjs
 resource: npm/rules/text/run-dotenv-linter/fix-run-dotenv-linter.mjs
 docgen:
-  crc: b5c46c77
+  crc: 4fef0c3c
   model: openai-codex/gpt-5.5
-  tier: cloud-avg
   score: 90
   issues: internal-name:runDotenvLinter,judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/text/run-dotenv-linter/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/run-dotenv-linter/main.mjs
 docgen:
-  crc: 1e0140eb
+  crc: 47964f53
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98

package/rules/text/run-dotenv-linter/fix-run-dotenv-linter.mjs

@@ -48,12 +48,12 @@ export const patterns = [
     id: 'text-dotenv-fix',
     standalone: true, // §8 Phase 2: dotenv-linter fix сам ре-аналізує, test() не потрібен
     test: violations => violations.some(v => v.reason === 'dotenv-linter'),
-    apply: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const files = listEnvFiles(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)]))
-      runDotenvLinter(ctx.cwd, false)
+      await runDotenvLinter(ctx.cwd, false)
       const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
       for (const a of touchedFiles) ctx.recordWrite?.(a)
       return touchedFiles.length > 0

package/rules/text/run-dotenv-linter/main.mjs

@@ -15,11 +15,11 @@
  * фінальний `dotenv-linter check -r --quiet . --exclude …`; будь-яке залишкове порушення — ненульовий
  * код виходу.
  */
-import { spawnSync } from 'node:child_process'
 import { resolve } from 'node:path'
 
 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'
 
 /** Каталоги/файли, які виключаємо з рекурсивного сканування dotenv-linter. */
@@ -58,12 +58,14 @@ function buildTargetArgs(scopeFiles) {
 
 /**
  * Запускає dotenv-linter з авто-фіксом і фінальною перевіркою.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string} [cwd] робочий каталог (за замовчуванням `process.cwd()`)
  * @param {boolean} [readOnly] true → пропустити авто-фікс (`fix`), лише `check` (нуль мутацій)
  * @param {string[]} [scopeFiles] явний перелік `.env*`-файлів (delta) — якщо не задано, рекурсивний `-r .`
- * @returns {number} 0 — OK; 1 — інструмент відсутній або є залишкові порушення
+ * @returns {Promise<number>} 0 — OK; 1 — інструмент відсутній або є залишкові порушення
  */
-export function runDotenvLinter(cwd, readOnly, scopeFiles) {
+export async function runDotenvLinter(cwd, readOnly, scopeFiles) {
   const root = resolve(cwd ?? process.cwd())
   const bin = resolveCmd('dotenv-linter')
   if (!bin) {
@@ -73,29 +75,22 @@ export function runDotenvLinter(cwd, readOnly, scopeFiles) {
 
   const targets = buildTargetArgs(scopeFiles)
   if (!readOnly) {
-    const fixRun = spawnSync(bin, ['fix', '--no-backup', '--quiet', ...targets], {
-      cwd: root,
-      encoding: 'utf8',
-      env: process.env,
-      stdio: ['ignore', 'pipe', 'pipe']
-    })
-    if (fixRun.error) {
-      process.stderr.write(`${fixRun.error.message}\n`)
+    try {
+      await spawnAsync(bin, ['fix', '--no-backup', '--quiet', ...targets], { cwd: root, env: process.env })
+    } catch (error) {
+      process.stderr.write(`${error.message}\n`)
       return 1
     }
   }
 
-  const checkRun = spawnSync(bin, ['check', '--quiet', ...targets], {
-    cwd: root,
-    encoding: 'utf8',
-    env: process.env,
-    stdio: ['ignore', 'pipe', 'pipe']
-  })
-  if (checkRun.error) {
-    process.stderr.write(`${checkRun.error.message}\n`)
+  let checkRun
+  try {
+    checkRun = await spawnAsync(bin, ['check', '--quiet', ...targets], { cwd: root, env: process.env })
+  } catch (error) {
+    process.stderr.write(`${error.message}\n`)
     return 1
   }
-  if (checkRun.status === 0) return 0
+  if (checkRun.exitCode === 0) return 0
   if (checkRun.stdout?.length) process.stdout.write(checkRun.stdout)
   if (checkRun.stderr?.length) process.stderr.write(checkRun.stderr)
   return 1
@@ -104,19 +99,19 @@ export function runDotenvLinter(cwd, readOnly, scopeFiles) {
 /**
  * Detector text/run-dotenv-linter: read-only dotenv-linter по `ctx.files` (delta) або по всіх `.env*` (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 scopeFiles = ctx.files === undefined ? undefined : ctx.files.filter(f => ENV_BASENAME_RE.test(f))
   if (scopeFiles !== undefined && scopeFiles.length === 0) return reporter.result()
 
-  const code = runDotenvLinter(ctx.cwd, true, scopeFiles)
+  const code = await runDotenvLinter(ctx.cwd, true, scopeFiles)
   if (code !== 0) fail('dotenv-linter знайшов порушення у .env* (text.mdc)', 'dotenv-linter')
   return reporter.result()
 }
 
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = runDotenvLinter()
+  process.exitCode = await runDotenvLinter()
 }

package/rules/text/run-shellcheck/docs/fix-run-shellcheck.md

@@ -3,9 +3,8 @@ type: JS Module
 title: fix-run-shellcheck.mjs
 resource: npm/rules/text/run-shellcheck/fix-run-shellcheck.mjs
 docgen:
-  crc: 90367c61
+  crc: 190ecdc3
   model: openai-codex/gpt-5.5
-  tier: cloud-avg
   score: 90
   issues: internal-name:runShellcheckText,judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/text/run-shellcheck/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/run-shellcheck/main.mjs
 docgen:
-  crc: e365b165
+  crc: 809e7f3b
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99

package/rules/text/run-shellcheck/fix-run-shellcheck.mjs

@@ -28,12 +28,12 @@ export const patterns = [
     id: 'text-shellcheck-fix',
     standalone: true, // §8 Phase 2: shellcheck diff+patch цикл сам ре-аналізує, test() не потрібен
     test: violations => violations.some(v => v.reason === 'shellcheck'),
-    apply: (violations, ctx) => {
-      const files = listShellScriptPaths(ctx.cwd)
+    apply: async (violations, ctx) => {
+      const files = await listShellScriptPaths(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)]))
-      runShellcheckText(ctx.cwd, false)
+      await runShellcheckText(ctx.cwd, false)
       const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
       for (const a of touchedFiles) ctx.recordWrite?.(a)
       return touchedFiles.length > 0

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

@@ -15,12 +15,12 @@
  * Після циклу авто-виправлень виконується звичайний `shellcheck` по всіх зібраних файлах; будь-яке
  * попередження чи помилка — ненульовий код виходу.
  */
-import { spawnSync } from 'node:child_process'
 import { globSync } from 'node:fs'
 import { resolve } from 'node:path'
 
 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'
 
 /** Розширення shell-скриптів — фільтр delta-списку файлів у `lint(ctx)`. */
@@ -65,24 +65,18 @@ function printPatchInstallHints() {
 
 /**
  * Повертає відносні шляхи до shell-скриптів для перевірки.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string} cwd корінь проєкту
- * @returns {string[]} відсортований масив шляхів відносно cwd
+ * @returns {Promise<string[]>} відсортований масив шляхів відносно cwd
  */
-export function listShellScriptPaths(cwd) {
+export async function listShellScriptPaths(cwd) {
   const gitPath = resolveCmd('git')
   if (gitPath) {
-    const gitOk = spawnSync(gitPath, ['rev-parse', '--is-inside-work-tree'], {
-      cwd,
-      encoding: 'utf8',
-      env: process.env
-    })
-    if (gitOk.status === 0 && gitOk.stdout.trim() === 'true') {
-      const ls = spawnSync(gitPath, ['ls-files', '-z', '--', ':(glob)**/*.sh'], {
-        cwd,
-        encoding: 'utf8',
-        env: process.env
-      })
-      if (ls.status !== 0) {
+    const gitOk = await spawnAsync(gitPath, ['rev-parse', '--is-inside-work-tree'], { cwd, env: process.env })
+    if (gitOk.exitCode === 0 && gitOk.stdout.trim() === 'true') {
+      const ls = await spawnAsync(gitPath, ['ls-files', '-z', '--', ':(glob)**/*.sh'], { cwd, env: process.env })
+      if (ls.exitCode !== 0) {
         return []
       }
       const files = ls.stdout.split('\0').filter(Boolean)
@@ -102,9 +96,9 @@ export function listShellScriptPaths(cwd) {
  * @param {string} [cwd] робочий каталог (за замовчуванням `process.cwd()`)
  * @param {boolean} [readOnly] true → пропустити авто-фікс (diff+patch), лише фінальна перевірка
  * @param {string[]} [scopeFiles] явний перелік файлів (delta) — якщо не задано, шукає всі `*.sh` через `listShellScriptPaths`
- * @returns {number} 0 — OK; 1 — помилка середовища або залишкові зауваження shellcheck
+ * @returns {Promise<number>} 0 — OK; 1 — помилка середовища або залишкові зауваження shellcheck
  */
-export function runShellcheckText(cwd, readOnly, scopeFiles) {
+export async function runShellcheckText(cwd, readOnly, scopeFiles) {
   const root = resolve(cwd ?? process.cwd())
   const shellcheck = resolveCmd('shellcheck')
   if (!shellcheck) {
@@ -118,14 +112,14 @@ export function runShellcheckText(cwd, readOnly, scopeFiles) {
     return 1
   }
 
-  const files = scopeFiles ?? listShellScriptPaths(root)
+  const files = scopeFiles ?? (await listShellScriptPaths(root))
   if (files.length === 0) {
     return 0
   }
 
   if (!readOnly) {
     for (const rel of files) {
-      const fixCode = autofixOneFile(shellcheck, /** @type {string} */ (patchBin), root, rel)
+      const fixCode = await autofixOneFile(shellcheck, /** @type {string} */ (patchBin), root, rel)
       if (fixCode !== 0) return fixCode
     }
   }
@@ -136,15 +130,15 @@ export function runShellcheckText(cwd, readOnly, scopeFiles) {
 /**
  * Detector text/run-shellcheck: read-only shellcheck по `ctx.files` (delta) або по всіх `*.sh` (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 scopeFiles = ctx.files === undefined ? undefined : ctx.files.filter(f => SH_EXT_RE.test(f))
   if (scopeFiles !== undefined && scopeFiles.length === 0) return reporter.result()
 
-  const code = runShellcheckText(ctx.cwd, true, scopeFiles)
+  const code = await runShellcheckText(ctx.cwd, true, scopeFiles)
   if (code !== 0) fail('shellcheck знайшов порушення у *.sh (text.mdc)', 'shellcheck')
   return reporter.result()
 }
@@ -156,22 +150,19 @@ export function lint(ctx) {
  * @param {string} patchBin абсолютний шлях до patch
  * @param {string} root абсолютний робочий каталог (cwd для spawn)
  * @param {string} rel відносний шлях файла від `root`
- * @returns {number} 0 — OK; 1 — помилка spawn або patch
+ * @returns {Promise<number>} 0 — OK; 1 — помилка spawn або patch
  */
-function autofixOneFile(shellcheck, patchBin, root, rel) {
+async function autofixOneFile(shellcheck, patchBin, root, rel) {
   for (let round = 0; round < MAX_FIX_ROUNDS_PER_FILE; round++) {
-    const diffResult = spawnSync(shellcheck, ['-f', 'diff', rel], {
-      cwd: root,
-      encoding: 'utf8',
-      env: process.env,
-      maxBuffer: 10 * 1024 * 1024
-    })
-    if (diffResult.error) {
-      process.stderr.write(`${diffResult.error.message}\n`)
+    let diffResult
+    try {
+      diffResult = await spawnAsync(shellcheck, ['-f', 'diff', rel], { cwd: root, env: process.env })
+    } catch (error) {
+      process.stderr.write(`${error.message}\n`)
       return 1
     }
     if (shouldStopAutofixLoop(diffResult)) return 0
-    const patchCode = applyShellcheckDiff(patchBin, root, rel, diffResult.stdout ?? '')
+    const patchCode = await applyShellcheckDiff(patchBin, root, rel, diffResult.stdout ?? '')
     if (patchCode !== 0) return patchCode
   }
   return 0
@@ -180,11 +171,11 @@ function autofixOneFile(shellcheck, patchBin, root, rel) {
 /**
  * Чи треба зупинити цикл авто-фіксів: shellcheck повернув 0, або у stderr є пометка
  * `none were auto-fixable`, або stdout порожній (нема дифу для застосування).
- * @param {{ status: number | null, stdout?: string | null, stderr?: string | null }} diffResult результат spawnSync
+ * @param {{ exitCode: number | null, stdout?: string | null, stderr?: string | null }} diffResult результат `spawnAsync`
  * @returns {boolean} true — більше нічого фіксити
  */
 function shouldStopAutofixLoop(diffResult) {
-  const code = diffResult.status ?? 1
+  const code = diffResult.exitCode ?? 1
   if (code === 0) return true
   const out = (diffResult.stdout ?? '').trim()
   const err = (diffResult.stderr ?? '').trim()
@@ -198,16 +189,18 @@ function shouldStopAutofixLoop(diffResult) {
  * @param {string} root cwd для spawn
  * @param {string} rel відносний шлях для повідомлення про помилку
  * @param {string} diffStdout вміст unified-diff від shellcheck (input для patch)
- * @returns {number} 0 — застосовано; 1 — помилка
+ * @returns {Promise<number>} 0 — застосовано; 1 — помилка
  */
-function applyShellcheckDiff(patchBin, root, rel, diffStdout) {
-  const patchRun = spawnSync(patchBin, ['-p1'], {
-    cwd: root,
-    input: diffStdout,
-    encoding: 'utf8',
-    env: process.env
-  })
-  if (patchRun.status === 0) return 0
+async function applyShellcheckDiff(patchBin, root, rel, diffStdout) {
+  let patchRun
+  try {
+    patchRun = await spawnAsync(patchBin, ['-p1'], { cwd: root, input: diffStdout, env: process.env })
+  } catch (error) {
+    process.stderr.write(`${error.message}\n`)
+    process.stderr.write(`run-shellcheck-text: patch не застосував diff для ${rel}\n`)
+    return 1
+  }
+  if (patchRun.exitCode === 0) return 0
   if (patchRun.stderr?.length) process.stderr.write(patchRun.stderr)
   if (patchRun.stdout?.length) process.stderr.write(patchRun.stdout)
   process.stderr.write(`run-shellcheck-text: patch не застосував diff для ${rel}\n`)
@@ -220,26 +213,22 @@ function applyShellcheckDiff(patchBin, root, rel, diffStdout) {
  * @param {string} shellcheck абсолютний шлях до shellcheck
  * @param {string[]} files відносні шляхи файлів для перевірки
  * @param {string} root cwd для spawn
- * @returns {number} 0 — чисто; 1 — помилка spawn або зауваження shellcheck
+ * @returns {Promise<number>} 0 — чисто; 1 — помилка spawn або зауваження shellcheck
  */
-function runFinalShellcheck(shellcheck, files, root) {
-  const finalRun = spawnSync(shellcheck, files, {
-    cwd: root,
-    encoding: 'utf8',
-    env: process.env,
-    maxBuffer: 10 * 1024 * 1024,
-    stdio: ['ignore', 'pipe', 'pipe']
-  })
-  if (finalRun.error) {
-    process.stderr.write(`${finalRun.error.message}\n`)
+async function runFinalShellcheck(shellcheck, files, root) {
+  let finalRun
+  try {
+    finalRun = await spawnAsync(shellcheck, files, { cwd: root, env: process.env })
+  } catch (error) {
+    process.stderr.write(`${error.message}\n`)
     return 1
   }
-  if (finalRun.status === 0) return 0
+  if (finalRun.exitCode === 0) return 0
   if (finalRun.stdout?.length) process.stdout.write(finalRun.stdout)
   if (finalRun.stderr?.length) process.stderr.write(finalRun.stderr)
   return 1
 }
 
 if (isRunAsCli(import.meta.url)) {
-  process.exitCode = runShellcheckText()
+  process.exitCode = await runShellcheckText()
 }

package/rules/text/run-v8r/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/text/run-v8r/main.mjs
 docgen:
-  crc: 5c8aab7b
+  crc: 7abeb17f
   model: manual
 ---