@nitra/cursor 1.8.170 → 1.8.173

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.173] - 2026-05-04
+
+### Added
+
+- `.n-cursor.json` поле `ignore` (`schemas/n-cursor.json`): тепер не лише сигнал для AI, а й керує обходом усіх `check-*.mjs` / `run-*.mjs` — перелічені каталоги повністю виключаються з `walkDir`, як `node_modules` чи `.git`. Дозволяє безпечно тримати vendored Helm-чарти, генеровані маніфести, legacy-дерева у репо без false-positive’ів від check-скриптів. Розширено опис у схемі (стандартні виключення додавати не треба) і README отримав секцію «Виключення цілих дерев».
+- `scripts/utils/load-cursor-config.mjs`: нова утиліта `loadCursorIgnorePaths(root)` — читає поле `ignore` з `.n-cursor.json` і нормалізує до абсолютних posix-шляхів без trailing-slash; пропускає не-рядки та порожні елементи; повертає `[]`, якщо файлу/поля нема або JSON невалідний.
+- `scripts/utils/walkDir.mjs`: третій аргумент `ignorePaths` (за замовчуванням `[]`) — каталоги, які пропускаються разом з усім вмістом. Збіг — за повним шляхом (точний або з префіксом `/`), а не за basename, тож `postgres-master-test/` не пропускається коли в ignore лише `postgres-master/`. Стандартні пропуски (`node_modules`, `.git`, `dist`, `coverage`, `.turbo`, `.next`) працюють як раніше.
+
+### Changed
+
+- Усі скрипти, що обходять FS через `walkDir`, тепер на початку `check()` зчитують `loadCursorIgnorePaths(root)` і передають третім аргументом: `check-abie`, `check-docker`, `check-graphql`, `check-hasura`, `check-image`, `check-js-bun-db`, `check-js-mssql`, `check-js-run`, `check-k8s`, `check-nginx-default-tpl`, `check-npm-module`, `check-vue`, плюс `run-docker`, `run-k8s` і `rename-yaml-extensions`. Wrapper-функції (`findDockerfilePaths`, `findK8sYamlFiles`, `findLintDockerfilePaths`, `findK8sRoots`, `findDefaultConfTemplatePaths`, `migrateDefaultTplConfFiles`) отримали опційний параметр `ignorePaths` для прозорого пробросу.
+
+## [1.8.172] - 2026-05-04
+
+### Changed
+
+- `auto-rules.md` / `auto-rules.mjs`: правило `php` тепер автоувімкається за наявністю `composer.json` у корені, а не за будь-яким `*.php` файлом у дереві. Прибрано константу `PHP_RE`, факт `hasPhpSource` і його збір у `updateFileFacts`/`collectAutoRuleFacts`; натомість у `detectAutoRulesAndSkills` додано прапорець `composerJsonExists` (за аналогією з `packageJsonExists` / `npmDirExists`).
+
+## [1.8.171] - 2026-05-04
+
+### Removed
+
+- `abie.mdc` (v1.17) / `check-abie.mjs`: прибрано перевірку `.github/actionlint.yaml` (мітки `self-hosted-runner` `ua` / `dev` / `ru`). Видалено константи `ABIE_REQUIRED_ACTIONLINT_LABELS`, шаблон файлу та функції `parseActionlintSelfHostedLabels`, `abieMissingActionlintLabels`, `ensureAbieActionlintConfig`; знято відповідні юніт- та інтеграційні тести. Файл `.github/actionlint.yaml` більше не створюється і не валідовується правилом abie.
+
 ## [1.8.170] - 2026-05-03
 
 ### Changed

package/README.md

@@ -30,6 +30,20 @@
 
 Щоб використовувати конкретну версію правил, оновіть залежність `@nitra/cursor` у проєкті (`bun add -d @nitra/cursor@<версія>` тощо). Поле `version` у `.n-cursor.json`, якщо воно лишилось у старих конфігах, **ігнорується**.
 
