@nitra/cursor 12.11.0 → 12.11.2

package/scripts/lib/fix/docs/llm-fix-apply.md

@@ -3,27 +3,29 @@ type: JS Module
 title: llm-fix-apply.mjs
 resource: npm/scripts/lib/fix/llm-fix-apply.mjs
 docgen:
-  crc: 62e475fa
+  crc: 49f989ca
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Модуль є спільним ядром для застосування виправлень, згенерованих LLM, використовуючи конформні (`llm-worker.mjs`) та інструментальні (`llm-lint-fix.mjs`) механізми для уникнення дублювання логіки парсингу та застосування змін. Він парсить структуровану відповідь моделі, що містить список змін у форматі `{changes:[{path,content}]}`. Далі, він зчитує вміст файлів, зазначених у цих змінах, та застосовує оновлений вміст до відповідних файлів. Усі операції реалізовані з механізмом fail-safe: при невдачах функції повертають значення помилки (false/null/Err) замість викидання винятків.
+## Огляд
+
+Це спільне ядро LLM-фіксу, призначене для оркестрації процесу застосування змін, згенерованих моделлю. Модуль використовує `llm-worker.mjs` та `llm-lint-fix.mjs` для забезпечення конформності та виконання лінтер-фіксів. Основний функціонал включає: парсинг відповіді LLM за схемою `{changes:[{path,content}]}` (через `parseChangesResponse`), зчитування необхідних файлів (`readFilesForFix`), та безпечне застосування змін (`applyChanges`). Система реалізує механізм fail-safe, перехоплюючи помилки та повертаючи `null` замість винятків для певних сценаріїв. При цьому шляхи `.git` та `node_modules` свідомо ігноруються.
 
 ## Поведінка
 
-parseChangesResponse парсить сирий текст відповіді моделі, щоб витягнути структуру змін у форматі патчу або повернути null у разі невдачі парсингу.
-readFilesForFix зчитує вміст файлів, зазначених у списку відносних шляхів, відносно кореня проєкту, повертаючи список об'єктів з шляхом та вмістом або null для неіснуючих файлів.
-applyChanges записує нові вмісти в файли, використовуючи наданий список змін, відносно кореня проєкту; перед записом створює батьківську теку (`mkdirSync recursive`) — модель може запропонувати новий файл у ще неіснуючому каталозі. Повертає статус успіху або помилки.
+parseChangesResponse парсить сирий текст відповіді моделі, витягуючи структуру змін у форматі патчу, або повертає null, якщо парсинг неможливий.
+readFilesForFix читає вміст файлів, вказаних у списку, відносно кореня проєкту. Якщо прямий шлях не знайдено, шукає файл за його базовим ім'ям у проєкті, ігноруючи каталоги `.git` та `node_modules`.
+applyChanges записує вміст, наданий у змінних, у відповідні файли проєкту, створюючи необхідні каталоги, якщо вони відсутні.
 
 ## Публічний API
 
-parseChangesResponse — витягує структуру змін із JSON-відповіді моделі.
-readFilesForFix — зчитує вміст файлів за заданими шляхами для використання у запиті.
-applyChanges — замінює вміст файлів на нові дані, отримані у змінних змін.
+parseChangesResponse — розбирає JSON-відповідь моделі, витягуючи вміст першого об'єкта.
+readFilesForFix — зчитує вміст файлів за заданими шляхами, шукаючи їх у системі, якщо прямий шлях не знайдено.
+applyChanges — замінює вміст файлів на новий, наданий у змінній `changes`.
 
 ## Гарантії поведінки
 
 - Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
-- Не звертається до мережі.
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
+- Свідомо пропускає шляхи: `.git`, `node_modules`.

package/scripts/lib/fix/docs/llm-worker.md

@@ -3,32 +3,24 @@ type: JS Module
 title: llm-worker.mjs
 resource: npm/scripts/lib/fix/llm-worker.mjs
 docgen:
-  crc: d6c0b516
+  crc: 55419474
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль взаємодіє з мовною моделлю для обробки правил та файлів. Він формує запит до моделі, отримує пропозиції щодо змін, які не застосовуються до файлової системи. Функція обробки гарантує перехоплення помилок (fail-safe) та не генерує винятків назовні.
+Модуль виділяє унікальні відносні шляхи файлів, пов'язаних із порушеннями. Він також виконує роботу з великою мовною моделлю для аналізу даних про порушення, зчитуючи правила та обробляючи відповідні файли.
 
 ## Поведінка
 
