@7n/rules 1.20.0 → 1.20.1

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/rust/check/docs/fix-check.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-check.mjs
 resource: npm/rules/rust/check/fix-check.mjs
 docgen:
-  crc: 02793a78
+  crc: 3bd2ccd0
 ---
 
 ## Огляд

package/rules/rust/check/docs/main.md

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/rust/check/main.mjs
 docgen:
-  crc: bdf1c005
+  crc: 71821b75
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/rust/check/fix-check.mjs

@@ -6,11 +6,11 @@
  * (`deny-config-missing`). clippy не автофіксимо (його `--fix` потенційно небезпечний) — ці
  * порушення й далі йдуть у LLM-ladder. Запис permanent. Відсутній `cargo`/`cargo-deny` → no-op.
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
 import { resolveCmd } from '../../../scripts/utils/resolve-cmd.mjs'
+import { spawnAsync } from '../../../scripts/utils/spawn-async.mjs'
 
 /**
  * Вміст файлу або null, якщо не читається.
@@ -26,13 +26,13 @@ function readOrNull(abs) {
 }
 
 /**
- * Tracked *.rs файли проєкту (через git).
+ * Tracked *.rs файли проєкту (через git). Async (не блокує event loop, ADR 260716-1354).
  * @param {string} cwd корінь
- * @returns {string[]} posix-relative шляхи
+ * @returns {Promise<string[]>} posix-relative шляхи
  */
-function listRsFiles(cwd) {
-  const r = spawnSync('git', ['ls-files', '-z', '--', '*.rs'], { cwd, encoding: 'utf8' })
-  if (r.status !== 0) return []
+async function listRsFiles(cwd) {
+  const r = await spawnAsync('git', ['ls-files', '-z', '--', '*.rs'], { cwd })
+  if (r.exitCode !== 0) return []
   return (r.stdout ?? '').split('\0').filter(Boolean)
 }
 
@@ -42,15 +42,15 @@ export const patterns = [
     id: 'rust-cargo-fmt',
     standalone: true, // §8 Phase 2: apply самостійно перелічує *.rs (git ls-files), cargo fmt сам ре-аналізує
     test: violations => violations.some(v => v.reason === 'cargo-fmt-violation'),
-    apply: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const cargo = resolveCmd('cargo')
       if (!cargo) return { touchedFiles: [] }
-      const files = listRsFiles(ctx.cwd)
+      const files = await listRsFiles(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)]))
-      spawnSync(cargo, ['fmt', '--all'], { cwd: ctx.cwd, encoding: 'utf8', shell: false })
+      await spawnAsync(cargo, ['fmt', '--all'], { cwd: ctx.cwd })
 
       const touchedFiles = abs.filter(a => readOrNull(a) !== before.get(a))
       for (const a of touchedFiles) ctx.recordWrite?.(a)
@@ -62,14 +62,15 @@ export const patterns = [
   {
     id: 'rust-cargo-deny-init',
     test: violations => violations.some(v => v.reason === 'deny-config-missing'),
-    apply: (violations, ctx) => {
+    apply: async (violations, ctx) => {
       const cargo = resolveCmd('cargo')
       if (!cargo) return { touchedFiles: [] }
-      const hasDeny = spawnSync(cargo, ['deny', '--version'], { stdio: 'ignore', shell: false }).status === 0
+      const denyVersionResult = await spawnAsync(cargo, ['deny', '--version'])
+      const hasDeny = denyVersionResult.exitCode === 0
       if (!hasDeny) return { touchedFiles: [] }
 
       const denyConfigPath = join(ctx.cwd, 'deny.toml')
-      spawnSync(cargo, ['deny', 'init'], { cwd: ctx.cwd, encoding: 'utf8', shell: false })
+      await spawnAsync(cargo, ['deny', 'init'], { cwd: ctx.cwd })
       if (!existsSync(denyConfigPath)) return { touchedFiles: [] }
 
       ctx.recordWrite?.(denyConfigPath)

package/rules/rust/check/main.mjs

@@ -2,26 +2,28 @@
  * lint-поверхня rust: read-only detector (cargo fmt --check + clippy -D warnings +
  * cargo deny check licenses). Генерація deny.toml — окремий T0-fix, не в detector-і.
  */
-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'
 
 /**
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string} label назва кроку.
  * @param {string} cargo шлях до бінарника cargo.
  * @param {string[]} args аргументи cargo.
  * @param {string} cwd робочий каталог.
  * @param {(msg: string, reason: string) => void} fail колбек реєстрації порушення.
  * @param {string} reason машиночитна причина порушення.
- * @returns {boolean} true якщо OK
+ * @returns {Promise<boolean>} true якщо OK
  */
-function runCargo(label, cargo, args, cwd, fail, reason) {
-  const r = spawnSync(cargo, args, { cwd, encoding: 'utf8', shell: false })
-  if (r.status === 0) return true
-  const code = typeof r.status === 'number' ? r.status : 1
+async function runCargo(label, cargo, args, cwd, fail, reason) {
+  const r = await spawnAsync(cargo, 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 outTail = out ? `\n${out}` : ''
   fail(`lint-rust: ${label} — помилка (код ${code}, rust.mdc)${outTail}`, reason)
@@ -29,11 +31,12 @@ function runCargo(label, cargo, args, cwd, fail, reason) {
 }
 
 /**
- * Detector rust/check (read-only).
+ * Detector rust/check (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
@@ -49,11 +52,13 @@ export function lint(ctx) {
     return reporter.result()
   }
 
-  if (!runCargo('cargo fmt --check', cargo, ['fmt', '--all', '--', '--check'], cwd, fail, 'cargo-fmt-violation')) {
+  if (
+    !(await runCargo('cargo fmt --check', cargo, ['fmt', '--all', '--', '--check'], cwd, fail, 'cargo-fmt-violation'))
+  ) {
     return reporter.result()
   }
 
-  runCargo(
+  await runCargo(
     'cargo clippy -D warnings',
     cargo,
     ['clippy', '--all-targets', '--all-features', '--', '-D', 'warnings'],
@@ -71,9 +76,10 @@ export function lint(ctx) {
     return reporter.result()
   }
 
-  const hasDeny = spawnSync(cargo, ['deny', '--version'], { stdio: 'ignore', shell: false }).status === 0
+  const denyVersionResult = await spawnAsync(cargo, ['deny', '--version'])
+  const hasDeny = denyVersionResult.exitCode === 0
   if (hasDeny) {
-    runCargo('cargo deny check licenses', cargo, ['deny', 'check', 'licenses'], cwd, fail, 'cargo-deny-violation')
+    await runCargo('cargo deny check licenses', cargo, ['deny', 'check', 'licenses'], cwd, fail, 'cargo-deny-violation')
   }
   // cargo-deny не встановлено → перевірку ліцензій пропущено (старий код — pass)
 

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)

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
 ---
 
 ## Огляд