+### Виключення цілих дерев — поле `ignore`
+
+Поле `ignore` у `.n-cursor.json` — список директорій (posix-шляхи відносно кореня репозиторію), які CLI повністю пропускає під час обходу: жоден `check-*.mjs` не сканує і не валідує файли всередині них, а агент не редагує/не створює/не видаляє там файли. Стандартні виключення (`node_modules`, `.git`, `dist`, `coverage`, `.turbo`, `.next`) працюють завжди — додавати їх у `ignore` не потрібно.
+
+Типові кандидати: vendored Helm-чарти, генеровані маніфести, legacy-дерева, які не підтягуються під поточні правила:
+
+```json
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/n-cursor.json",
+  "rules": ["k8s"],
+  "ignore": ["dremio/dev/dremio_v2", "postgres-master"]
+}
+```
+
 ### Правило `k8s` і Kustomize
 
 У цільовому репозиторії з маніфестами під **`**/k8s`** дотримуйтесь **`mdc/k8s.mdc`** з пакету (після синку — `.cursor/rules/n-k8s.mdc`або копія з`node_modules/@nitra/cursor/mdc/k8s.mdc`).

package/bin/auto-rules.md

@@ -36,7 +36,7 @@ nginx-default-tpl - якщо присутній хоч один файл з пе
 
 npm-module - якщо в корені присутня директорія npm
 
-php - якщо присутній хоч один php файл
+php - якщо в корені є composer.json
 
 style-lint - якщо присутній хоч один vue або css файл
 

package/mdc/abie.mdc

@@ -1,10 +1,10 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.16'
+version: '1.17'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, **`.github/actionlint.yaml`** із мітками **`self-hosted-runner`** **ua** / **dev** / **ru** (створюється автоматично за відсутності), а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
+Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -336,18 +336,6 @@ spec:
 
 У **кожному** підкаталозі, що лежить **безпосередньо** в корені репозиторію, не тримати конфіг і кеш **Firebase Hosting**: у таких каталогах не повинно бути **`.firebaserc`**, **`firebase.json`** та каталогу **`.firebase/`** (у **самому** корені репозиторію ці імена перевіркою abie **не** розглядаються; `node_modules` / `.git` зі скану вилучаються).
 
-## actionlint: self-hosted-runner labels
-
-У **`.github/actionlint.yaml`** має бути блок **`self-hosted-runner.labels`** з присутніми мітками **`ua`**, **`dev`**, **`ru`**. Якщо файлу немає — **`npx @nitra/cursor check abie`** створює його з канонічним вмістом. Інші мітки, інший порядок та формат лапок дозволені — перевіряється лише наявність трьох обов'язкових міток (деталі — **`check-abie.mjs`**).
-
-```yaml title=".github/actionlint.yaml"
-self-hosted-runner:
-  labels:
-    - 'ua'
-    - 'dev'
-    - 'ru'
-```
-
 ## Git branches
 
 У **`.github/workflows/clean-merged-branch.yml`** у кроці **`phpdocker-io/github-actions-delete-abandoned-branches`** значення **`with.ignore_branches`** має містити **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно):

package/package.json

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

package/schemas/n-cursor.json