-1. Викликає runLlmWorker для виправлення однієї проблеми.
-2. Зчитує вміст відповідного файлу правила.
-3. Витягує шляхи до файлів, які порушені, з вихідних даних про порушення.
-4. Зчитує вміст цих файлів.
-5. Формує повний текстовий запит для моделі, включаючи правило, вихідні дані про порушення, вміст файлів та, за наявності, контекст попередньої спроби.
-6. Відправляє цей запит моделі.
-7. У разі помилки при виклику моделі, повертає статус невдачі з деталями помилки.
-8. Якщо модель відповідає, парсить її відповідь, щоб отримати діагноз та список змін.
-9. У разі неможливості розібрати відповідь або відсутності змін, повертає статус невдачі.
-10. Якщо зміни успішно отримані, застосовує ці зміни до файлової системи проєкту.
-11. Повертає результат, що містить статус успіху, список застосованих змін, діагноз та метадані про запит.
+extractFilePaths витягує унікальні відносні шляхи файлів із вихідних даних про порушення, розпізнаючи як явні файли, що потребують виправлення, так і файли, що надають контекст.
+runLlmWorker викликає LLM для виправлення одного порушення, зчитує відповідне правило, аналізує файли, формує промпт, отримує відповідь від моделі та застосовує виправлення.
 
 ## Публічний API
 
-runLlmWorker — виправляє одне порушення правила, використовуючи шаблон C1. Повертає результати виправлення чи діагнозу незалежно від успіху, що дозволяє наступним етапам системи отримувати інформацію про спробу. Поля про міркування та підсумок запиту використовуються для детального виводу в режимі `--full`. Дозволяє перевизначити модель, передати контекст попередніх спроб, позначити джерело виклику та встановити ліміти часу для кожного рівня виконання. Керує обсягом токенів, доступних для процесу мислення.
+extractFilePaths — виділяє відносні шляхи файлів з виводу помилок, обробляючи префікс робочого простору та пріоритетно парсячи рядки, що вказують на необхідність виправлення.
+runLlmWorker — виправляє одне порушення правила за допомогою LLM, повертаючи результати змін чи діагнозу, що слугує інформацією для наступних етапів процесу.
 
 ## Гарантії поведінки
 

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

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль відповідає за управління процесом вирішення порушень. Він будує послідовність тирів ескалації за допомогою `buildLadder`. Функція `parseOrchestratorArgs` визначає бюджет LLM та фільтр правил. Далі, `runOrchestratorCli` виконує процес виправлення правил, послідовно застосовуючи `escalateRule` по тирах до досягнення першого успішного вирішення.
 
 ## Поведінка

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

@@ -3,26 +3,27 @@ type: JS Module
 title: t0.mjs
 resource: npm/scripts/lib/fix/t0.mjs
 docgen:
-  crc: cfb0d5c9
+  crc: 92c9348d
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-Модуль керує автоматичним застосуванням паттернів T0-auto до виводів порушень. Він використовує конфігурації з `extensions.json` та `package-lock.json` для визначення правил. Модуль фільтрує правила, які можуть бути автоматично оброблені, застосовує паттерни за допомогою `applyT0Auto`, а потім запускає повний цикл перевірки для всіх провальних правил через `runT0AutoCli`. Усі операції виконуються з механізмом fail-safe, що запобігає виникненню винятків назовні.
+## Огляд
+
+Модуль забезпечує механізм автоматичного застосування паттернів T0-auto. Він дозволяє відфільтровувати правила, до яких застосовуються ці паттерни, та запускає повний цикл перевірки конформності з автоматичним виправленням через `runT0AutoCli`.
 
 ## Поведінка
 
-Поведінка
-applyT0Auto застосовує всі визначені T0-auto паттерни до одного виводу порушення, повертаючи результат застосування та список виконаних дій.
-filterT0AutoRules повертає список ID правил, для яких існує хоча б один T0-auto паттерн, виходячи з виводу порушення.
-runT0AutoCli запускає T0-auto для всіх провальних правил, повторно перевіряє конформність та виводить підсумок щодо закритого чи незакритого порушень.
+applyT0Auto застосовує всі T0-auto паттерни до одного виявленого порушення, повертаючи результат застосування та список виконаних дій.
+filterT0AutoRules повертає список ID правил, для яких існують відповідні T0-auto паттерни, виходячи з виявлених порушень.
+runT0AutoCli запускає процес T0-auto: виконує перевірку конформності, застосовує T0-auto до порушень, повторно перевіряє змінені правила та виводить підсумок.
 
 ## Публічний API
 
