@nitra/cursor 1.8.171 → 1.8.173

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 Формат — [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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.171",
+  "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

@@ -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'
@@ -385,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))
 }
 
@@ -2088,7 +2093,8 @@ export async function check() {
   await ensureNoFirebaseHostingArtifacts(root, pass, fail)
   await checkCleanMergedBranch(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()

package/scripts/check-js-mssql.mjs

@@ -22,6 +22,7 @@ import {
   findUnsafeMssqlInListMissingEmptyGuardInText,
   isMssqlScanSourceFile
 } from './utils/mssql-pool-scan.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const VERSION_PREFIX_RE = /^[\^~>=<]+\s*/u
@@ -35,14 +36,18 @@ const MIN_MSSQL_VERSION = { major: 12, minor: 5, patch: 0 }
  * @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
 }
@@ -52,15 +57,19 @@ async function findAllPackageJsonPaths(repoRoot) {
  * @param {string} repoRoot абсолютний шлях до кореня репозиторію
  * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
  */
-async function findAllSourcePathsForMssqlScan(repoRoot) {
+async function findAllSourcePathsForMssqlScan(repoRoot, ignorePaths) {
   /** @type {string[]} */
   const paths = []
-  await walkDir(repoRoot, absPath => {
-    const rel = relative(repoRoot, absPath).split('\\').join('/')
-    if (isMssqlScanSourceFile(rel)) {
-      paths.push(absPath)
-    }
-  })
+  await walkDir(
+    repoRoot,
+    absPath => {
+      const rel = relative(repoRoot, absPath).split('\\').join('/')
+      if (isMssqlScanSourceFile(rel)) {
+        paths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
   paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
   return paths
 }
@@ -253,8 +262,8 @@ function reportZeroMssqlSourceViolations(counters, pass) {
  * @param {(msg: string) => void} fail fail callback
  * @returns {Promise<void>}
  */
-async function auditMssqlSources(repoRoot, pass, fail) {
-  const sourcePaths = await findAllSourcePathsForMssqlScan(repoRoot)
+async function auditMssqlSources(repoRoot, ignorePaths, pass, fail) {
+  const sourcePaths = await findAllSourcePathsForMssqlScan(repoRoot, ignorePaths)
   if (sourcePaths.length === 0) {
     pass('js-mssql: немає JS/TS файлів для скану singleton ConnectionPool')
     return
@@ -291,7 +300,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-mssql: package.json не знайдено — перевірку пропущено')
     return reporter.getExitCode()
@@ -307,7 +317,7 @@ export async function check() {
     pass(`js-mssql: всі знайдені dependencies.mssql відповідають мінімальній версії 12.5.0 (${found})`)
   }
 
-  await auditMssqlSources(repoRoot, pass, fail)
+  await auditMssqlSources(repoRoot, ignorePaths, pass, fail)
 
   return reporter.getExitCode()
 }

package/scripts/check-js-run.mjs

@@ -36,6 +36,7 @@ import {
   isInsideConnDir,
   resolveConnDirFromPackageJson
 } from './utils/conn-imports-scan.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
@@ -56,15 +57,19 @@ function relPosix(absPackageRoot, absPath) {
  * @param {(msg: string) => void} fail callback при помилці
  * @returns {Promise<number>} кількість знайдених порушень
  */
-async function checkBunyanImports(absPackageRoot, label, fail) {
+async function checkBunyanImports(absPackageRoot, ignorePaths, label, fail) {
   /** @type {string[]} */
   const sourcePaths = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relPosix(absPackageRoot, absPath)
-    if (!shouldSkipFileForBunyanScan(rel) && isBunyanScanSourceFile(rel)) {
-      sourcePaths.push(absPath)
-    }
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relPosix(absPackageRoot, absPath)
+      if (!shouldSkipFileForBunyanScan(rel) && isBunyanScanSourceFile(rel)) {
+        sourcePaths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
 
   let violations = 0
   for (const absPath of sourcePaths) {
@@ -83,13 +88,17 @@ async function checkBunyanImports(absPackageRoot, label, fail) {
  * @param {string} absPackageRoot абсолютний шлях до кореня пакета
  * @returns {Promise<string[]>} абсолютні шляхи до файлів
  */
-async function collectSourceFiles(absPackageRoot) {
+async function collectSourceFiles(absPackageRoot, ignorePaths) {
   /** @type {string[]} */
   const out = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relPosix(absPackageRoot, absPath)
-    if (isCheckEnvScanSourceFile(rel)) out.push(absPath)
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relPosix(absPackageRoot, absPath)
+      if (isCheckEnvScanSourceFile(rel)) out.push(absPath)
+    },
+    ignorePaths
+  )
   return out
 }
 
@@ -153,17 +162,17 @@ async function checkProcessEnvUsage(absPackageRoot, sourcePaths, label, fail) {
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок цього пакета
  */
-async function checkWorkspacePackage(rootDir, fail, passFn) {
+async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn) {
   const label = `[${rootDir}] `
   const absPackageRoot = join(process.cwd(), rootDir)
   const pkgJson = await loadPackageJsonAndCheckBunyanDeps(rootDir, label, fail)
 
-  const importViolations = await checkBunyanImports(absPackageRoot, label, fail)
+  const importViolations = await checkBunyanImports(absPackageRoot, ignorePaths, label, fail)
   if (importViolations === 0) {
     passFn(`${label}немає імпортів '@nitra/bunyan' / 'bunyan' у джерелах`)
   }
 
-  const sourcePaths = await collectSourceFiles(absPackageRoot)
+  const sourcePaths = await collectSourceFiles(absPackageRoot, ignorePaths)
 
   const connViolations = await checkConnImports(absPackageRoot, sourcePaths, pkgJson, label, fail)
   if (connViolations === 0) {
@@ -245,8 +254,9 @@ export async function check() {
     return reporter.getExitCode()
   }
 
+  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
   for (const r of workspaceRoots) {
-    await checkWorkspacePackage(r, fail, pass)
+    await checkWorkspacePackage(r, ignorePaths, fail, pass)
   }
 
   return reporter.getExitCode()

package/scripts/check-k8s.mjs

@@ -109,6 +109,7 @@ import { basename, dirname, join, relative, resolve } from 'node:path'
 import { isSeq, parseAllDocuments, parseDocument } from 'yaml'
 
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 /** Версія набору схем yannh — узгоджено з k8s.mdc */
@@ -1581,16 +1582,21 @@ export function baseKustomizationNamespaceViolation(obj) {
 /**
  * Збирає всі `*.yaml` та `*.yml` під деревом від кореня cwd, якщо шлях містить сегмент `k8s` (для `.yml` далі — помилка перейменування).
  * @param {string} root корінь репозиторію (cwd)
+ * @param {string[]} [ignorePaths=[]] шляхи каталогів, повністю виключених з обходу
  * @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))
 }
@@ -1659,12 +1665,13 @@ export function classifyBackendConfigManifestPresence(body) {
 /**
  * Видаляє під **`k8s`** YAML-файли, що містять **лише** ресурси **BackendConfig**; змішані файли — `fail`.
  * @param {string} root корінь репозиторію
+ * @param {string[]} ignorePaths шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} fail реєстрація порушення
  * @param {(msg: string) => void} pass реєстрація успіху
  * @returns {Promise<void>}
  */
-async function removeBackendConfigOnlyK8sYamlFiles(root, fail, pass) {
-  const yamlFiles = await findK8sYamlFiles(root)
+async function removeBackendConfigOnlyK8sYamlFiles(root, ignorePaths, fail, pass) {
+  const yamlFiles = await findK8sYamlFiles(root, ignorePaths)
   for (const abs of yamlFiles) {
     const rel = (relative(root, abs) || abs).replaceAll('\\', '/')
     try {
@@ -1736,12 +1743,13 @@ export function replaceBatchV1beta1ApiVersionInYamlText(raw) {
 /**
  * Проходить усі `*.yaml` / `*.yml` під сегментом `k8s` і на диску застосовує **`replaceBatchV1beta1ApiVersionInYamlText`**.
  * @param {string} root корінь репозиторію
+ * @param {string[]} ignorePaths шляхи каталогів, повністю виключених з обходу
  * @param {(msg: string) => void} fail колбек повідомлення про помилку
  * @param {(msg: string) => void} pass колбек успішного повідомлення
  * @returns {Promise<void>}
  */
-async function rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, fail, pass) {
-  const yamlFiles = await findK8sYamlFiles(root)
+async function rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, ignorePaths, fail, pass) {
+  const yamlFiles = await findK8sYamlFiles(root, ignorePaths)
   for (const abs of yamlFiles) {
     const rel = (relative(root, abs) || abs).replaceAll('\\', '/')
     try {
@@ -5762,12 +5770,13 @@ export async function check() {
   const { pass, fail } = reporter
 
   const root = process.cwd()
+  const ignorePaths = await loadCursorIgnorePaths(root)
 
-  await rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, fail, pass)
+  await rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, ignorePaths, fail, pass)
 
-  await removeBackendConfigOnlyK8sYamlFiles(root, fail, pass)
+  await removeBackendConfigOnlyK8sYamlFiles(root, ignorePaths, fail, pass)
 
-  const yamlFiles = await findK8sYamlFiles(root)
+  const yamlFiles = await findK8sYamlFiles(root, ignorePaths)
 
   if (yamlFiles.length === 0) {
     pass('Немає *.yaml під k8s — перевірку $schema пропущено')

package/scripts/check-nginx-default-tpl.mjs

@@ -19,6 +19,7 @@ import { basename, dirname, join, relative } from 'node:path'
 
 import { findDockerfilePaths } from './check-docker.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const LINE_SPLIT_RE = /\r?\n/u
@@ -36,15 +37,19 @@ const GZIP_EXTENSION_RE = /\*\.(?:js|css)/u
  * @param {string} root корінь cwd
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до шаблонів
  */
-export async function findDefaultConfTemplatePaths(root) {
+export async function findDefaultConfTemplatePaths(root, ignorePaths = []) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, p => {
-    if (basename(p) !== 'default.conf.template') return
-    const rel = relative(root, p).replaceAll('\\', '/')
-    if (rel.includes('tests/fixtures/')) return
-    out.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (basename(p) !== 'default.conf.template') return
+      const rel = relative(root, p).replaceAll('\\', '/')
+      if (rel.includes('tests/fixtures/')) return
+      out.push(p)
+    },
+    ignorePaths
+  )
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -54,12 +59,16 @@ export async function findDefaultConfTemplatePaths(root) {
  * @param {string} root корінь обходу (зазвичай cwd репозиторію)
  * @returns {Promise<{ renamed: string[], overwritten: string[] }>} відносні шляхи до обробленого **default.tpl.conf** (для звіту)
  */
-export async function migrateDefaultTplConfFiles(root) {
+export async function migrateDefaultTplConfFiles(root, ignorePaths = []) {
   /** @type {string[]} */
   const oldPaths = []
-  await walkDir(root, p => {
-    if (basename(p) === 'default.tpl.conf') oldPaths.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (basename(p) === 'default.tpl.conf') oldPaths.push(p)
+    },
+    ignorePaths
+  )
   oldPaths.sort((a, b) => a.localeCompare(b))
 
   /** @type {string[]} */
@@ -316,8 +325,8 @@ async function checkTemplateFile(abs, root, passFn, failFn) {
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} failFn callback при помилці
  */
-async function checkDockerfiles(root, passFn, failFn) {
-  const dockerPaths = await findDockerfilePaths(root)
+async function checkDockerfiles(root, ignorePaths, passFn, failFn) {
+  const dockerPaths = await findDockerfilePaths(root, ignorePaths)
   if (dockerPaths.length === 0) {
     failFn(
       'Є default.conf.template, але немає Dockerfile / Containerfile — додай gzip для статики та envsubst (див. nginx-default-tpl.mdc)'
@@ -380,8 +389,9 @@ export async function check() {
   const { pass, fail } = reporter
 
   const root = process.cwd()
+  const ignorePaths = await loadCursorIgnorePaths(root)
 
-  const { renamed: tplRenamed, overwritten: tplOverwritten } = await migrateDefaultTplConfFiles(root)
+  const { renamed: tplRenamed, overwritten: tplOverwritten } = await migrateDefaultTplConfFiles(root, ignorePaths)
   for (const rel of tplRenamed) {
     pass(`Перейменовано default.tpl.conf → default.conf.template: ${rel}`)
   }
@@ -389,7 +399,7 @@ export async function check() {
     pass(`Перезаписано default.conf.template змістом default.tpl.conf: ${rel}`)
   }
 
-  const templates = await findDefaultConfTemplatePaths(root)
+  const templates = await findDefaultConfTemplatePaths(root, ignorePaths)
 
   if (templates.length === 0) {
     pass('Немає default.conf.template — перевірку nginx-default-tpl пропущено')
@@ -402,7 +412,7 @@ export async function check() {
     await checkTemplateFile(abs, root, pass, fail)
   }
 
-  await checkDockerfiles(root, pass, fail)
+  await checkDockerfiles(root, ignorePaths, pass, fail)
   await checkVscodeNginx(pass, fail)
 
   return reporter.getExitCode()

package/scripts/check-npm-module.mjs

@@ -26,6 +26,7 @@ import {
   pushHasMainBranch,
   pushPathsIncludeNpmGlob
 } from './utils/gha-workflow.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const TYPES_FILE_RE = /^\.\/types\/.+\.d\.(ts|mts)$/
@@ -43,17 +44,21 @@ const CHANGELOG_PATH = 'npm/CHANGELOG.md'
  * Чи є під `npm/src` хоча б один `.js` (рекурсивно).
  * @returns {Promise<boolean>} `true`, якщо знайдено хоча б один `.js`
  */
-async function npmSrcTreeHasJsFile() {
+async function npmSrcTreeHasJsFile(ignorePaths = []) {
   const root = 'npm/src'
   if (!existsSync(root)) {
     return false
   }
   let found = false
-  await walkDir(root, p => {
-    if (p.endsWith('.js')) {
-      found = true
-    }
-  })
+  await walkDir(
+    root,
+    p => {
+      if (p.endsWith('.js')) {
+        found = true
+      }
+    },
+    ignorePaths
+  )
   return found
 }
 
@@ -387,7 +392,8 @@ export async function check() {
 
   await checkNpmModuleBasicStructure(pass, fail)
 
-  const useSrcJsLayout = await npmSrcTreeHasJsFile()
+  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
+  const useSrcJsLayout = await npmSrcTreeHasJsFile(ignorePaths)
 
   await checkNpmPackageJson(useSrcJsLayout, pass, fail)
 

package/scripts/check-vue.mjs

@@ -20,6 +20,7 @@ import {
   isVueImportScanSourceFile,
   shouldSkipFileForVueImportScan
 } from './utils/vue-forbidden-imports.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from './utils/workspaces.mjs'
 
@@ -113,14 +114,18 @@ async function collectEsbuildMatchesInFiles(absPackageRoot, files, maxMatches) {
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
-async function checkEsbuildMentions(rootDir, absPackageRoot, prefix, passFn, fail) {
+async function checkEsbuildMentions(rootDir, absPackageRoot, ignorePaths, prefix, passFn, fail) {
   /** @type {{ rel: string }[]} */
   const candidates = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relative(absPackageRoot, absPath).split('\\').join('/')
-    if (!isEsbuildScanFile(rel)) return
-    candidates.push({ rel })
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relative(absPackageRoot, absPath).split('\\').join('/')
+      if (!isEsbuildScanFile(rel)) return
+      candidates.push({ rel })
+    },
+    ignorePaths
+  )
 
   const maxMatches = 30
   const matches = await collectEsbuildMatchesInFiles(absPackageRoot, candidates, maxMatches)
@@ -308,7 +313,7 @@ async function checkViteConfig(rootDir, prefix, passFn, fail) {
  * @param {(msg: string) => void} passFn callback при успішній перевірці
  * @param {(msg: string) => void} fail callback при помилці
  */
-async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImport, prefix, passFn, fail) {
+async function checkVueImportViolations(rootDir, absPackageRoot, ignorePaths, hasVueAutoImport, prefix, passFn, fail) {
   if (!hasVueAutoImport) {
     passFn(
       `${prefix}value-імпорти з 'vue' не заборонені — спершу додай 'vue' до AutoImport.imports у vite.config`
@@ -317,12 +322,16 @@ async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImpor
   }
   /** @type {string[]} */
   const sourcePaths = []
-  await walkDir(absPackageRoot, absPath => {
-    const rel = relative(absPackageRoot, absPath).split('\\').join('/')
-    if (!shouldSkipFileForVueImportScan(rel) && isVueImportScanSourceFile(rel)) {
-      sourcePaths.push(absPath)
-    }
-  })
+  await walkDir(
+    absPackageRoot,
+    absPath => {
+      const rel = relative(absPackageRoot, absPath).split('\\').join('/')
+      if (!shouldSkipFileForVueImportScan(rel) && isVueImportScanSourceFile(rel)) {
+        sourcePaths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
 
   let importViolations = 0
   for (const absPath of sourcePaths) {
@@ -347,7 +356,7 @@ async function checkVueImportViolations(rootDir, absPackageRoot, hasVueAutoImpor
  * @param {(msg: string) => void} passFn успішне повідомлення (як у check-reporter)
  * @returns {Promise<void>} завершується після перевірок залежностей, `vite.config` і сканування джерел на імпорти з `vue`
  */
-async function checkVuePackage(rootDir, fail, passFn) {
+async function checkVuePackage(rootDir, ignorePaths, fail, passFn) {
   const prefix = `[${packageLabel(rootDir)}] `
   const pkg = JSON.parse(await readFile(join(rootDir, 'package.json'), 'utf8'))
   const deps = pkg.dependencies || {}
@@ -387,8 +396,8 @@ async function checkVuePackage(rootDir, fail, passFn) {
   )
 
   const { hasVueAutoImport } = await checkViteConfig(rootDir, prefix, passFn, fail)
-  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), hasVueAutoImport, prefix, passFn, fail)
-  await checkEsbuildMentions(rootDir, join(process.cwd(), rootDir), prefix, passFn, fail)
+  await checkVueImportViolations(rootDir, join(process.cwd(), rootDir), ignorePaths, hasVueAutoImport, prefix, passFn, fail)
+  await checkEsbuildMentions(rootDir, join(process.cwd(), rootDir), ignorePaths, prefix, passFn, fail)
 }
 
 /**
@@ -446,8 +455,9 @@ export async function check() {
 
   await checkVueVolarRecommendation(pass, fail)
 
+  const ignorePaths = await loadCursorIgnorePaths(process.cwd())
   for (const r of vueRoots) {
-    await checkVuePackage(r, fail, pass)
+    await checkVuePackage(r, ignorePaths, fail, pass)
   }
 
   return reporter.getExitCode()

package/scripts/rename-yaml-extensions.mjs

@@ -14,6 +14,7 @@ import { rename } from 'node:fs/promises'
 import { cwd } from 'node:process'
 import { relative, resolve } from 'node:path'
 
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
 const K8S_YML_RE = /\.yml$/iu
@@ -69,37 +70,41 @@ export function replaceExtension(relPosix, newExt) {
  * @param {string} rootAbs абсолютний корінь репозиторію
  * @returns {Promise<Array<{ kind: 'k8s' | 'github', fromAbs: string, toAbs: string, relFrom: string, relTo: string }>>} відсортовані операції перейменування без запису на диск
  */
-async function collectRenameOps(rootAbs) {
+async function collectRenameOps(rootAbs, ignorePaths) {
   /** @type {Array<{ kind: 'k8s' | 'github', fromAbs: string, toAbs: string, relFrom: string, relTo: string }>} */
   const ops = []
 
-  await walkDir(rootAbs, fileAbs => {
-    const rel = posixRelFromRoot(rootAbs, fileAbs)
-    if (rel === null) return
-    if (pathMatchesK8sYml(rel)) {
-      const relTo = replaceExtension(rel, '.yaml')
-      if (relTo === rel) return
-      ops.push({
-        kind: 'k8s',
-        fromAbs: resolve(rootAbs, rel),
-        toAbs: resolve(rootAbs, relTo),
-        relFrom: rel,
-        relTo
-      })
-      return
-    }
-    if (pathMatchesGithubYaml(rel)) {
-      const relTo = replaceExtension(rel, '.yml')
-      if (relTo === rel) return
-      ops.push({
-        kind: 'github',
-        fromAbs: resolve(rootAbs, rel),
-        toAbs: resolve(rootAbs, relTo),
-        relFrom: rel,
-        relTo
-      })
-    }
-  })
+  await walkDir(
+    rootAbs,
+    fileAbs => {
+      const rel = posixRelFromRoot(rootAbs, fileAbs)
+      if (rel === null) return
+      if (pathMatchesK8sYml(rel)) {
+        const relTo = replaceExtension(rel, '.yaml')
+        if (relTo === rel) return
+        ops.push({
+          kind: 'k8s',
+          fromAbs: resolve(rootAbs, rel),
+          toAbs: resolve(rootAbs, relTo),
+          relFrom: rel,
+          relTo
+        })
+        return
+      }
+      if (pathMatchesGithubYaml(rel)) {
+        const relTo = replaceExtension(rel, '.yml')
+        if (relTo === rel) return
+        ops.push({
+          kind: 'github',
+          fromAbs: resolve(rootAbs, rel),
+          toAbs: resolve(rootAbs, relTo),
+          relFrom: rel,
+          relTo
+        })
+      }
+    },
+    ignorePaths
+  )
 
   ops.sort((a, b) => {
     const ko = (a.kind === 'k8s' ? 0 : 1) - (b.kind === 'k8s' ? 0 : 1)
@@ -119,7 +124,8 @@ async function collectRenameOps(rootAbs) {
 export async function renameYamlExtensions(root, options = {}) {
   const dryRun = options.dryRun === true
   const rootAbs = resolve(root)
-  const ops = await collectRenameOps(rootAbs)
+  const ignorePaths = await loadCursorIgnorePaths(rootAbs)
+  const ops = await collectRenameOps(rootAbs, ignorePaths)
 
   /** @type { { relFrom: string, relTo: string }[]} */
   const renamed = []

package/scripts/run-docker.mjs

@@ -12,6 +12,7 @@ import { basename } from 'node:path'
 import { isRunAsCli } from './cli-entry.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'
 
 /**
@@ -30,12 +31,16 @@ export function isLintDockerfileName(name) {
  * @param {string} root корінь репозиторію
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи
  */
-export async function findLintDockerfilePaths(root) {
+export async function findLintDockerfilePaths(root, ignorePaths = []) {
   /** @type {string[]} */
   const out = []
-  await walkDir(root, p => {
-    if (isLintDockerfileName(basename(p))) out.push(p)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (isLintDockerfileName(basename(p))) out.push(p)
+    },
+    ignorePaths
+  )
   return out.toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -48,7 +53,8 @@ async function main() {
   const { pass, fail } = reporter
 
   const root = process.cwd()
-  const files = await findLintDockerfilePaths(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const files = await findLintDockerfilePaths(root, ignorePaths)
 
   if (files.length === 0) {
     pass('lint-docker: немає Dockerfile / *.Dockerfile — hadolint пропущено')

package/scripts/run-k8s.mjs

@@ -16,6 +16,7 @@ import { spawnSync } from 'node:child_process'
 import { basename, dirname } from 'node:path'
 
 import { isRunAsCli } from './cli-entry.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
 import { resolveCmd } from './utils/resolve-cmd.mjs'
 import { walkDir } from './utils/walkDir.mjs'
 
@@ -60,15 +61,19 @@ export function k8sRootFromFile(absFile) {
  * @param {string} root корінь репозиторію
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до каталогів `k8s`
  */
-export async function findK8sRoots(root) {
+export async function findK8sRoots(root, ignorePaths = []) {
   /** @type {Set<string>} */
   const roots = new Set()
-  await walkDir(root, p => {
-    if (!pathHasK8sSegment(p)) return
-    if (!YAML_EXT_RE.test(p)) return
-    const k8sRoot = k8sRootFromFile(p)
-    if (k8sRoot) roots.add(k8sRoot)
-  })
+  await walkDir(
+    root,
+    p => {
+      if (!pathHasK8sSegment(p)) return
+      if (!YAML_EXT_RE.test(p)) return
+      const k8sRoot = k8sRootFromFile(p)
+      if (k8sRoot) roots.add(k8sRoot)
+    },
+    ignorePaths
+  )
   return [...roots].toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -134,7 +139,8 @@ function runKubescape(dirs) {
  */
 async function main() {
   const root = process.cwd()
-  const dirs = await findK8sRoots(root)
+  const ignorePaths = await loadCursorIgnorePaths(root)
+  const dirs = await findK8sRoots(root, ignorePaths)
 
   if (dirs.length === 0) {
     console.log('run-k8s: немає *.yaml під k8s — kubeconform і kubescape пропущено')

package/scripts/utils/load-cursor-config.mjs

@@ -0,0 +1,53 @@
+/**
+ * Утиліта читання `.n-cursor.json` у корені репозиторію.
+ *
+ * Зараз експортує `loadCursorIgnorePaths(root)` — список абсолютних posix-шляхів каталогів,
+ * які check-скрипти повністю виключають з обходу (поле `ignore` у конфізі).
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { isAbsolute, join, resolve, sep } from 'node:path'
+
+const CONFIG_FILE = '.n-cursor.json'
+
+/**
+ * Нормалізує шлях до абсолютного posix-формату без trailing-slash.
+ * Відносні шляхи розв'язуються від `root`.
+ * @param {string} root абсолютний корінь репозиторію
+ * @param {string} p шлях з конфігу (відносний або абсолютний)
+ * @returns {string} абсолютний posix-шлях
+ */
+function toAbsPosix(root, p) {
+  const trimmed = String(p).trim()
+  const abs = isAbsolute(trimmed) ? trimmed : resolve(root, trimmed)
+  return abs.split(sep).join('/').replace(/\/+$/, '')
+}
+
+/**
+ * Читає `.n-cursor.json` з кореня та повертає нормалізовані ignore-шляхи.
+ * Якщо файлу нема, поле `ignore` відсутнє чи має невалідний формат — повертає порожній масив.
+ * Сам конфіг не валідується (це робить v8r/окрема перевірка) — лише поле `ignore`.
+ * @param {string} root абсолютний корінь репозиторію
+ * @returns {Promise<string[]>} абсолютні posix-шляхи без trailing-slash
+ */
+export async function loadCursorIgnorePaths(root) {
+  const file = join(root, CONFIG_FILE)
+  if (!existsSync(file)) return []
+  let raw
+  try {
+    raw = JSON.parse(await readFile(file, 'utf8'))
+  } catch {
+    return []
+  }
+  const list = raw?.ignore
+  if (!Array.isArray(list)) return []
+  /** @type {string[]} */
+  const out = []
+  for (const item of list) {
+    if (typeof item !== 'string') continue
+    const v = item.trim()
+    if (v.length === 0) continue
+    out.push(toAbsPosix(root, v))
+  }
+  return out
+}

package/scripts/utils/walkDir.mjs

@@ -2,19 +2,60 @@
  * Рекурсивний обхід каталогів для скриптів перевірки (Dockerfile, k8s YAML тощо).
  *
  * Обходить дерево від заданого кореня; для кожного звичайного файлу викликає переданий callback.
- * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться. Якщо readdir для
- * каталогу не вдається — тихо виходить без throw.
+ * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться.
+ * Додатково можна передати `ignorePaths` — повні шляхи каталогів (абсолютні posix), які слід
+ * пропускати разом з усім вмістом (поле `ignore` у `.n-cursor.json`). Якщо readdir для каталогу
+ * не вдається — тихо виходить без throw.
  */
 import { readdir } from 'node:fs/promises'
-import { join } from 'node:path'
+import { isAbsolute, join, resolve, sep } from 'node:path'
 
 /**
- * Рекурсивно обходить каталог, пропускає типові артефакти збірки та залежностей.
+ * Перетворює довільний шлях у абсолютний posix-формат без trailing-slash.
+ * @param {string} p шлях
+ * @returns {string} абсолютний posix-шлях
+ */
+function toAbsPosix(p) {
+  const abs = isAbsolute(p) ? p : resolve(p)
+  return abs.split(sep).join('/').replace(/\/+$/, '')
+}
+
+/**
+ * Чи каталог `dirAbsPosix` входить у список ignore (точний збіг або префікс з '/').
+ * Часткові збіги басенейму не враховуються (postgres-master-test ≠ postgres-master).
+ * @param {string} dirAbsPosix абсолютний posix-шлях каталогу
+ * @param {string[]} ignorePosix вже нормалізовані ignore-шляхи
+ * @returns {boolean}
+ */
+function isIgnoredDir(dirAbsPosix, ignorePosix) {
+  for (const ig of ignorePosix) {
+    if (dirAbsPosix === ig) return true
+    if (dirAbsPosix.startsWith(`${ig}/`)) return true
+  }
+  return false
+}
+
+/**
+ * Рекурсивно обходить каталог, пропускає типові артефакти збірки/залежностей та `ignorePaths`.
  * @param {string} dir абсолютний шлях
  * @param {(filePath: string) => void} onFile виклик для кожного файлу
+ * @param {string[]} [ignorePaths=[]] шляхи каталогів (відносні від cwd або абсолютні), що повністю виключаються з обходу
+ * @returns {Promise<void>}
+ */
+export async function walkDir(dir, onFile, ignorePaths = []) {
+  const ignorePosix = ignorePaths.map(toAbsPosix)
+  await walkDirInner(dir, onFile, ignorePosix)
+}
+
+/**
+ * Внутрішній рекурсор. ignorePosix вже нормалізовано — не нормалізуємо повторно на кожному рівні.
+ * @param {string} dir
+ * @param {(filePath: string) => void} onFile
+ * @param {string[]} ignorePosix
  * @returns {Promise<void>}
  */
-export async function walkDir(dir, onFile) {
+async function walkDirInner(dir, onFile, ignorePosix) {
+  if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(dir), ignorePosix)) return
   let entries
   try {
     entries = await readdir(dir, { withFileTypes: true })
@@ -31,9 +72,9 @@ export async function walkDir(dir, onFile) {
         e.name === 'coverage' ||
         e.name === '.turbo' ||
         e.name === '.next'
-      if (!skipDir) {
-        await walkDir(p, onFile)
-      }
+      if (skipDir) continue
+      if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(p), ignorePosix)) continue
+      await walkDirInner(p, onFile, ignorePosix)
     } else if (e.isFile()) {
       onFile(p)
     }