@@ -45,7 +45,7 @@
     },
     "ignore": {
       "type": "array",
-      "description": "Директорії, у яких заборонено будь-які модифікації файлів (AI не редагує, не видаляє, не створює файли). Шляхи відносно кореня репозиторію. Наприклад: [\"packages/vendor\", \"packages/generated\"].",
+      "description": "Директорії, що повністю виключаються з обходу check-скриптів CLI (npx @nitra/cursor check ...) і AI-модифікацій (AI не редагує, не видаляє, не створює файли). Шляхи відносно кореня репозиторію (posix). Приклади: vendored Helm-чарти, генеровані маніфести, legacy-дерева. Стандартні виключення (node_modules, .git, dist, coverage, .turbo, .next) застосовуються завжди — додавати їх не треба.",
       "items": {
         "type": "string",
         "minLength": 1

package/scripts/auto-rules.mjs

@@ -63,7 +63,6 @@ const HASURA_CONFIG_MARKER = 'metadata_directory: metadata'
 const JS_LIKE_RE = /\.(?:mjs|cjs|js|jsx|ts|tsx)$/iu
 const STYLE_RE = /\.(?:css|vue)$/iu
 const VUE_RE = /\.vue$/iu
-const PHP_RE = /\.php$/iu
 const NGINX_DEFAULT_FILES = new Set(['default.conf.template', 'default.conf', 'nginx.conf'])
 const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
 const DEFAULT_DISABLED_LIST = Object.freeze([])
@@ -245,7 +244,6 @@ function updateDirFacts(dirName, facts) {
  *   hasDockerfile: boolean,
  *   hasJsLikeSource: boolean,
  *   hasNginxDefaultTplFile: boolean,
- *   hasPhpSource: boolean,
  *   hasVueOrCssSource: boolean,
  *   hasVueSource: boolean
  * }} facts агреговані факти
@@ -267,9 +265,6 @@ function updateFileFacts(fileName, relPath, facts) {
   if (VUE_RE.test(relPath)) {
     facts.hasVueSource = true
   }
-  if (PHP_RE.test(relPath)) {
-    facts.hasPhpSource = true
-  }
   if (STYLE_RE.test(relPath)) {
     facts.hasVueOrCssSource = true
   }
@@ -452,7 +447,6 @@ export function isMonorepoPackage(packageJson) {
  *   hasK8sDir: boolean,
  *   hasNginxDefaultTplFile: boolean,
  *   hasTempoDir: boolean,
- *   hasPhpSource: boolean,
  *   hasVueSource: boolean,
  *   hasVueOrCssSource: boolean
  * }>} агреговані факти
@@ -469,7 +463,6 @@ export async function collectAutoRuleFacts(root) {
     hasK8sDir: false,
     hasNginxDefaultTplFile: false,
     hasTempoDir: false,
-    hasPhpSource: false,
     hasVueSource: false,
     hasVueOrCssSource: false
   }
@@ -556,6 +549,7 @@ export async function detectAutoRulesAndSkills({
 
   const packageJsonExists = existsSync(join(root, 'package.json'))
   const npmDirExists = existsSync(join(root, 'npm'))
+  const composerJsonExists = existsSync(join(root, 'composer.json'))
   const repositoryUrl = getRepositoryUrl(
     packageJsonParsed && typeof packageJsonParsed === 'object' && !Array.isArray(packageJsonParsed)
       ? /** @type {Record<string, unknown>} */ (packageJsonParsed).repository
@@ -612,7 +606,7 @@ export async function detectAutoRulesAndSkills({
     { enabled: facts.hasK8sDir, id: 'k8s' },
     { enabled: facts.hasNginxDefaultTplFile, id: 'nginx-default-tpl' },
     { enabled: npmDirExists, id: 'npm-module' },
-    { enabled: facts.hasPhpSource, id: 'php' },
+    { enabled: composerJsonExists, id: 'php' },
     { enabled: facts.hasVueOrCssSource, id: 'style-lint' }
   ]
   for (const item of autoRuleChecks) {

package/scripts/check-abie.mjs

@@ -39,7 +39,7 @@
  * у файлі **`k8s/ru/kustomization.yaml`** того ж пакета (overlay середовища **ru**) — inline **JSON6902** на **`kind: Service`** з тим самим **`target.name`**: **`path: /spec/type`**, **`value: NodePort`**; якщо в base було **`spec.clusterIP: None`** — **`op: remove`** для **`/spec/clusterIP`**; якщо в base **явно** задано **`spec.clusterIPs`** — також **`remove`** для **`/spec/clusterIPs`** (інакше **API** може залишити **`None`** для **NodePort**; без ключа **`clusterIPs`** у base **`remove`** на **`/spec/clusterIPs`** ламає **`kubectl kustomize`**).
  */
 import { existsSync } from 'node:fs'
-import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
+import { readdir, readFile } from 'node:fs/promises'
 import { dirname, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
@@ -47,6 +47,7 @@ import { parseAllDocuments } from 'yaml'
 import { pathHasK8sSegment, ruKustomizationHasHealthCheckDeletePatch } from './check-k8s.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 import { flattenWorkflowSteps, getStepUses, parseWorkflowYaml } from './utils/gha-workflow.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const CONFIG_FILE = '.n-cursor.json'
@@ -118,20 +119,6 @@ const HTTPROUTE_BACKENDREF_PORT_8081_VALUE_FIRST_RE =
 /** Гілки, які мають бути в **`ignore_branches`** за abie.mdc. */
 export const ABIE_REQUIRED_IGNORE_BRANCHES = ['dev', 'ua', 'ru']
 
-/** Канонічний шлях до конфігу actionlint у репо (abie.mdc). */
-const ABIE_ACTIONLINT_PATH = '.github/actionlint.yaml'
-
-/** Канонічний вміст **`.github/actionlint.yaml`**, який ми створюємо за відсутності файлу (abie.mdc). */
-const ABIE_ACTIONLINT_TEMPLATE = `self-hosted-runner:
-  labels:
-    - 'ua'
-    - 'dev'
-    - 'ru'
-`
-
-/** Мітки **`self-hosted-runner.labels`**, які мають бути присутні в **`.github/actionlint.yaml`** (abie.mdc). */
-export const ABIE_REQUIRED_ACTIONLINT_LABELS = Object.freeze(['ua', 'dev', 'ru'])
-
 /**
  * Чи відносний шлях вказує на **`ru/kustomization.yaml`** (сегмент **`ru`** перед ім'ям файлу) — специфіка abie overlay.
  * @param {string} rel шлях від кореня репозиторію
@@ -399,18 +386,22 @@ export function ignoreBranchesIncludesRequired(ignoreBranches, required) {
  * @param {string} root корінь репозиторію
  * @returns {Promise<string[]>} відсортовані шляхи
  */
-async function findK8sYamlFiles(root) {
+async function findK8sYamlFiles(root, ignorePaths = []) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, p => {
-    if (!pathHasK8sSegment(p)) {
-      return
-    }
-    if (!YAML_EXTENSION_RE.test(p)) {
-      return
-    }
-    out.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (!pathHasK8sSegment(p)) {
+        return
+      }
+      if (!YAML_EXTENSION_RE.test(p)) {
+        return
+      }
+      out.push(p)
+    },
+    ignorePaths
+  )
   return [...out].toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -1730,83 +1721,6 @@ async function ensureNoFirebaseHostingArtifacts(root, passFn, failFn) {
   passFn('Підкаталоги кореня (1-й рівень, без .git/node_modules): артефактів Firebase Hosting не знайдено (abie.mdc)')
 }
 
-/**
- * Витягує мітки **`self-hosted-runner.labels`** з тексту `.github/actionlint.yaml`.
- * @param {string} raw повний вміст файлу (YAML)
- * @returns {string[] | null} масив рядків-міток або null, якщо ключа/масиву не знайдено
- */
-export function parseActionlintSelfHostedLabels(raw) {
-  let docs
-  try {
-    docs = parseAllDocuments(raw)
-  } catch {
-    return null
-  }
-  for (const doc of docs) {
-    if (doc.errors.length > 0) continue
-    const root = doc.toJSON()
-    if (root === null || typeof root !== 'object' || Array.isArray(root)) continue
-    const block = /** @type {Record<string, unknown>} */ (root)['self-hosted-runner']
-    if (block === null || typeof block !== 'object' || Array.isArray(block)) continue
-    const labels = /** @type {Record<string, unknown>} */ (block).labels
-    if (!Array.isArray(labels)) continue
-    return labels.filter(l => typeof l === 'string')
-  }
-  return null
-}
-
-/**
- * Які з **`ABIE_REQUIRED_ACTIONLINT_LABELS`** відсутні в наданому списку міток (abie.mdc).
- * @param {string[]} labels мітки **`self-hosted-runner.labels`**
- * @returns {string[]} відсутні мітки (порожньо — все ок)
- */
-export function abieMissingActionlintLabels(labels) {
-  const present = new Set(labels.map(l => l.trim()))
-  return ABIE_REQUIRED_ACTIONLINT_LABELS.filter(r => !present.has(r))
-}
-
-/**
- * Гарантує наявність **`.github/actionlint.yaml`** із потрібними мітками **`self-hosted-runner`** (abie.mdc):
- * створює файл із канонічним вмістом, якщо його немає; якщо є — звіряє мітки.
- * @param {string} root корінь репозиторію
- * @param {(msg: string) => void} pass callback при успішній перевірці
- * @param {(msg: string) => void} fail callback при помилці
- */
-async function ensureAbieActionlintConfig(root, pass, fail) {
-  const abs = join(root, ABIE_ACTIONLINT_PATH)
-  if (!existsSync(abs)) {
-    try {
-      await mkdir(dirname(abs), { recursive: true })
-      await writeFile(abs, ABIE_ACTIONLINT_TEMPLATE, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${ABIE_ACTIONLINT_PATH}: не вдалося створити (${msg}) — abie.mdc`)
-      return
-    }
-    pass(`${ABIE_ACTIONLINT_PATH}: створено з self-hosted-runner.labels [ua, dev, ru] (abie.mdc)`)
-    return
-  }
-  let raw
-  try {
-    raw = await readFile(abs, 'utf8')
-  } catch (error) {
-    const msg = error instanceof Error ? error.message : String(error)
-    fail(`${ABIE_ACTIONLINT_PATH}: не вдалося прочитати (${msg}) — abie.mdc`)
-    return
-  }
-  const labels = parseActionlintSelfHostedLabels(raw)
-  if (labels === null) {
-    fail(`${ABIE_ACTIONLINT_PATH}: не знайдено self-hosted-runner.labels — додай мітки ua, dev, ru (abie.mdc)`)
-    return
-  }
-  const missing = abieMissingActionlintLabels(labels)
-  if (missing.length > 0) {
-    fail(`${ABIE_ACTIONLINT_PATH}: у self-hosted-runner.labels бракує ${missing.join(', ')} (abie.mdc)`)
-    return
-  }
-  pass(`${ABIE_ACTIONLINT_PATH}: self-hosted-runner.labels містить ua, dev, ru (abie.mdc)`)
-}
-
 /**
  * Перевіряє clean-merged-branch.yml на ignore_branches.
  * @param {string} root корінь репозиторію
@@ -2178,9 +2092,9 @@ export async function check() {
   pass('Правило abie увімкнено — виконуємо перевірки')
   await ensureNoFirebaseHostingArtifacts(root, pass, fail)
   await checkCleanMergedBranch(root, pass, fail)
-  await ensureAbieActionlintConfig(root, pass, fail)
 
-  const yamlFiles = await findK8sYamlFiles(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const yamlFiles = await findK8sYamlFiles(root, ignorePaths)
   const deploymentDirs = await collectDeploymentDirs(root, yamlFiles, fail)
 
   if (deploymentDirs.size > 0) {

package/scripts/check-docker.mjs

@@ -33,6 +33,7 @@ import { basename } from 'node:path'
 import { getMirrorGcrHint, getFromImageToken } from './utils/docker-mirror.mjs'
 import { lintDockerfileWithHadolint, posixRel } from './utils/docker-hadolint.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const NEWLINE_RE = /\r?\n/
@@ -65,14 +66,19 @@ export function isDockerfileName(name) {
 /**
  * Збирає абсолютні шляхи до Dockerfile / Containerfile від кореня cwd.
  * @param {string} root корінь репозиторію
+ * @param {string[]} [ignorePaths=[]] шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи
  */
-export async function findDockerfilePaths(root) {
+export async function findDockerfilePaths(root, ignorePaths = []) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, p => {
-    if (isDockerfileName(basename(p))) out.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (isDockerfileName(basename(p))) out.push(p)
+    },
+    ignorePaths
+  )
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -285,7 +291,8 @@ export async function check() {
   const { pass } = reporter
 
   const root = process.cwd()
-  const files = await findDockerfilePaths(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const files = await findDockerfilePaths(root, ignorePaths)
 
   if (files.length === 0) {
     pass('Немає Dockerfile / Containerfile — перевірку hadolint пропущено')

package/scripts/check-graphql.mjs

@@ -17,6 +17,7 @@ import {
   shouldSkipFileForGqlScan,
   sourceFileHasGqlTaggedTemplate
 } from './utils/graphql-gql-scan.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 /** Очікуваний файл GraphQL Config у корені (graphql.mdc). */
@@ -33,16 +34,20 @@ export const REQUIRED_DUMP_SCHEMA_SCRIPT =
  * @param {string} root абсолютний шлях кореня
  * @returns {Promise<string[]>} список кандидатів
  */
-async function collectScanCandidates(root) {
+async function collectScanCandidates(root, ignorePaths) {
   /** @type {string[]} */
   const candidates = []
-  await walkDir(root, absPath => {
-    const rel = relative(root, absPath).split('\\').join('/')
-    if (shouldSkipFileForGqlScan(rel) || !isGqlScanSourceFile(rel)) {
-      return
-    }
-    candidates.push(absPath)
-  })
+  await walkDir(
+    root,
+    absPath => {
+      const rel = relative(root, absPath).split('\\').join('/')
+      if (shouldSkipFileForGqlScan(rel) || !isGqlScanSourceFile(rel)) {
+        return
+      }
+      candidates.push(absPath)
+    },
+    ignorePaths
+  )
   return candidates
 }
 
@@ -148,7 +153,8 @@ export async function check() {
   const { pass, fail } = reporter
 
   const root = process.cwd()
-  const candidates = await collectScanCandidates(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const candidates = await collectScanCandidates(root, ignorePaths)
   const hits = await collectGqlHits(root, candidates)
 
   if (hits.length === 0) {

package/scripts/check-hasura.mjs

@@ -30,6 +30,7 @@ import { parseAllDocuments } from 'yaml'
 
 import { getRepositoryUrl } from './auto-rules.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const NITRA_REPOSITORY_URL_MARKER = 'https://github.com/nitra/'
@@ -103,15 +104,19 @@ export function isEnvFile(relPath) {
  * @param {string} root абсолютний шлях кореня
  * @returns {Promise<string[]>} відсортовані posix-шляхи відносно кореня
  */
-async function collectEnvFiles(root) {
+async function collectEnvFiles(root, ignorePaths) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, absPath => {
-    const rel = relative(root, absPath).split('\\').join('/')
-    if (isEnvFile(rel)) {
-      out.push(rel)
-    }
-  })
+  await walkDir(
+    root,
+    absPath => {
+      const rel = relative(root, absPath).split('\\').join('/')
+      if (isEnvFile(rel)) {
+        out.push(rel)
+      }
+    },
+    ignorePaths
+  )
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -206,7 +211,8 @@ export async function check() {
     namespace: await readYamlMetadataName(join(root, HASURA_NAMESPACE_FILE), 'Namespace')
   }
 
-  const envFiles = await collectEnvFiles(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const envFiles = await collectEnvFiles(root, ignorePaths)
   if (envFiles.length === 0) {
     pass('Не знайдено жодного *.env файла — нічого перевіряти')
     return reporter.getExitCode()

package/scripts/check-image.mjs

@@ -25,6 +25,7 @@ import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
@@ -216,16 +217,20 @@ function packageHasAvifDisabled(pkg) {
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>}
  */
-async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, pass, fail) {
+async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, ignorePaths, pass, fail) {
   const absRoot = join(process.cwd(), packageRoot)
   const label = packageRoot === '.' ? 'корінь' : packageRoot
   /** @type {string[]} */
   const vueFiles = []
-  await walkDir(absRoot, absPath => {
-    if (!absPath.endsWith('.vue')) return
-    if (otherRootsAbs.some(other => absPath.startsWith(`${other}/`))) return
-    vueFiles.push(absPath)
-  })
+  await walkDir(
+    absRoot,
+    absPath => {
+      if (!absPath.endsWith('.vue')) return
+      if (otherRootsAbs.some(other => absPath.startsWith(`${other}/`))) return
+      vueFiles.push(absPath)
+    },
+    ignorePaths
+  )
   if (vueFiles.length === 0) return
 
   let violations = 0
@@ -262,7 +267,7 @@ async function checkVueAvifImportsInPackage(packageRoot, otherRootsAbs, pass, fa
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<void>}
  */
-async function checkVueAvifImports(pass, fail) {
+async function checkVueAvifImports(ignorePaths, pass, fail) {
   const roots = await getMonorepoPackageRootDirs()
   const absRootsByRel = new Map(roots.map(r => [r, join(process.cwd(), r)]))
   for (const root of roots) {
@@ -274,7 +279,7 @@ async function checkVueAvifImports(pass, fail) {
       continue
     }
     const otherRootsAbs = roots.filter(r => r !== root && r !== '.').map(r => absRootsByRel.get(r) ?? '')
-    await checkVueAvifImportsInPackage(root, otherRootsAbs, pass, fail)
+    await checkVueAvifImportsInPackage(root, otherRootsAbs, ignorePaths, pass, fail)
   }
 }
 
@@ -314,7 +319,8 @@ export async function check() {
     await checkHashCacheNotIgnored(pass, fail)
     await checkLegacyCacheRemoved(pass, fail)
   }
-  await checkVueAvifImports(pass, fail)
+  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
+  await checkVueAvifImports(ignorePaths, pass, fail)
 
   return reporter.getExitCode()
 }

package/scripts/check-js-bun-db.mjs

@@ -35,6 +35,7 @@ import {
   isBunSqlScanSourceFile,
   textHasBunSqlImport
 } from './utils/bun-sql-scan.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 /** Імена забороненої залежності у будь-якому `package.json`. */
@@ -54,14 +55,18 @@ function asObject(v) {
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
  * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
  */
-async function findAllPackageJsonPaths(repoRoot) {
+async function findAllPackageJsonPaths(repoRoot, ignorePaths) {
   /** @type {string[]} */
   const paths = []
-  await walkDir(repoRoot, absPath => {
-    if (absPath.endsWith(`${sep}package.json`)) {
-      paths.push(absPath)
-    }
-  })
+  await walkDir(
+    repoRoot,
+    absPath => {
+      if (absPath.endsWith(`${sep}package.json`)) {
+        paths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
   paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
   return paths
 }
@@ -71,15 +76,19 @@ async function findAllPackageJsonPaths(repoRoot) {
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
  * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
  */
-async function findAllSourcePathsForBunSqlScan(repoRoot) {
+async function findAllSourcePathsForBunSqlScan(repoRoot, ignorePaths) {
   /** @type {string[]} */
   const paths = []
-  await walkDir(repoRoot, absPath => {
-    const rel = relative(repoRoot, absPath).split('\\').join('/')
-    if (isBunSqlScanSourceFile(rel)) {
-      paths.push(absPath)
-    }
-  })
+  await walkDir(
+    repoRoot,
+    absPath => {
+      const rel = relative(repoRoot, absPath).split('\\').join('/')
+      if (isBunSqlScanSourceFile(rel)) {
+        paths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
   paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
   return paths
 }
@@ -236,7 +245,8 @@ export async function check() {
     return reporter.getExitCode()
   }
 
-  const pkgJsonPaths = await findAllPackageJsonPaths(repoRoot)
+  const ignorePaths = await loadCursorIgnorePaths(repoRoot)
+  const pkgJsonPaths = await findAllPackageJsonPaths(repoRoot, ignorePaths)
   if (pkgJsonPaths.length === 0) {
     pass('js-bun-db: package.json не знайдено — перевірку пропущено')
     return reporter.getExitCode()
@@ -244,7 +254,7 @@ export async function check() {
 
   await checkForbiddenDependencies(pkgJsonPaths, repoRoot, reporter)
 
-  const sourcePaths = await findAllSourcePathsForBunSqlScan(repoRoot)
+  const sourcePaths = await findAllSourcePathsForBunSqlScan(repoRoot, ignorePaths)
   if (sourcePaths.length === 0) {
     pass('js-bun-db: немає JS/TS файлів для скану патернів Bun SQL')
     return reporter.getExitCode()