-applyT0Auto — вносить зміни до виводу порушень, використовуючи всі визначені T0-auto шаблони.
-filterT0AutoRules — визначає, які правила мають відповідні T0-auto шаблони, аналізуючи вивід порушень, отриманий з `fix --json`.
-runT0AutoCli — виконує команду `n-cursor fix-t0 [rule...]`, що включає застосування T0-auto до кожного порушення, повторну перевірку check-gate та виведення результату.
+applyT0Auto — застосовує всі T0-auto шаблони до вихідних даних про порушення.
+filterT0AutoRules — визначає і повертає ідентифікатори правил, які мають принаймні один T0-auto шаблон, виходячи з результату `fix --json`.
+runT0AutoCli — виконує команду `n-cursor fix-t0 [rule...]`, яка запускає `fix --json`, застосовує T0-auto до кожного порушення, повторно перевіряє check-gate та виводить звіт.
 
 ## Гарантії поведінки
 
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Read-only: не виконує операцій запису (ФС/БД).

package/scripts/lib/fix/docs/vscode-ext-add.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: vscode-ext-add.mjs
+resource: npm/scripts/lib/fix/vscode-ext-add.mjs
+docgen:
+  crc: 950e9098
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Реалізує Shared T0-autofix паттерн для правил із `vscode_extensions.rego`. Механізм витягує назви розширень із повідомлень про порушення та додає їх до секції `recommendations` у конфігурації `.vscode/extensions.json`, якщо вони відсутні. Паттерн універсальний для правил, що емітують вимогу «recommendations має містити "…"». Функціональність надається через публічні функції `patterns` та забезпечує перехоплення помилок для запобігання виняткам.
+
+## Поведінка
+
+1. Перевіряє, чи повідомлення про порушення містить шаблон, що вказує на необхідність додати рекомендації.
+2. Витягує назви розширень з повідомлення про порушення.
+3. Перевіряє наявність файлу `.vscode/extensions.json` у поточній робочій директорії.
+4. Зчитує вміст `.vscode/extensions.json` та парсить його як JSON.
+5. Ініціалізує список існуючих рекомендацій.
+6. Визначає назви розширень, які потрібно додати, відфільтровувавши ті, що вже присутні.
+7. Якщо є розширення для додавання, оновлює список рекомендацій у парсереному об'єкті.
+8. Записує оновлений JSON-об'єкт назад у `.vscode/extensions.json`.
+9. Повертає результат виконання операції.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/scripts/lib/fix/llm-fix-apply.mjs

@@ -3,8 +3,9 @@
  * під фікс і застосування змін. Використовують і `llm-worker.mjs` (конформність), і
  * `llm-lint-fix.mjs` (per-tool лінтер-фіксери) — щоб не дублювати парс/apply (knip/jscpd).
  */
+import { execSync } from 'node:child_process'
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
+import { basename, dirname, join } from 'node:path'
 
 const JSON_CODE_BLOCK_RE = /```(?:json)?[ \t]{0,8}\n?([\s\S]*?)```/
 
@@ -39,8 +40,30 @@ export function parseChangesResponse(text) {
   return null
 }
 
