@nitra/cursor 12.11.0 → 12.11.2

package/rules/k8s/policy/lint_k8s_yml/target.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-k8s.yml" }
+}

package/rules/k8s/policy/lint_k8s_yml/template/lint-k8s.yml.snippet.yml

@@ -0,0 +1,43 @@
+name: Lint K8s
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/k8s/**/*.yaml'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  lint-k8s:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-bun-deps
+
+      - name: Install kubeconform
+        run: |
+          curl -sSL "https://github.com/yannh/kubeconform/releases/download/v0.7.0/kubeconform-linux-amd64.tar.gz" | tar xz
+          sudo mv kubeconform /usr/local/bin/
+
+      - name: Install kubescape
+        run: |
+          curl -s https://raw.githubusercontent.com/kubescape/kubescape/master/install.sh | /bin/bash
+          echo "$HOME/.kubescape/bin" >> $GITHUB_PATH
+
+      - name: Lint K8s
+        run: n-cursor lint k8s --read-only

package/rules/nginx-default-tpl/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/nginx-default-tpl/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл імпортує шаблони, необхідні для функціонування розширення VS Code.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з іншого скрипта.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/nginx-default-tpl/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/rego/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,22 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/rego/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл імпортує визначення шаблонів з іншого модуля. Це забезпечує доступ до необхідних шаблонів для роботи системних компонентів.
+
+## Поведінка
+
+1. Імпортує визначення шаблонів з іншого модуля.
+2. Надає доступ до цих шаблонів для використання в системі.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/rego/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/rust/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,22 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/rust/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл імпортує визначені шаблони з іншого скрипта та надає їх для використання в інших компонентах системи.
+
+## Поведінка
+
+1. Імпортує шаблони з іншого скрипта.
+2. Експортує ці шаблони.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/rust/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/style/js/docs/fix-tooling.md

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: fix-tooling.mjs
+resource: npm/rules/style/js/fix-tooling.mjs
+docgen:
+  crc: d9c7a757
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль T0-autofix впроваджує детерміновані виправлення файлової системи для `style/js/tooling.mjs`. Він створює або доповнює `.stylelintignore` для ігнорування директорії `dist/` та додає `stylelint` до `package.json`, спираючись на `package.json`.
+
+## Поведінка
+
+Поведінка
+
+1. `patterns` виконує детерміновані виправлення файлової системи для конфігурації стилізації.
+2. Перший елемент у `patterns` створює файл `.stylelintignore` у корені робочого каталогу, якщо він не існує. Це робиться для ігнорування директорії `dist/` у процесі стилізації.
+3. Другий елемент у `patterns` додає рядок `dist/` до файлу `.stylelintignore`, якщо він вже існує, але не містить цього шляху. Це забезпечує ігнорування директорії `dist/`.
+4. Третій елемент у `patterns` перевіряє, чи містить конфігурація `package.json` запис про `stylelint`.
+5. Якщо `package.json` не знайдено або є невалідним JSON, виправлення не виконується.
+6. Якщо `stylelint` вже присутній у `package.json`, виправлення не виконується.
+7. Якщо `stylelint` відсутній, він додається до `package.json` із конфігурацією, що посилається на `@nitra/stylelint-config`.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/rules/style/js/fix-tooling.mjs

