@7n/rules 1.20.0 → 1.20.1

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

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

@@ -44,7 +44,6 @@
  * незалежно від verbosity) і виводить у stdout окреме попередження на кожен такий файл із порадою
  * додати схему в `npm/schemas/v8r-catalog.json`.
  */
-import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { basename, delimiter, dirname, isAbsolute, join } from 'node:path'
@@ -53,6 +52,7 @@ import { fileURLToPath } from 'node:url'
 
 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'
 
 /** Розширення, які валідує v8r — фільтр delta-списку файлів у `lint(ctx)`. */
@@ -183,31 +183,30 @@ export function stripBunNodeShimDirs(pathValue) {
  * (`lint()`) для вбудовування у violation-повідомлення, яке бачить LLM fix-worker: без нього
  * fix-ladder отримує лише "щось не пройшло" й не має шансів вгадати, що саме (спостережено —
  * усі 4 rung-и незмінно падають у timeout на v8r-порушеннях).
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} targets glob-и або конкретні шляхи файлів
  * @param {string} configPath шлях до `V8R_CONFIG_FILE`
  * @param {boolean} [verbose] друкувати повний raw stdout/stderr v8r при помилці; інакше — лише
  *   рядки `✖ …` без `ℹ`-шуму (Pre-warming the cache, Processing <file>, Found schema in …)
- * @returns {{ exitError: true } | { exitError: false, code: number, detail: string }} помилка
- *   spawn або код v8r (0/98 — трактує викликач) + деталь `✖ …`-рядків
+ * @returns {Promise<{ exitError: true } | { exitError: false, code: number, detail: string }>}
+ *   помилка spawn або код v8r (0/98 — трактує викликач) + деталь `✖ …`-рядків
  */