+/**
+ * Шукає файл за basename у дереві проєкту (fallback коли прямий шлях не існує).
+ * Повертає відносний шлях якщо знайдено рівно один матч, інакше `null` (ambiguous/not found).
+ * @param {string} name basename файлу
+ * @param {string} projectRoot абсолютний корінь
+ * @returns {string|null} відносний шлях або null
+ */
+function findByBasename(name, projectRoot) {
+  try {
+    const raw = execSync(
+      `find . -maxdepth 7 -name '${name.replace(/'/g, "'\\''")}' -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/.worktrees/*'`,
+      { cwd: projectRoot, encoding: 'utf8', timeout: 3000 }
+    ).trim()
+    const hits = raw.split('\n').filter(Boolean)
+    return hits.length === 1 ? hits[0].replace(/^\.\//, '') : null
+  } catch {
+    return null
+  }
+}
+
 /**
  * Читає існуючі файли за відносними шляхами у форму `{path, content}` (для prompt).
+ * Якщо файл не знайдений за прямим шляхом — намагається знайти за basename через `find`.
+ * Повертає resolved path (може відрізнятись від вхідного коли `find` знайшов реальне місце).
  * @param {string[]} filePaths відносні шляхи від кореня
  * @param {string} projectRoot абсолютний корінь
  * @returns {Array<{path:string, content:string}>} наявні файли з вмістом
@@ -48,10 +71,18 @@ export function parseChangesResponse(text) {
 export function readFilesForFix(filePaths, projectRoot) {
   return filePaths
     .map(p => {
-      const abs = join(projectRoot, p)
+      let abs = join(projectRoot, p)
+      let resolvedPath = p
+      if (!existsSync(abs)) {
+        const found = findByBasename(basename(p), projectRoot)
+        if (found) {
+          resolvedPath = found
+          abs = join(projectRoot, found)
+        }
+      }
       if (!existsSync(abs)) return null
       try {
-        return { path: p, content: readFileSync(abs, 'utf8') }
+        return { path: resolvedPath, content: readFileSync(abs, 'utf8') }
       } catch {
         return null
       }

package/scripts/lib/fix/llm-worker.mjs

@@ -18,35 +18,44 @@ const DEFAULT_THINKING_BUDGET = Number(env.N_CURSOR_OMLX_THINKING_BUDGET ?? 4096
 
 const API_KEY_RE = /api key/i
 
+const FILE_EXTS = 'json|js|mjs|ts|vue|yml|yaml|toml|mdc|md|sh|py'
+
 /**
  * Витягує відносні шляхи файлів із violation output.
  * Розуміє workspace-prefix: `[npm] skills/foo.mjs` → `npm/skills/foo.mjs`.
+ * Спочатку явно парсить рядки ❌ (найвищий сигнал — файл потребує фіксу),
+ * потім підхоплює решту файлів generic-regex (контекст для читання).
  * @param {string} output violation output з fix check
  * @returns {string[]} унікальні відносні шляхи (від кореня проєкту)
  */
-function extractFilePaths(output) {
+export function extractFilePaths(output) {
   const seen = new Set()
   const results = []
-
-  // Патерн з workspace: [npm] skills/foo.mjs або [demo] src/bar.ts
-  const wsRe = /\[([\w-]+)\]\s+([\w./][\w./-]*\.(?:json|js|mjs|ts|vue|yml|yaml|toml|mdc|md|sh|py))(?::\d+)?/gm
-  for (const m of output.matchAll(wsRe)) {
-    const p = `${m[1]}/${m[2]}`
+  const add = p => {
     if (!seen.has(p)) {
       seen.add(p)
       results.push(p)
     }
   }
 
-  // Патерн без workspace: просто path/to/file.ext або ./file.ext
-  const re = /(?:^|\s)(\.?\w[\w./-]*\.(?:json|js|mjs|ts|vue|yml|yaml|toml|mdc|md|sh|py))(?::\d+)?/gm
-  for (const m of output.matchAll(re)) {
-    const p = m[1]
-    if (!seen.has(p)) {
-      seen.add(p)
-      results.push(p)
-    }
-  }
+  // 1. Явні рядки ❌ — найвищий сигнал: саме ці файли потребують фіксу.
+  //    Формати: `❌ [ws] path/file.ext:line — msg` та `❌ path/file.ext: msg`
+  //    Роздільник після шляху: `:` (з пробілом або цифрою), `—` (em-dash), або кінець рядка.
+  const failSep = `(?::\\d+)?(?::\\s|[\\s—]|$)`
+  const failWsRe = new RegExp(`^\\s*❌\\s+\\[([\\w-]+)\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
+  for (const m of output.matchAll(failWsRe)) add(`${m[1]}/${m[2]}`)
+
+  const failRe = new RegExp(`^\\s*❌\\s+(\\.?[\\w][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
+  for (const m of output.matchAll(failRe)) add(m[1])
+
+  // 2. Generic-regex: підхоплює файли з ✅-рядків та описів (контекст для читання).
+  //    Workspace: [npm] skills/foo.mjs
+  const wsRe = new RegExp(`\\[([\\w-]+)\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))(?::\\d+)?`, 'gm')
+  for (const m of output.matchAll(wsRe)) add(`${m[1]}/${m[2]}`)
+
+  //    Без workspace: path/to/file.ext або ./file.ext
+  const re = new RegExp(`(?:^|\\s)(\\.?\\w[\\w./-]*\\.(?:${FILE_EXTS}))(?::\\d+)?`, 'gm')
+  for (const m of output.matchAll(re)) add(m[1])
 
   return results
 }

package/scripts/lib/fix/t0.mjs

@@ -1,123 +1,14 @@
 /** @see ./docs/t0.md */
-import { spawnSync } from 'node:child_process'
-import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
+import { discoverT0Patterns } from './discover-t0-patterns.mjs'
 import { runConformanceCheck } from './run-conformance-check.mjs'
-import { writeChange } from '../../../rules/release/change.mjs'
-
-const REC_REQUIRE_RE = /recommendations має містити "[^"]+"/
-const REC_MATCH_ALL_RE = /recommendations має містити "([^"]+)"/g
-const FORBIDDEN_FILE_RE = /Знайдено заборонений файл: \S+/
-const FORBIDDEN_FILE_MATCH_ALL_RE = /Знайдено заборонений файл: (\S+)/g
-// Конформність changelog: «<ws>: є релевантні зміни, але немає change-файлу».
-const MISSING_CHANGE_RE = /є релевантні зміни, але немає change-файлу/
-const MISSING_CHANGE_MATCH_ALL_RE = /(?:^|\s)([\w./@-]+): є релевантні зміни, але немає change-файлу/gm
-/** Дефолти autofix-створеного change-файлу (узгоджено з n-changelog.mdc / consistency.mjs). */
-const CHANGE_BUMP = 'patch'
-const CHANGE_SECTION = 'Changed'
-const CHANGE_FALLBACK_MESSAGE = 'оновлення'
 
-/**
- * Опис для авто-створеного change-файлу: subject останнього коміту, інакше fallback.
- * @param {string} cwd корінь репозиторію
- * @returns {string} непорожній опис
- */
-function autoChangeMessage(cwd) {
-  const r = spawnSync('git', ['log', '-1', '--format=%s'], { cwd, encoding: 'utf8' })
-  const subject = r.status === 0 ? (r.stdout ?? '').trim() : ''
-  return subject || CHANGE_FALLBACK_MESSAGE
-}
-
-/**
- * Патерни T0-auto.
- * Кожен паттерн: {
- *   id:      string         — унікальна назва паттерну (для логу)
- *   test:    (output)=>bool — чи підходить цей output до паттерну
- *   apply:   (match, cwd)=>{ ok: bool, action: string } — застосувати фікс
- * }
- */
-const PATTERNS = [
-  // ── vscode-ext-add ──────────────────────────────────────────────────────────
-  // Violation: «recommendations має містити "tsandall.opa"»
-  // Fix: додати рядок у .vscode/extensions.json#recommendations
-  {
-    id: 'vscode-ext-add',
-    test: out => REC_REQUIRE_RE.test(out),
-    apply: (out, cwd) => {
-      const matches = [...out.matchAll(REC_MATCH_ALL_RE)]
-      if (matches.length === 0) return { ok: false, action: 'no match' }
-
-      const extPath = join(cwd, '.vscode/extensions.json')
-      if (!existsSync(extPath)) {
-        return { ok: false, action: '.vscode/extensions.json не знайдено' }
-      }
-
-      let parsed
-      try {
-        parsed = JSON.parse(readFileSync(extPath, 'utf8'))
-      } catch {
-        return { ok: false, action: '.vscode/extensions.json: невалідний JSON' }
-      }
-
-      const recs = Array.isArray(parsed.recommendations) ? parsed.recommendations : []
-      const toAdd = matches.map(m => m[1]).filter(e => !recs.includes(e))
-      if (toAdd.length === 0) return { ok: false, action: 'вже є' }
-
-      parsed.recommendations = [...recs, ...toAdd]
-      writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
-      return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
-    }
-  },
-
-  // ── rm-forbidden-file ────────────────────────────────────────────────────────
-  // Violation: «Знайдено заборонений файл: package-lock.json»
-  // Fix: видалити файл
-  {
-    id: 'rm-forbidden-file',
-    test: out => FORBIDDEN_FILE_RE.test(out),
-    apply: (out, cwd) => {
-      const matches = [...out.matchAll(FORBIDDEN_FILE_MATCH_ALL_RE)]
-      if (matches.length === 0) return { ok: false, action: 'no match' }
-
-      const removed = []
-      for (const m of matches) {
-        const filePath = join(cwd, m[1])
-        if (existsSync(filePath)) {
-          rmSync(filePath, { force: true })
-          removed.push(m[1])
-        }
-      }
-      if (removed.length === 0) return { ok: false, action: 'файлів не знайдено' }
-      return { ok: true, action: `видалено: ${removed.join(', ')}` }
-    }
-  },
-
-  // ── changelog-create-change-file ─────────────────────────────────────────────
-  // Violation: «<ws>: є релевантні зміни, але немає change-файлу»
-  // Fix: створити change-файл через канонічну `writeChange` (без LLM) — той самий
-  // механізм, що autofix changelog-конформності. Прибирає ескалацію в хмару на цьому кейсі.
-  {
-    id: 'changelog-create-change-file',
-    test: out => MISSING_CHANGE_RE.test(out),
-    apply: async (out, cwd) => {
-      const workspaces = Array.from(out.matchAll(MISSING_CHANGE_MATCH_ALL_RE), m => m[1])
-      if (workspaces.length === 0) return { ok: false, action: 'no match' }
-
-      const message = autoChangeMessage(cwd)
-      const created = []
-      for (const ws of workspaces) {
-        try {
-          const rel = await writeChange({ bump: CHANGE_BUMP, section: CHANGE_SECTION, message, ws, cwd })
-          created.push(ws === '.' ? rel : join(ws, rel))
-        } catch (error) {
-          return { ok: false, action: `writeChange ${ws}: ${error.message}` }
-        }
-      }
-      return { ok: true, action: `створено change-файл (${CHANGE_BUMP}/${CHANGE_SECTION}): ${created.join(', ')}` }
-    }
-  }
-]
+// Паттерни живуть у rule-level fix-*.mjs файлах; агрегуємо тут через discovery.
+// Top-level await: ініціалізація один раз при завантаженні модуля.
+const RULES_DIR = join(dirname(fileURLToPath(import.meta.url)), '../../../rules')
+const PATTERNS = await discoverT0Patterns(RULES_DIR)
 
 /**
  * Застосовує всі T0-auto паттерни до одного violation-output.
@@ -135,9 +26,7 @@ export async function applyT0Auto(ruleId, violationOutput, cwd) {
     // Патерн може бути sync ({ok,action}) або async (Promise) — await нормалізує обидва.
     const result = await p.apply(violationOutput, cwd)
     actions.push(`[${p.id}] ${result.action}`)
-    if (result.ok) {
-      applied = true
-    }
+    if (result.ok) applied = true
   }
 
   return { applied, actions }

package/scripts/lib/fix/vscode-ext-add.mjs

@@ -0,0 +1,45 @@
+/**
+ * Shared T0-autofix паттерн для правил із `vscode_extensions.rego`.
+ * Читає назву розширення з violation-message і додає його до
+ * `.vscode/extensions.json#recommendations`.
+ *
+ * Не прив'язаний до конкретного правила — один механізм для всіх правил,
+ * що емітують «recommendations має містити "…"».
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const REC_REQUIRE_RE = /recommendations має містити "[^"]+"/
+const REC_MATCH_ALL_RE = /recommendations має містити "([^"]+)"/g
+
+/** @type {import('./discover-t0-patterns.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'vscode-ext-add',
+    test: out => REC_REQUIRE_RE.test(out),
+    apply: (out, cwd) => {
+      const matches = [...out.matchAll(REC_MATCH_ALL_RE)]
+      if (matches.length === 0) return { ok: false, action: 'no match' }
+
+      const extPath = join(cwd, '.vscode/extensions.json')
+      if (!existsSync(extPath)) {
+        return { ok: false, action: '.vscode/extensions.json не знайдено' }
+      }
+
+      let parsed
+      try {
+        parsed = JSON.parse(readFileSync(extPath, 'utf8'))
+      } catch {
+        return { ok: false, action: '.vscode/extensions.json: невалідний JSON' }
+      }
+
+      const recs = Array.isArray(parsed.recommendations) ? parsed.recommendations : []
+      const toAdd = matches.map(m => m[1]).filter(e => !recs.includes(e))
+      if (toAdd.length === 0) return { ok: false, action: 'вже є' }
+
+      parsed.recommendations = [...recs, ...toAdd]
+      writeFileSync(extPath, JSON.stringify(parsed, null, 2) + '\n', 'utf8')
+      return { ok: true, action: `додано до extensions.json: ${toAdd.join(', ')}` }
+    }
+  }
+]