@@ -0,0 +1,46 @@
+/**
+ * T0-autofix паттерни для `style/js/tooling.mjs` — детерміновані FS-виправлення:
+ * створення або доповнення `.stylelintignore` та додавання `stylelint` до `package.json`.
+ */
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** @type {import('../../../scripts/lib/fix/discover-t0-patterns.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'style-stylelintignore-create',
+    test: out => /\.stylelintignore не існує/.test(out),
+    apply: (_out, cwd) => {
+      writeFileSync(join(cwd, '.stylelintignore'), 'dist/\n', 'utf8')
+      return { ok: true, action: 'створено .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-stylelintignore-dist-add',
+    test: out => /\.stylelintignore не містить рядка dist\//.test(out),
+    apply: (_out, cwd) => {
+      appendFileSync(join(cwd, '.stylelintignore'), '\ndist/\n', 'utf8')
+      return { ok: true, action: 'додано dist/ до .stylelintignore' }
+    }
+  },
+
+  {
+    id: 'style-pkg-stylelint-add',
+    test: out => /Немає конфігу stylelint/.test(out),
+    apply: (_out, cwd) => {
+      const pkgPath = join(cwd, 'package.json')
+      if (!existsSync(pkgPath)) return { ok: false, action: 'package.json не знайдено' }
+      let pkg
+      try {
+        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+      } catch {
+        return { ok: false, action: 'package.json: невалідний JSON' }
+      }
+      if (pkg.stylelint) return { ok: false, action: 'stylelint вже є в package.json' }
+      pkg.stylelint = { extends: '@nitra/stylelint-config' }
+      writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8')
+      return { ok: true, action: 'додано stylelint до package.json' }
+    }
+  }
+]

package/rules/style/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/style/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Завантажує шаблони для виправлення розширень VS Code.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з файлу `../../../../scripts/lib/fix/vscode-ext-add.mjs`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/style/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/tauri/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/tauri/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Цей файл імпортує шаблони, необхідні для модифікації розширень VS Code. Він надає механізм для застосування визначених змін до розширень VS Code.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з файлу `../../../../scripts/lib/fix/vscode-ext-add.mjs`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/tauri/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/text/policy/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,21 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/text/policy/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 319883fc
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Файл імпортує шаблони для виправлення розширень VS Code. Ці шаблони використовуються для корекції розширень.
+
+## Поведінка
+
+1. Імпортує шаблони для виправлення розширень VS Code з файлу `../../../../scripts/lib/fix/vscode-ext-add.mjs`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/text/policy/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/vue/js/docs/packages.md

@@ -8,8 +8,6 @@ docgen:
   score: 100
 ---
 
-## Огляд
-
 Модуль визначає, чи є пакет бібліотекою компонентів Vue, виходячи з даних у `package.json`, `jsconfig.json`, `package-lock.json`, `extensions.json`. Він також перевіряє відповідність усіх пакетів, що залежать від `vue`, критеріям, описаним у `vue.mdc`, і повертає код виходу.
 
 ## Поведінка

package/scripts/docs/index.md

@@ -12,8 +12,6 @@ resource: npm/scripts/
 | [auto-skills.mjs](auto-skills.md)                                                   | JS Module |
 | [build-agents-commands.mjs](build-agents-commands.md)                               | JS Module |
 | [cli-entry.mjs](cli-entry.md)                                                       | JS Module |
-| [coverage-fix-extract.mjs](coverage-fix-extract.md)                                 | JS Module |
-| [coverage-fix.mjs](coverage-fix.md)                                                 | JS Module |
 | [ensure-nitra-cursor-dev-dependencies.mjs](ensure-nitra-cursor-dev-dependencies.md) | JS Module |
 | [hook.mjs](hook.md)                                                                 | JS Module |
 | [post-tool-use-check.mjs](post-tool-use-check.md)                                   | JS Module |

package/scripts/lib/discover-checkable-rules.mjs

@@ -51,6 +51,7 @@ async function listJsConcerns(jsDir) {
     if (!entry.isFile()) continue
     if (!entry.name.endsWith('.mjs')) continue
     if (entry.name.endsWith('.test.mjs')) continue
+    if (entry.name.startsWith('fix-')) continue
     if (entry.name.startsWith('_')) continue
     if (entry.name.startsWith('.')) continue
     const name = entry.name.slice(0, -'.mjs'.length)

package/scripts/lib/docs/discover-checkable-rules.md

@@ -3,167 +3,25 @@ type: JS Module
 title: discover-checkable-rules.mjs
 resource: npm/scripts/lib/discover-checkable-rules.mjs
 docgen:
-  crc: 39016d17
+  crc: 403ab2ee
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
 ---
 
-Модуль `discover-checkable-rules.mjs` — це discovery-шар для CLI-команди `fix`. Його завдання — швидко просканувати файлову структуру каталогу `npm/rules/` та виявити «прогонні» правила, тобто правила, у яких є щонайменше один JS-концерн або policy-концерн. Правила, які складаються тільки з декларативних артефактів (`.mdc` + `auto.md`) без жодного прогонного концерну, відсіюються.
+## Огляд
 
-Виокремлюються два типи концернів:
+Шукає правила, для яких є щось «прогонне» у визначених структурах. Виявляє JS-концерни за шляхами `rules/<id>/js/<concern>.mjs` та Policy-концерни, які мають пару з `<concern>.rego` (зв'язану з конфігурацією `target.json`). Ігнорує файли з префіксом `_` та `*.test.mjs`, а також каталоги `_lib/`. Виконання є швидким скануванням структури (шляхи та назви) без парсингу вмісту.
 
-- **JS concerns** — окремі файли `rules/<id>/js/<concern>.mjs`. Кожен файл — один концерн (flat-конвенція).
-- **Policy concerns** — підкаталоги `rules/<id>/policy/<concern>/`, у яких присутній файл `target.json` (поруч із якого зазвичай лежить `<concern>.rego`).
+## Поведінка
 
-Модуль свідомо не парсить вміст `target.json` і не читає JS-файли — це лише швидкий «структурний» скан (шляхи + назви) без I/O-вмісту. Парсинг покладено на runner.
+discoverOneRule описує набір JS-концернів та policy-концернів для одного каталогу правила, використовуючи шлях до цього каталогу та його ідентифікатор.
+discoverCheckableRules сканує каталог з усіма правилами та повертає список правил, які мають JS-концерни або policy-концерни, фільтруючи ті, що не містять прогонного контенту.
 
-Файли-помічники з префіксом `_` (зокрема каталог `_lib/`), тестові файли `*.test.mjs`, а також приховані файли/каталоги (`.`-префікс) ігноруються.
+## Публічний API
 
-Історичний контекст конвенції розкладки JS-концернів:
+discoverOneRule — створює об'єкт перевірки для одного каталогу правила.
+discoverCheckableRules — знаходити правила у каталозі `rules/`, які мають відповідні скрипти у `js/` або політики у `policy/`.
 
-- `js/<concern>/check.mjs` — версії 1.13.80–1.13.89 (вкладений каталог на концерн);
-- `js/<concern>.mjs` — версії 1.13.90+ (flat: концерн = файл, а не каталог).
+## Гарантії поведінки
 
-Допоміжні файли, тести, шаблони й дані винесені в окремі топ-level папки правила: `js/_lib/`, `tests/`, `templates/`, `data/`.
-
-## Експорти / API
-
-Модуль експортує дві асинхронні функції:
-
-| Експорт                                   | Тип                                                | Призначення                                                                                    |
-| ----------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `discoverOneRule(ruleDir, ruleId)`        | `async (string, string) => Promise<CheckableRule>` | Будує опис одного правила за заданим шляхом каталогу та id, без обходу `rules/`.               |
-| `discoverCheckableRules(bundledRulesDir)` | `async (string) => Promise<CheckableRule[]>`       | Сканує цілий каталог `npm/rules/` і повертає масив правил, для яких є JS- або policy-концерни. |
-
-Внутрішніми (не експортованими) залишаються функції `listJsConcerns` і `listPolicyConcerns`.
-
-### Типи (JSDoc `@typedef`)
-
-```text
-JsConcern        { name: string }                                  // basename файла js/<name>.mjs без розширення
-PolicyConcern    { name: string }                                  // imʼя підкаталогу policy/<name>/
-CheckableRule    {
-                   id: string,                                     // = basename каталогу rules/<id>/
-                   jsConcerns: JsConcern[],                        // алфавітно
-                   policyConcerns: PolicyConcern[],                // алфавітно
-                 }
-```
-
-## Функції
-
-### `listJsConcerns(jsDir)` (internal)
-
-- **Сигнатура:** `async function listJsConcerns(jsDir: string): Promise<JsConcern[]>`
-- **Параметри:**
-  - `jsDir` — абсолютний шлях до каталогу `rules/<id>/js/`.
-- **Повертає:** масив `JsConcern[]`, відсортований алфавітно за `name` через `Array.prototype.toSorted` із компаратором `localeCompare`.
-- **Логіка:**
-  1. Якщо каталог `jsDir` не існує (`existsSync` повертає `false`) — повертається `[]`.
-  2. Читається вміст через `readdir(jsDir, { withFileTypes: true })` — тобто отримуються `Dirent`-обʼєкти з метаінформацією.
-  3. Пропускаються:
-     - сутності, що не є файлом (`!entry.isFile()`);
-     - файли без розширення `.mjs`;
-     - тестові файли `*.test.mjs`;
-     - службові файли з префіксом `_` (наприклад вміст `_lib/`, хоча сам `_lib` як каталог не буде файлом і відсіється раніше);
-     - приховані файли з префіксом `.`.
-  4. Для решти файлів обчислюється `name = entry.name.slice(0, -'.mjs'.length)` — basename без розширення.
-- **Side effects:** лише файлові читання (`existsSync`, `readdir`), без запису.
-
-### `listPolicyConcerns(policyDir)` (internal)
-
-- **Сигнатура:** `async function listPolicyConcerns(policyDir: string): Promise<PolicyConcern[]>`
-- **Параметри:**
-  - `policyDir` — абсолютний шлях до каталогу `rules/<id>/policy/`.
-- **Повертає:** масив `PolicyConcern[]`, відсортований алфавітно за `name`.
-- **Логіка:**
-  1. Якщо `policyDir` не існує — повертається `[]`.
-  2. Читається вміст з `withFileTypes: true`.
-  3. Пропускаються будь-які записи, що не є каталогом, а також приховані каталоги (префікс `.`).
-  4. Для кожного підкаталогу перевіряється наявність файла `target.json` через `existsSync(join(policyDir, entry.name, 'target.json'))`. Якщо `target.json` є — підкаталог зараховується як policy-концерн.
-- **Side effects:** лише файлові читання, без запису.
-
-### `discoverOneRule(ruleDir, ruleId)` (exported)
-
-- **Сигнатура:** `export async function discoverOneRule(ruleDir: string, ruleId: string): Promise<CheckableRule>`
-- **Параметри:**
-  - `ruleDir` — абсолютний шлях до каталогу правила `rules/<id>/`;
-  - `ruleId` — ідентифікатор правила, зазвичай `basename(ruleDir)`. Передається явно, бо функція не виводить його з шляху самостійно.
-- **Повертає:** обʼєкт `CheckableRule` з полями `id`, `jsConcerns`, `policyConcerns`. На відміну від `discoverCheckableRules`, тут не виконується фільтрація «має бути хоч щось» — повертається опис як є (можуть бути порожні масиви концернів).
-- **Логіка:** паралельно (точніше — послідовно `await`-ить) запускає `listJsConcerns(join(ruleDir, 'js'))` і `listPolicyConcerns(join(ruleDir, 'policy'))` та збирає результати в обʼєкт.
-- **Використання:** викликається `runStandardRule`-flow для per-rule entry-point, коли потрібно отримати опис конкретного правила, а не сканувати весь каталог.
-- **Side effects:** лише читання файлової системи.
-
-### `discoverCheckableRules(bundledRulesDir)` (exported)
-
-- **Сигнатура:** `export async function discoverCheckableRules(bundledRulesDir: string): Promise<CheckableRule[]>`
-- **Параметри:**
-  - `bundledRulesDir` — абсолютний шлях до кореневого каталогу всіх правил (зазвичай `npm/rules/`).
-- **Повертає:** масив `CheckableRule[]`, відсортований алфавітно за `id`. Включаються тільки правила, у яких `jsConcerns.length > 0 || policyConcerns.length > 0`.
-- **Логіка:**
-  1. Якщо `bundledRulesDir` не існує — повертається `[]`.
-  2. Читається вміст каталогу з `withFileTypes: true`.
-  3. Пропускаються сутності, які не є каталогом, та приховані каталоги (префікс `.`).
-  4. Для кожного підкаталогу формується `ruleDir = join(bundledRulesDir, entry.name)` і викликається `discoverOneRule(ruleDir, entry.name)`.
-  5. Правила, у яких немає жодного JS- або policy-концерну (декларативні-only), відсіюються.
-- **Side effects:** лише читання файлової системи (без запису, без мережевих викликів).
-
-## Залежності
-
-Виключно зовнішні стандартні модулі Node.js:
-
-- `node:fs` → `existsSync` — синхронна перевірка існування шляху;
-- `node:fs/promises` → `readdir` — асинхронне читання вмісту каталогу (з `withFileTypes: true` повертає `Dirent[]`);
-- `node:path` → `join` — кросплатформова конкатенація шляхів.
-
-Внутрішніх імпортів з інших модулів проєкту немає. Це робить модуль чистим discovery-шаром без бізнес-логіки, що дозволяє безпечно його тестувати ізольовано (потрібна лише підготовлена файлова структура у тимчасовому каталозі).
-
-Зворотні залежності (хто використовує цей модуль): runner-флоу CLI `fix` (зокрема `runStandardRule`), який після discovery читає `target.json` для policy-концернів і виконує JS-концерни.
-
-## Потік виконання / Використання
-
-### Типовий сценарій 1. Повний скан правил для CLI `fix`
-
-```javascript
-import { discoverCheckableRules } from './discover-checkable-rules.mjs'
-
-const rules = await discoverCheckableRules('/abs/path/to/npm/rules')
-for (const rule of rules) {
-  // rule.id, rule.jsConcerns, rule.policyConcerns
-}
-```
-
-Послідовність дій усередині:
-
-1. `discoverCheckableRules` перевіряє існування кореневого каталогу.
-2. Перебирає підкаталоги верхнього рівня (= потенційні правила).
-3. Для кожного підкаталогу викликає `discoverOneRule`, який своєю чергою:
-   - сканує `rules/<id>/js/` через `listJsConcerns`;
-   - сканує `rules/<id>/policy/` через `listPolicyConcerns`;
-4. Якщо знайдено хоч один концерн — правило додається у вихідний масив.
-5. Масив сортується за `id`.
-
-### Типовий сценарій 2. Per-rule entry-point
-
-```javascript
-import { discoverOneRule } from './discover-checkable-rules.mjs'
-
-const rule = await discoverOneRule('/abs/path/to/npm/rules/n-js', 'n-js')
-// rule.id === 'n-js'
-// rule.jsConcerns — список JS-концернів у js/
-// rule.policyConcerns — список policy-концернів у policy/
-```
-
-Цей шлях оминає енумерацію всього `rules/`, що корисно коли id правила вже відомий (наприклад, передано аргументом CLI).
-
-### Гарантії та обмеження
-
-- **Чистота:** функції — read-only (не пишуть у ФС, не виконують код концернів). Це дозволяє безпечно викликати їх повторно.
-- **Сортування:** усі результати алфавітно відсортовані через `toSorted` із `localeCompare`. Це робить вивід детермінованим між запусками й між платформами (хоч порядок `readdir` залежить від ФС).
-- **Толерантність до відсутніх каталогів:** будь-яка з директорій (`rules/`, `js/`, `policy/`) може бути відсутня — повертається порожній масив без помилки.
-- **Тести/хелпери:** файли з префіксом `_` і `*.test.mjs` гарантовано виключаються із JS-концернів.
-- **Що _не_ робиться:** не валідуються імена концернів, не парситься `target.json`, не перевіряється наявність `<name>.rego` поруч із `target.json`. Це робота runner-а.
-
-### Eage cases
-
-- Файл з префіксом `.` у `js/` — пропускається.
-- Підкаталог у `js/` (наприклад `_lib/`) — не є файлом, відсіюється першою перевіркою `entry.isFile()`.
-- Підкаталог у `policy/` без `target.json` — пропускається; наявність `<name>.rego` без `target.json` не зараховується.
-- Порожнє правило (тільки `.mdc`/`auto.md` без `js/` і `policy/`) — не потрапляє у вихід `discoverCheckableRules`, але буде повернене з порожніми масивами в `discoverOneRule`.
+- Read-only: не виконує операцій запису (ФС/БД).

package/scripts/lib/fix/discover-t0-patterns.mjs

@@ -0,0 +1,83 @@
+/**
+ * Discovery T0-autofix паттернів з rule-level `fix-*.mjs` файлів.
+ *
+ * Сканує `npm/rules/{rule}/js/fix-*.mjs` і `npm/rules/{rule}/policy/{concern}/fix-*.mjs`
+ * по всіх правилах, динамічно імпортує кожен і збирає масиви `patterns`.
+ * `t0.mjs` ініціалізує результат через top-level await (один раз при завантаженні модуля).
+ */
+import { existsSync } from 'node:fs'
+import { readdir } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @typedef {{ id: string, test: (output: string) => boolean, apply: (output: string, cwd: string) => Promise<{ok: boolean, action: string}> | {ok: boolean, action: string} }} T0Pattern
+ */
+
+/**
+ * Повертає абсолютні шляхи до `fix-*.mjs` файлів у директорії (плоско, без рекурсії).
+ * @param {string} dir абсолютний шлях до директорії
+ * @returns {Promise<string[]>}
+ */
+async function findFixFiles(dir) {
+  if (!existsSync(dir)) return []
+  const entries = await readdir(dir, { withFileTypes: true })
+  return entries
+    .filter(e => e.isFile() && e.name.startsWith('fix-') && e.name.endsWith('.mjs'))
+    .map(e => join(dir, e.name))
+}
+
+/**
+ * Повертає абсолютні шляхи до `policy/{concern}/fix-*.mjs` у правилі.
+ * @param {string} policyDir абсолютний шлях `rules/{rule}/policy/`
+ * @returns {Promise<string[]>}
+ */
+async function findPolicyFixFiles(policyDir) {
+  if (!existsSync(policyDir)) return []
+  const entries = await readdir(policyDir, { withFileTypes: true })
+  const paths = []
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    paths.push(...(await findFixFiles(join(policyDir, entry.name))))
+  }
+  return paths
+}
+
+/**
+ * Збирає всі T0-паттерни з `fix-*.mjs` файлів усіх правил у `rulesDir`.
+ * @param {string} rulesDir абсолютний шлях до `npm/rules/`
+ * @returns {Promise<T0Pattern[]>} об'єднаний масив паттернів
+ */
+export async function discoverT0Patterns(rulesDir) {
+  if (!existsSync(rulesDir)) return []
+  const ruleEntries = await readdir(rulesDir, { withFileTypes: true })
+  /** @type {T0Pattern[]} */
+  const allPatterns = []
+
+  for (const ruleEntry of ruleEntries) {
+    if (!ruleEntry.isDirectory() || ruleEntry.name.startsWith('.')) continue
+    const ruleDir = join(rulesDir, ruleEntry.name)
+
+    const fixPaths = [
+      ...(await findFixFiles(join(ruleDir, 'js'))),
+      ...(await findPolicyFixFiles(join(ruleDir, 'policy')))
+    ]
+
+    for (const fixPath of fixPaths) {
+      try {
+        const mod = await import(fixPath)
+        if (Array.isArray(mod.patterns)) allPatterns.push(...mod.patterns)
+      } catch (err) {
+        console.error(`[discover-t0-patterns] не вдалося імпортувати ${fixPath}: ${err.message}`)
+      }
+    }
+  }
+
+  // Дедуплікація за id: shared утиліти (напр. vscode-ext-add) re-export'яться з ≥2 правил
+  // і потрапляють у список кілька разів — залишаємо перше входження.
+  const seen = new Set()
+  return allPatterns.filter(p => {
+    if (seen.has(p.id)) return false
+    seen.add(p.id)
+    return true
+  })
+}

package/scripts/lib/fix/docs/discover-t0-patterns.md

@@ -0,0 +1,37 @@
+---
+type: JS Module
+title: discover-t0-patterns.mjs
+resource: npm/scripts/lib/fix/discover-t0-patterns.mjs
+docgen:
+  crc: f2a262bb
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+---
+
+## Огляд
+
+Модуль сканує директорію правил для пошуку файлів `fix-*.mjs`, що містять визначення T0-паттернів. Він динамічно імпортує ці файли з папок `js` та `policy/{concern}` для кожного правила. Ініціалізація результату відбувається за допомогою _top-level await_ у `t0.mjs`. Функція збирає масив об'єктів, що описують усі знайдені паттерни.
+
+## Поведінка
+
+1. Перевіряє існування директорії, вказаної як `rulesDir`. Якщо директорія не існує, повертає порожній масив.
+2. Зчитує список усіх елементів у директорії `rulesDir`.
+3. Для кожного елемента, який є директорією та не починається з крапки, виконується наступне:
+   а. Визначається повний шлях до директорії правила.
+   б. Знаходяться всі файли `fix-*.mjs` у піддиректорії `js` цього правила.
+   в. Знаходяться всі файли `fix-*.mjs` у піддиректоріях `policy/{concern}` цього правила.
+   г. Для кожного знайденого файлу `fix-*.mjs` виконується динамічний імпорт.
+   д. Якщо імпорт успішний, збирається масив `patterns` з імпортованого модуля та додається до загального списку паттернів.
+   е. У разі помилки імпорту, помилка виводиться в консоль, але процес продовжується.
+4. Після обробки всіх правил, виконується дедуплікація загального списку паттернів за їхніми ідентифікаторами.
+5. Повертається фінальний, унікальний масив T0-паттернів.
+
+## Публічний API
+
+discoverT0Patterns — збирає всі T0-паттерни з файлів `fix-*.mjs` у директорії правил.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.