-function runOneV8rInvocation(targets, configPath, verbose = false) {
+async function runOneV8rInvocation(targets, configPath, verbose = false) {
   const bunPath = resolveCmd('bun') ?? process.execPath
-  const result = spawnSync(bunPath, ['x', 'v8r', ...targets], {
-    encoding: 'utf8',
-    maxBuffer: 50 * 1024 * 1024,
-    shell: false,
-    stdio: ['ignore', 'pipe', 'pipe'],
-    env: { ...env, PATH: stripBunNodeShimDirs(env.PATH), V8R_CONFIG_FILE: configPath }
-  })
-
-  if (result.error) {
-    process.stderr.write(`${result.error.message}\n`)
+  let result
+  try {
+    result = await spawnAsync(bunPath, ['x', 'v8r', ...targets], {
+      env: { ...env, PATH: stripBunNodeShimDirs(env.PATH), V8R_CONFIG_FILE: configPath }
+    })
+  } catch (error) {
+    process.stderr.write(`${error.message}\n`)
     return { exitError: true }
   }
 
   warnAboutRemoteSchemaFallback(result.stderr ?? '')
 
-  const exitCode = result.status ?? 1
+  const exitCode = result.exitCode ?? 1
   let detail = ''
   if (exitCode !== 0 && exitCode !== 98) {
     detail = extractFailureLines(`${result.stdout ?? ''}\n${result.stderr ?? ''}`)
@@ -225,12 +224,15 @@ function runOneV8rInvocation(targets, configPath, verbose = false) {
  * Запускає послідовні виклики v8r по glob-ам (full-режим); не змінює process.exitCode.
  * Один виклик на glob навмисно (не batch) — v8r падає з кодом 98, якщо хоч один переданий
  * glob не знаходить файлів, і тоді решта розширень не перевіряються в тому ж виклику.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354). Виклики по glob-ам лишаються строго послідовними (не Promise.all) — той
+ * самий один-виклик-на-glob підхід, лише блокуючий spawnSync замінено на await у циклі.
  * @param {string[]} [globs] патерни; за замовчуванням DEFAULT_V8R_GLOBS
  * @param {boolean} [verbose] друкувати повний raw вивід v8r при помилці (див. runOneV8rInvocation)
- * @returns {{ code: number, detail: string }} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
+ * @returns {Promise<{ code: number, detail: string }>} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
  *   каталогу схем, інше — код v8r; `detail` — рядки `✖ …` (порожньо, якщо `code` не про валідацію)
  */
-export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
+export async function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
   if (!existsSync(V8R_CATALOG_PATH)) {
     process.stderr.write(
       `run-v8r: не знайдено каталог схем за шляхом ${V8R_CATALOG_PATH} (очікується npm/schemas/v8r-catalog.json у пакеті)\n`
@@ -241,7 +243,7 @@ export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
   const configPath = writeResolvedV8rConfig()
 
   for (const pattern of globs) {
-    const r = runOneV8rInvocation([pattern], configPath, verbose)
+    const r = await runOneV8rInvocation([pattern], configPath, verbose)
     if (r.exitError) return { code: 1, detail: '' }
     if (r.code !== 0 && r.code !== 98) return { code: r.code, detail: r.detail }
   }
@@ -251,12 +253,14 @@ export function runV8rWithGlobs(globs = DEFAULT_V8R_GLOBS, verbose = false) {
 /**
  * Запускає v8r по конкретному списку файлів (delta-режим) — один виклик, не по одному glob-у,
  * бо кожен переданий шлях уже існує (не glob), тож код 98 "порожній glob" тут не виникає.
+ * Async (не блокує event loop) — детектор може виконуватись у parallel lane `detectAll()`
+ * (ADR 260716-1354).
  * @param {string[]} files абсолютні або відносні до cwd v8r-процесу шляхи файлів
  * @param {boolean} [verbose] друкувати повний raw вивід v8r при помилці (див. runOneV8rInvocation)
- * @returns {{ code: number, detail: string }} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
+ * @returns {Promise<{ code: number, detail: string }>} `code`: 0 — OK, 1 — помилка spawn, 2 — немає
  *   каталогу схем, інше — код v8r; `detail` — рядки `✖ …` (порожньо, якщо `code` не про валідацію)
  */
-export function runV8rWithFiles(files, verbose = false) {
+export async function runV8rWithFiles(files, verbose = false) {
   if (files.length === 0) return { code: 0, detail: '' }
   if (!existsSync(V8R_CATALOG_PATH)) {
     process.stderr.write(
@@ -266,7 +270,7 @@ export function runV8rWithFiles(files, verbose = false) {
   }
 
   const configPath = writeResolvedV8rConfig()
-  const r = runOneV8rInvocation(files, configPath, verbose)
+  const r = await runOneV8rInvocation(files, configPath, verbose)
   if (r.exitError) return { code: 1, detail: '' }
   return { code: r.code === 98 ? 0 : r.code, detail: r.detail }
 }
@@ -285,28 +289,29 @@ function v8rFailMessage(detail) {
 /**
  * Detector text/run-v8r: read-only v8r по `ctx.files` (delta) або за дефолтними glob-ами (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 verbose = ctx.verbose === true
 
   if (ctx.files === undefined) {
-    const { code, detail } = runV8rWithGlobs(DEFAULT_V8R_GLOBS, verbose)
+    const { code, detail } = await runV8rWithGlobs(DEFAULT_V8R_GLOBS, verbose)
     if (code !== 0) fail(v8rFailMessage(detail), 'v8r')
     return reporter.result()
   }
 
   const files = ctx.files.filter(f => V8R_EXT_RE.test(f))
   if (files.length === 0) return reporter.result()
-  const { code, detail } = runV8rWithFiles(files, verbose)
+  const { code, detail } = await runV8rWithFiles(files, verbose)
   if (code !== 0) fail(v8rFailMessage(detail), 'v8r')
   return reporter.result()
 }
 
 if (isRunAsCli(import.meta.url)) {
   const globs = process.argv.length > 2 ? process.argv.slice(2) : DEFAULT_V8R_GLOBS
-  process.exitCode = runV8rWithGlobs(globs).code
+  const { code } = await runV8rWithGlobs(globs)
+  process.exitCode = code
 }