@nitra/cursor 12.16.2 → 12.18.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [12.18.0] - 2026-06-28
+
+### Changed
+
+- Видалено escalation-лог та його тести, оптимізовано pi-agent-fix та orchestrator
+
+### Fixed
+
+- CLI lint: не відкидати перший позиційний rule-аргумент, коли `--cwd` не передано
+
+## [12.17.0] - 2026-06-27
+
+### Changed
+
+- Перехід на globby для обходу файлової системи з урахуванням .gitignore
+
 ## [12.16.2] - 2026-06-27
 
 ### Changed

package/bin/n-cursor.js

@@ -1518,7 +1518,7 @@ try {
       // прогнати лише конформність цих правил, без лінтер-скану (мапить колишній `fix <rule>`).
       const cwdIdx = args.indexOf('--cwd')
       const cwdArg = cwdIdx !== -1 ? resolve(args[cwdIdx + 1]) : undefined
-      const rules = args.filter((a, i) => !a.startsWith('-') && i !== cwdIdx + 1)
+      const rules = args.filter((a, i) => !a.startsWith('-') && !(cwdIdx !== -1 && i === cwdIdx + 1))
       process.exitCode = await runLint({
         full: args.includes('--full'),
         readOnly: args.includes('--read-only'),

package/lib/docs/pi-agent-fix.md

@@ -3,7 +3,7 @@ type: JS Module
 title: pi-agent-fix.mjs
 resource: npm/lib/pi-agent-fix.mjs
 docgen:
-  crc: 4cf083e2
+  crc: 3e849981
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---

package/lib/pi-agent-fix.mjs

@@ -243,7 +243,7 @@ export async function runPiAgentFix(ruleId, violation, cwd, opts = {}) {
     rung: tier,
     model: modelSpec,
     cwd,
-    // ВХІД LLM (щоб «що подали» було видно у trace, без розкопок escalation-log):
+    // ВХІД LLM (щоб «що подали» було видно прямо у trace):
     // violation — обрізаний (може бути великим); promptChars — повний розмір промпта.
     violation: typeof violation === 'string' ? violation.slice(0, 4000) : null,
     violationChars: typeof violation === 'string' ? violation.length : 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.16.2",
+  "version": "12.18.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/rules/js/js/data/tooling/oxlint-canonical.json

@@ -12,7 +12,7 @@
     "e18e/prefer-nullish-coalescing": "deny",
     "e18e/prefer-spread-syntax": "deny",
     "e18e/prefer-url-canparse": "deny",
-    "e18e/ban-dependencies": "deny",
+    "e18e/ban-dependencies": ["deny", { "allowed": ["globby"] }],
     "e18e/prefer-array-from-map": "deny",
     "e18e/prefer-timer-args": "deny",
     "e18e/prefer-static-regex": "deny",

package/scripts/auto-rules.mjs

@@ -16,10 +16,13 @@
  * їх у конфіг із поправкою на legacy-id (`migrateRuleIds`).
  */
 import { readdirSync } from 'node:fs'
-import { readdir, readFile } from 'node:fs/promises'
+import { readFile } from 'node:fs/promises'
 import { basename, dirname, join, relative } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
+import { globby } from 'globby'
+
+import { ALWAYS_IGNORE } from './utils/walkDir.mjs'
 import { globToRegex } from '../rules/npm-module/js/package_structure.mjs'
 import { textHasBunSqlImport } from '../rules/js-bun-db/lib/bun-sql-scan.mjs'
 import {
@@ -84,9 +87,30 @@ export const AUTO_RULE_DEPENDENCIES = Object.freeze(
 
 const HASURA_CONFIG_MARKER = 'metadata_directory: metadata'
 const REGO_RE = /\.rego$/iu
-const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
 const DEFAULT_DISABLED_LIST = Object.freeze([])
 
+/**
+ * Збирає relative-posix шляхи дерева (файли + директорії), **поважаючи `.gitignore`** —
+ * через той самий `globby`-канон, що й `walkDir` (звідси `ALWAYS_IGNORE`). Спільне джерело
+ * для `collectRepoPaths` (Type A glob-матчинг) і `collectAutoRuleFacts` (content-факти).
+ * Раніше тут був ручний `readdir`-обхід із хардкод skip-набором, який ігнорував `.gitignore`
+ * і помилково активував правила на згенерованих артефактах (`coverage/*.png` → image-compress).
+ * @param {string} root абсолютний шлях кореня репозиторію
+ * @returns {Promise<{ files: string[], dirs: string[] }>} relative-posix шляхи файлів і директорій
+ */
+async function collectTreePaths(root) {
+  const opts = { cwd: root, gitignore: true, dot: true, ignore: ALWAYS_IGNORE }
+  try {
+    const [files, dirs] = await Promise.all([
+      globby('**/*', { ...opts, onlyFiles: true }),
+      globby('**/*', { ...opts, onlyDirectories: true })
+    ])
+    return { files, dirs }
+  } catch {
+    return { files: [], dirs: [] }
+  }
+}
+
 /**
  * Чи містить текст джерела імпорт імені `sql` або `SQL` з `"bun"` (після витягування `<script>` у `.vue`).
  * @param {string} content вміст файлу
@@ -224,35 +248,13 @@ export async function collectAutoRuleFacts(root) {
     hasTempoDir: false
   }
 
-  /**
-   * Рекурсивний обхід каталогу з пропуском службових директорій.
-   * @param {string} dir абсолютний шлях каталогу
-   * @returns {Promise<void>}
-   */
-  async function walk(dir) {
-    let entries
-    try {
-      entries = await readdir(dir, { withFileTypes: true })
-    } catch {
-      return
-    }
-
-    for (const entry of entries) {
-      const absPath = join(dir, entry.name)
-      if (entry.isDirectory()) {
-        if (!IGNORED_DIR_NAMES.has(entry.name)) {
-          if (entry.name === 'tempo') {
-            facts.hasTempoDir = true
-          }
-          await walk(absPath)
-        }
-      } else if (entry.isFile()) {
-        await processFileEntry(absPath, root, facts)
-      }
-    }
+  const { files, dirs } = await collectTreePaths(root)
+  if (dirs.some(d => basename(d) === 'tempo')) {
+    facts.hasTempoDir = true
+  }
+  for (const rel of files) {
+    await processFileEntry(join(root, rel), root, facts)
   }
-
-  await walk(root)
   return facts
 }
 
@@ -266,34 +268,8 @@ export async function collectAutoRuleFacts(root) {
  * @returns {Promise<string[]>} шляхи відносно root у posix-форматі
  */
 async function collectRepoPaths(root) {
-  /** @type {string[]} */
-  const out = []
-  /**
-   * Рекурсивний обхід каталогу з пропуском службових директорій.
-   * @param {string} dir каталог
-   * @returns {Promise<void>}
-   */
-  async function walk(dir) {
-    let entries
-    try {
-      entries = await readdir(dir, { withFileTypes: true })
-    } catch {
-      return
-    }
-    for (const entry of entries) {
-      const abs = join(dir, entry.name)
-      if (entry.isDirectory()) {
-        if (!IGNORED_DIR_NAMES.has(entry.name)) {
-          out.push(relative(root, abs).split('\\').join('/'))
-          await walk(abs)
-        }
-      } else if (entry.isFile()) {
-        out.push(relative(root, abs).split('\\').join('/'))
-      }
-    }
-  }
-  await walk(root)
-  return out
+  const { files, dirs } = await collectTreePaths(root)
+  return [...dirs, ...files]
 }
 
 /**

package/scripts/lib/fix/docs/index.md

@@ -9,7 +9,6 @@ resource: npm/scripts/lib/fix/
 | Файл                                                  | Тип       |
 | ----------------------------------------------------- | --------- |
 | [discover-t0-patterns.mjs](discover-t0-patterns.md)   | JS Module |
-| [escalation-log.mjs](escalation-log.md)               | JS Module |
 | [llm-fix-apply.mjs](llm-fix-apply.md)                 | JS Module |
 | [llm-lint-fix.mjs](llm-lint-fix.md)                   | JS Module |
 | [llm-worker.mjs](llm-worker.md)                       | JS Module |

package/scripts/lib/fix/docs/orchestrator.md

@@ -3,7 +3,7 @@ type: JS Module
 title: orchestrator.mjs
 resource: npm/scripts/lib/fix/orchestrator.mjs
 docgen:
-  crc: 49146418
+  crc: c16c34f7
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---

package/scripts/lib/fix/orchestrator.mjs

@@ -3,7 +3,6 @@
 import { env } from 'node:process'
 import { runConformanceCheck } from './run-conformance-check.mjs'
 import { runT0AutoCli } from './t0.mjs'
-import { logEscalation } from './escalation-log.mjs'
 import { runPiAgentFix } from '../../../lib/pi-agent-fix.mjs'
 import { recordFixTelemetry } from '../../../lib/pi-telemetry-store.mjs'
 import { CLOUD_AVG, CLOUD_MIN, LOCAL_MIN } from '../../../lib/pi-model-tiers.mjs'
@@ -112,7 +111,7 @@ function decideAfterFailure(rung, error) {
 /**
  * Проводить ОДНЕ правило по драбині ескалації до першого зеленого re-check.
  * Кожен рунг: виклик worker (з feedback від попереднього) → re-check цього правила →
- * запис у escalation-лог («чи допомогло» + diagnosis). Достроковий вихід — `decideAfterFailure`
+ * persist у глобальний telemetry-стор (`recordFixTelemetry`). Достроковий вихід — `decideAfterFailure`
  * (обрив на no-key, пропуск моделі на systemic) і вичерпаний avg-кеп (залогувати, не мовчки).
  * @param {{ ruleId: string, output: string }} rule провальне правило з violation-output
  * @param {string} cwd корінь проєкту
@@ -121,16 +120,13 @@ function decideAfterFailure(rung, error) {
  *   worker: { runFix: (ruleId: string, violation: string, cwd: string, opts: object) => Promise<object> },
  *   check: (rules: string[], cwd: string) => Promise<{rules: Array<{ruleId:string,ok:boolean,output:string}>}>,
  *   avgBudget: number,
- *   clock?: () => number,
  *   log?: (s: string) => void
- * }} deps інжектовані залежності (worker/check/clock — для тестів)
+ * }} deps інжектовані залежності (worker/check — для тестів)
  * @returns {Promise<{ resolved: boolean, avgUsed: number }>} чи закрито правило і скільки avg-викликів витрачено
  */
 export async function escalateRule(rule, cwd, deps) {
   const { ladder, worker, check, avgBudget } = deps
-  const clock = deps.clock ?? (() => Date.now())
   const log = deps.log ?? (s => console.log(s))
-  const record = base => logEscalation({ ts: new Date(clock()).toISOString(), ruleId: rule.ruleId, ...base })
 
   let feedback = null
   let currentViolation = rule.output
@@ -140,43 +136,20 @@ export async function escalateRule(rule, cwd, deps) {
   // §2-профілактика: violation без actionable ❌ (tool-crash/Usage/шум) → не годуємо
   // агента (інакше флоундерить рунги до timeout). Рапортуємо як non-actionable, не фіксимо.
   if (!hasActionableViolation(rule.output)) {
-    record({
-      rung: -1,
-      tier: 'skip',
-      model: '',
-      withFeedback: false,
-      callOk: false,
-      callError: 'non-actionable violation (нема ❌ — ймовірно check-error/tool-crash)',
-      recheckOk: false,
-      remainingViolation: rule.output,
-      diagnosis: null,
-      ms: 0
-    })
     log(
       `  ⏭️  ${rule.ruleId}: LLM-фікс пропущено — у violation немає ❌-порушень (check-error/tool-crash, не фіксабельне)`
     )
     return { resolved: false, avgUsed: 0 }
   }
 
-  for (const [idx, rung] of ladder.entries()) {
+  for (const rung of ladder) {
     if (skipModels.has(rung.model)) continue
 
-    const common = { rung: idx, tier: rung.tier, model: rung.model, withFeedback: rung.feedback }
     if (rung.isAvg && avgBudget - avgUsed <= 0) {
-      record({
-        ...common,
-        callOk: false,
-        callError: 'cloud-avg cap reached',
-        recheckOk: false,
-        remainingViolation: currentViolation,
-        diagnosis: null,
-        ms: 0
-      })
       log(`  ⏭️  ${rule.ruleId}: ${rung.tier} пропущено (avg-кеп вичерпано)`)
       continue
     }
 
-    const startedAt = clock()
     // self_check (advisory §4+5) — той самий verdict-helper, що й зовнішній re-check.
     const selfCheck = async () => {
       const r = await check([rule.ruleId], cwd)
@@ -207,16 +180,6 @@ export async function escalateRule(rule, cwd, deps) {
       })
     }
 
-    record({
-      ...common,
-      callOk: !res.error,
-      callError: res.error ?? null,
-      recheckOk,
-      remainingViolation: remaining,
-      diagnosis: res.telemetry ? `turns=${res.telemetry.turnCount} tools=${res.telemetry.toolCallCount}` : null,
-      ms: clock() - startedAt
-    })
-
     if (recheckOk) {
       log(`  ✅ ${rung.tier} (${rung.model || 'pi'}): ${rule.ruleId}`)
       return { resolved: true, avgUsed }

package/scripts/lib/rule-predicates.mjs

@@ -8,27 +8,23 @@
  * Сигнатури неоднорідні (одні беруть `facts`, інші — `cwd`/`packageJson`), бо предикати
  * читають різні джерела; виклик диспетчиться в `auto-rules.mjs` за іменем предиката.
  */
-import { readdir, readFile } from 'node:fs/promises'
+import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
+import { findAllPackageJsonPaths } from '../utils/find-package-json-paths.mjs'
 import { getRepositoryUrl } from './rule-meta-helpers.mjs'
 
-const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
-
 /**
  * Чи package.json дерева містить будь-який із зазначених пакетів у dependencies.
+ * Обхід — через `findAllPackageJsonPaths` (на `walkDir`/`globby`), тож **поважає `.gitignore`**
+ * і не зчитує package.json з ігнорованих каталогів (build-артефакти, vendored-копії).
  * @param {string} root корінь репо
  * @param {string[]} keys імена пакетів
  * @returns {Promise<boolean>} true, якщо знайдено хоч один
  */
-function anyDepInTree(root, keys) {
+async function anyDepInTree(root, keys) {
   const wanted = new Set(keys)
-  /**
-   * Чи package.json за `abs` оголошує будь-який пакет із `wanted` у `dependencies`.
-   * @param {string} abs шлях до package.json
-   * @returns {Promise<boolean>} true, якщо знайдено хоч один
-   */
-  async function pkgDeclaresWanted(abs) {
+  for (const abs of await findAllPackageJsonPaths(root, [])) {
     try {
       const deps = JSON.parse(await readFile(abs, 'utf8'))?.dependencies
       if (deps && typeof deps === 'object' && !Array.isArray(deps)) {
@@ -37,70 +33,29 @@ function anyDepInTree(root, keys) {
     } catch {
       /* ігноруємо пошкоджені package.json */
     }
-    return false
   }
-  /**
-   * @param {string} dir каталог обходу
-   * @returns {Promise<boolean>} true, якщо знайдено хоч один пакет
-   */
-  async function walk(dir) {
-    let entries
-    try {
-      entries = await readdir(dir, { withFileTypes: true })
-    } catch {
-      return false
-    }
-    for (const entry of entries) {
-      const abs = join(dir, entry.name)
-      if (entry.isDirectory()) {
-        if (!IGNORED_DIR_NAMES.has(entry.name) && (await walk(abs))) return true
-      } else if (entry.isFile() && entry.name === 'package.json' && (await pkgDeclaresWanted(abs))) {
-        return true
-      }
-    }
-    return false
-  }
-  return walk(root)
+  return false
 }
 
 /**
  * Чи існує вкладений (не кореневий) package.json без `vite` у devDependencies.
+ * Обхід — `findAllPackageJsonPaths` (gitignore-aware), як у `anyDepInTree`.
  * @param {string} root корінь репо
  * @returns {Promise<boolean>} true, якщо знайдено
  */
 async function nestedWithoutVite(root) {
   const rootPkg = join(root, 'package.json')
-  let result = false
-  /**
-   * @param {string} dir каталог
-   * @returns {Promise<void>}
-   */
-  async function walk(dir) {
-    if (result) return
-    let entries
+  for (const abs of await findAllPackageJsonPaths(root, [])) {
+    if (abs === rootPkg) continue
     try {
-      entries = await readdir(dir, { withFileTypes: true })
+      const dev = JSON.parse(await readFile(abs, 'utf8'))?.devDependencies
+      const hasVite = dev && typeof dev === 'object' && !Array.isArray(dev) && Object.hasOwn(dev, 'vite')
+      if (!hasVite) return true
     } catch {
-      return
-    }
-    for (const entry of entries) {
-      if (result) return
-      const abs = join(dir, entry.name)
-      if (entry.isDirectory()) {
-        if (!IGNORED_DIR_NAMES.has(entry.name)) await walk(abs)
-      } else if (entry.isFile() && entry.name === 'package.json' && abs !== rootPkg) {
-        try {
-          const dev = JSON.parse(await readFile(abs, 'utf8'))?.devDependencies
-          const hasVite = dev && typeof dev === 'object' && !Array.isArray(dev) && Object.hasOwn(dev, 'vite')
-          if (!hasVite) result = true
-        } catch {
-          /* пошкоджений package.json не вважаємо vite-проєктом */
-        }
-      }
+      /* пошкоджений package.json не вважаємо vite-проєктом */
     }
   }
-  await walk(root)
-  return result
+  return false
 }
 
 /** Реєстр предикатів: імʼя → реалізація. Виклик за `meta.json.auto.predicate`. */

package/scripts/utils/walkDir.mjs

@@ -4,7 +4,7 @@ import { globby } from 'globby'
 
 // .git ніколи не потрапляє в .gitignore — пропускаємо завжди.
 // node_modules — safety net: проєкт може не мати .gitignore або запускатись поза git-репо.
-const ALWAYS_IGNORE = ['.git/**', 'node_modules/**']
+export const ALWAYS_IGNORE = ['.git/**', 'node_modules/**']
 
 /**
  * Рекурсивно обходить каталог, поважаючи .gitignore (включно з вкладеними).

package/types/bin/n-cursor.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {}
+export {};

package/scripts/lib/fix/docs/escalation-log.md

@@ -1,28 +0,0 @@
----
-type: JS Module
-title: escalation-log.mjs
-resource: npm/scripts/lib/fix/escalation-log.mjs
-docgen:
-  crc: 91898427
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
----
-
-## Огляд
-
-Файл створює append-only JSONL-лог ескалації конформність-фіксу (спека 2026-06-19-fix-escalation-cascade-design). Він фіксує кожен запис на рунг драбини, що включає деталі використаної моделі (`model`), подання зворотного зв'язку (`withFeedback`), результат виклику (`callOk`/`callError`), оцінку, чи допомогло це усунути порушення (`recheckOk`), залишковий `violation` та самоаналіз моделі (`diagnosis`). Цей лог доповнює always-on wire-trace (`lib/pi-trace.mjs`) і формує логіку для join за полем `caller` (`fix:<rule>:<rung>`). Запис відбувається за певним шільною: або через kill-switch `N_CURSOR_FIX_ESCALATION_LOG`, або за явним шляхом, дефолтно у `<cwd>/.n-cursor/fix-escalation.jsonl`.
-
-## Поведінка
-
-Поведінка:
-escalationLogPath визначає шлях до файлу журналу ескалації конформності. Якщо встановлено змінну середовища N_CURSOR_FIX_ESCALATION_LOG, використовується цей шлях; інакше, за замовчуванням, це .n-cursor/fix-escalation.jsonl у поточній робочій директорії.
-logEscalation записує один запис про рунг у JSONL-лог, якщо шлях до логу визначено. Запис містить метадані про спробу фіксування, результати виклику та аналіз. Помилки під час запису логу ігноруються.
-
-## Публічний API
-
-escalationLogPath — вказує на місце зберігання логу ескалацій, якщо функція не вимкнена.
-logEscalation — записує один подію виконання в спеціальний лог у форматі JSONL, ігноруючи внутрішні помилки запису.
-
-## Гарантії поведінки
-
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/scripts/lib/fix/escalation-log.mjs

@@ -1,92 +0,0 @@
-/**
- * Append-only JSONL-лог ескалації конформність-фіксу (спека
- * 2026-06-19-fix-escalation-cascade-design). Один запис **на рунг драбини** —
- * фіксує `model`, `withFeedback`, чи виклик удався (`callOk`/`callError`), чи
- * правило стало зеленим після цього рунга (`recheckOk` = «чи допомогло»),
- * залишковий violation і `diagnosis` (само-аналіз моделі «чому не вдалося»).
- *
- * Це доповнення до always-on wire-trace (`lib/pi-trace.mjs`): trace знає
- * `messages`/`reasoning`/`usage` кожного виклику, але **не** знає результату
- * re-check — а саме «чи допомогло» й потрібне для пост-аналізу драбини. Join із
- * trace — за полем `caller` (`fix:<rule>:<rung>`), яке цей модуль і формує.
- *
- * Шлях — дзеркало `tracePath()`: `N_CURSOR_FIX_ESCALATION_LOG` (kill-switch
- * `0|false|off|no` → не писати; інакше явний шлях) → дефолт
- * `<cwd>/.n-cursor/fix-escalation.jsonl`.
- */
-import { appendFileSync, mkdirSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { cwd, env } from 'node:process'
-
-/** Значення `N_CURSOR_FIX_ESCALATION_LOG`, що вимикають лог повністю. */
-const KILL_VALUES = new Set(['0', 'false', 'off', 'no'])
-
-/** Межа обрізки `remainingViolation`/`diagnosis` у записі (символів). */
-const MAX_FIELD_CHARS = 2000
-
-/**
- * Шлях активного escalation-логу або `null`, якщо вимкнено kill-switch-ем.
- * @returns {string|null} шлях до .jsonl або null
- */
-export function escalationLogPath() {
-  const override = env.N_CURSOR_FIX_ESCALATION_LOG
-  if (override !== undefined) {
-    if (KILL_VALUES.has(override.toLowerCase())) return null
-    if (override) return override
-  }
-  return join(cwd(), '.n-cursor', 'fix-escalation.jsonl')
-}
-
-/**
- * Обрізає рядок до `MAX_FIELD_CHARS` (null/undefined → null).
- * @param {string|null|undefined} s вхід
- * @returns {string|null} обрізаний рядок або null
- */
-function cap(s) {
-  if (s === null || s === undefined) return null
-  return s.length > MAX_FIELD_CHARS ? s.slice(0, MAX_FIELD_CHARS) : s
-}
-
-/**
- * Дописує один запис рунга у JSONL-лог (no-op, якщо вимкнено). Помилки запису
- * ковтаються — лог діагностичний, не має валити сам фікс.
- * @param {object} rec запис рунга
- * @param {string} rec.ts ISO-час завершення рунга
- * @param {string} rec.ruleId id правила
- * @param {number} rec.rung індекс рунга драбини (0-based)
- * @param {string} rec.tier мітка тиру (`local-min`|`local-min-retry`|`cloud-min`|`cloud-avg`)
- * @param {string} rec.model model-id (порожній → pi-дефолт)
- * @param {boolean} rec.withFeedback чи передавався feedback попереднього рунга
- * @param {boolean} rec.callOk чи виклик моделі+apply удався
- * @param {string|null} rec.callError помилка виклику (null, якщо callOk)
- * @param {boolean} rec.recheckOk чи правило стало зеленим після рунга («чи допомогло»)
- * @param {string|null} rec.remainingViolation залишковий violation (null, якщо recheckOk)
- * @param {string|null} rec.diagnosis само-аналіз моделі «чому попередній рунг не вдався»
- * @param {number} rec.ms тривалість рунга (мс)
- * @returns {void}
- */
-export function logEscalation(rec) {
-  const path = escalationLogPath()
-  if (!path) return
-  const line =
-    JSON.stringify({
-      ts: rec.ts,
-      ruleId: rec.ruleId,
-      rung: rec.rung,
-      tier: rec.tier,
-      model: rec.model,
-      withFeedback: rec.withFeedback,
-      callOk: rec.callOk,
-      callError: cap(rec.callError),
-      recheckOk: rec.recheckOk,
-      remainingViolation: rec.recheckOk ? null : cap(rec.remainingViolation),
-      diagnosis: cap(rec.diagnosis),
-      ms: rec.ms
-    }) + '\n'
-  try {
-    mkdirSync(dirname(path), { recursive: true })
-    appendFileSync(path, line, 'utf8')
-  } catch {
-    /* лог діагностичний — ковтаємо помилки запису */
-  }
-}