@nitra/cursor 1.8.171 → 1.8.177

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

@@ -38,6 +38,8 @@
  * кожен **Service** — **`spec.clusterIP: None`** та ім’я на **`-hl`**. У маршрутах **Gateway API**
  * (**`HTTPRoute`**, **`GRPCRoute`**, **`TCPRoute`**, **`TLSRoute`**, **`UDPRoute`**, група **`gateway.networking.k8s.io`**)
  * посилання **`backendRefs` / `backendRef`** на **Service** мають вказувати лише сервіси з суфіксом **`-hl`** у **`name`**.
+ * Поле **`namespace`** у **`backendRef`**, що збігається з **`metadata.namespace`** самого маршруту, — надлишкове:
+ * прибери його, бо за замовчуванням Gateway API резолвить backend у тому ж namespace, що й маршрут (див. k8s.mdc).
  * **HealthCheckPolicy** (**`networking.gke.io/v1`**, GKE): **`spec.targetRef`** на **Service** — **`name`** з суфіксом **`-hl`** (див. k8s.mdc).
  * Якщо **`kustomization.yaml`** посилається на **`svc.yaml`** (**`resources`**, **`bases`**, **`components`**, **`crds`**,
  * **`patches[].path`**, **`patchesStrategicMerge`**), у **тому ж** файлі має бути посилання на відповідний **`svc-hl.yaml`**
@@ -55,6 +57,11 @@
  * Для **`patchesStrategicMerge`** і для **`patches[].path`** без **`target`** і без inline **`patch`** (зовнішній strategic-merge)
  * кожен YAML-документ з кореневим **`kind`** і **`metadata.name`** також звіряється з цим каталогом.
  *
+ * **Зайві `group` / `version` у `patches[].target` / `patchesJson6902[].target`:** якщо в інвентарі **`resources`** /
+ * **`bases`** / **`components`** / **`crds`** (рекурсивно) за **`kind`** + **`name`** немає колізії між різними
+ * API-групами/версіями, поля **`group`** і **`version`** у **`target`** треба прибрати — Kustomize резолвить ціль
+ * за **GVK + name**, а зайві поля ламаються мовчки під час змін API (k8s.mdc «patches[].target: лише kind і name»).
+ *
  * Явні винятки до загальної логіки yannh/datree — таблиця **`EXPLICIT_K8S_SCHEMAS`** (`Map`): ключ
  * **`apiVersion`, `kind`, `type`** (для CRD без поля `type` у маніфесті — зірочка **`*`** як третій
  * компонент). Спочатку шукається збіг за фактичним `type`, потім за **`*`**.
@@ -109,6 +116,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 */
@@ -1322,6 +1330,52 @@ function failIfExplicitPatchTargetsNotInCatalog(rel, first, catalog, fail) {
   }
 }
 
+/**
+ * Зайві **`group`** / **`version`** у **`patches[].target`** / **`patchesJson6902[].target`**: якщо в інвентарі за **`kind`** + **`name`** немає колізії між різними API-групами/версіями, ці поля треба прибрати (k8s.mdc «patches[].target: лише kind і name»).
+ * @param {string} rel відносний шлях до kustomization.yaml
+ * @param {Record<string, unknown>} first корінь Kustomization
+ * @param {KustomizeResourceDescriptor[]} catalog інвентар resources/bases/…
+ * @param {(msg: string) => void} fail реєстрація помилки
+ * @returns {void}
+ */
+function failIfExplicitPatchTargetsHaveRedundantGroupVersion(rel, first, catalog, fail) {
+  for (const { section, index, target } of extractExplicitPatchTargetsFromKustomization(first)) {
+    if (target === null || typeof target !== 'object' || Array.isArray(target)) {
+      continue
+    }
+    const t = /** @type {Record<string, unknown>} */ (target)
+    const kind = typeof t.kind === 'string' ? t.kind.trim() : ''
+    const name = typeof t.name === 'string' ? t.name.trim() : ''
+    if (kind === '' || name === '') {
+      continue
+    }
+    if (patchTargetUsesSelector(t)) {
+      continue
+    }
+    const tgtGroup = typeof t.group === 'string' ? t.group.trim() : ''
+    const tgtVersion = typeof t.version === 'string' ? t.version.trim() : ''
+    if (tgtGroup === '' && tgtVersion === '') {
+      continue
+    }
+    const matchingByKindName = catalog.filter(r => r.kind === kind && r.name === name)
+    const distinctGvk = new Set(matchingByKindName.map(r => `${r.group}/${r.version}`))
+    if (distinctGvk.size > 1) {
+      continue
+    }
+    /** @type {string[]} */
+    const redundant = []
+    if (tgtGroup !== '') {
+      redundant.push('group')
+    }
+    if (tgtVersion !== '') {
+      redundant.push('version')
+    }
+    fail(
+      `${rel}: ${section}[${index}].target — прибери зайві поля ${redundant.join(', ')}; для kind=${kind}, name=${name} в інвентарі немає колізії між різними API-групами/версіями (див. k8s.mdc «patches[].target: лише kind і name»)`
+    )
+  }
+}
+
 /**
  * Документи з YAML-файлу мають мати дескриптор у **catalog** (інвентар resources).
  * @param {string} rel відносний шлях до kustomization.yaml
@@ -1524,6 +1578,7 @@ async function validatePatchTargetsOneKustomizationFile(root, kustAbs, rootNorm,
   const kustDir = dirname(resolve(kustAbs))
   const kustNs = typeof rec.namespace === 'string' && rec.namespace.trim() !== '' ? rec.namespace.trim() : ''
   failIfExplicitPatchTargetsNotInCatalog(rel, first, catalog, fail)
+  failIfExplicitPatchTargetsHaveRedundantGroupVersion(rel, first, catalog, fail)
   await failIfPathOnlyPatchesNotInCatalog(rel, rec.patches, kustDir, rootNorm, root, catalog, kustNs, fail)
   await failIfStrategicMergePatchesNotInCatalog(
     rel,
@@ -1581,16 +1636,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 +1719,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 +1797,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 {
@@ -2872,7 +2934,49 @@ export function collectGatewayApiRouteBackendServiceNames(spec) {
 }
 
 /**
- * Один документ: маршрут Gateway API має посилатися на **Service** з суфіксом **`-hl`**.
+ * Збирає **`backendRef`** до **Service** з полем **`namespace`**, що збігається з namespace маршруту.
+ *
+ * Поле **`namespace`** у такому **`backendRef`** надлишкове: за замовчуванням Gateway API резолвить backend
+ * у тому ж namespace, що й сам маршрут (див. k8s.mdc). Зайві поля у YAML — джерело розсинхрону між середовищами.
+ * @param {unknown} spec значення **`spec`** маршруту
+ * @param {string} routeNs **`metadata.namespace`** маршруту (непорожній рядок)
+ * @returns {string[]} імена backend-сервісів з надлишковим **`namespace`** (можливі дублікати)
+ */
+export function collectGatewayApiRouteBackendRefsWithRedundantNamespace(spec, routeNs) {
+  /** @type {string[]} */
+  const out = []
+
+  /**
+   * @param {unknown} node вузол для обходу
+   * @returns {void}
+   */
+  function walk(node) {
+    if (node === null || node === undefined) return
+    if (Array.isArray(node)) {
+      for (const x of node) {
+        walk(x)
+      }
+      return
+    }
+    if (typeof node !== 'object') return
+    if (isGatewayApiBackendRefToService(node)) {
+      const o = /** @type {Record<string, unknown>} */ (node)
+      if (typeof o.namespace === 'string' && o.namespace === routeNs) {
+        out.push(String(o.name))
+      }
+    }
+    for (const v of Object.values(node)) {
+      walk(v)
+    }
+  }
+
+  walk(spec)
+  return out
+}
+
+/**
+ * Один документ: маршрут Gateway API має посилатися на **Service** з суфіксом **`-hl`**;
+ * у **`backendRef`** не має дублюватися **`namespace`**, що збігається з **`metadata.namespace`** маршруту.
  * @param {string} rel відносний шлях до файлу
  * @param {number} docIndex 1-based індекс документа
  * @param {Record<string, unknown>} rec корінь маніфесту
@@ -2898,6 +3002,18 @@ function failIfGatewayRouteUsesNonHeadlessService(rel, docIndex, rec, fail) {
       )
     }
   }
+  const meta = rec.metadata
+  if (meta !== null && typeof meta === 'object' && !Array.isArray(meta)) {
+    const routeNs = /** @type {Record<string, unknown>} */ (meta).namespace
+    if (typeof routeNs === 'string' && routeNs !== '') {
+      const redundant = collectGatewayApiRouteBackendRefsWithRedundantNamespace(rec.spec, routeNs)
+      for (const svcName of redundant) {
+        fail(
+          `${rel}: Gateway API ${kind} (документ ${docIndex}): backendRef «${svcName}» має namespace «${routeNs}», що збігається з metadata.namespace маршруту — прибери поле namespace з backendRef (див. k8s.mdc)`
+        )
+      }
+    }
+  }
 }
 
 /**
@@ -5762,12 +5878,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

@@ -9,9 +9,6 @@
  * Якщо таких файлів немає — layout через `npm/tsconfig.emit-types.json`: поле `types` має вказувати на існуючий
  * файл під `./types/…`, у hk — `tsc -p tsconfig.emit-types.json`, у JSON-конфігу — потрібні compilerOptions для emit.
  *
- * Окремо перевіряється `npm/CHANGELOG.md`: файл існує, є в `files` у `npm/package.json` і містить запис
- * для поточної версії (формат `## [X.Y.Z] - YYYY-MM-DD`, Keep a Changelog).
- *
  * Поля workflow перевіряються після **YAML parse**, щоб не плутати з коментарями.
  */
 import { existsSync } from 'node:fs'
@@ -26,6 +23,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)$/
@@ -36,24 +34,25 @@ const TYPES_INDEX = './types/index.d.ts'
 /** Файл проєкту TypeScript для emit без каталогу `src` (див. npm-module.mdc) */
 const EMIT_TYPES_CONFIG = 'npm/tsconfig.emit-types.json'
 
-/** Шлях до `CHANGELOG.md` в каталозі npm-модуля */
-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
 }
 
@@ -200,53 +199,6 @@ async function checkNpmPackageJson(useSrcJsLayout, passFn, failFn) {
   }
 }
 
-/**
- * Чи містить текст `CHANGELOG.md` запис заголовка для конкретної версії
- * у форматі Keep a Changelog: `## [X.Y.Z]` (з опційним `- YYYY-MM-DD`).
- * @param {string} text вміст `CHANGELOG.md`
- * @param {string} version номер версії з `npm/package.json`
- * @returns {boolean} `true`, якщо знайдено заголовок версії
- */
-function changelogHasVersionEntry(text, version) {
-  const escaped = version.replaceAll(/[.+*?^$()[\]{}|\\]/g, String.raw`\$&`)
-  const re = new RegExp(String.raw`^##\s+\[${escaped}\]`, 'm')
-  return re.test(text)
-}
-
-/**
- * Перевіряє наявність і вміст `npm/CHANGELOG.md`, а також що він є в `files` у `npm/package.json`.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-async function checkChangelog(passFn, failFn) {
-  if (!existsSync(CHANGELOG_PATH)) {
-    failFn(`Відсутній ${CHANGELOG_PATH} (npm-module.mdc: CHANGELOG)`)
-    return
-  }
-  passFn(`${CHANGELOG_PATH} існує`)
-
-  if (existsSync('npm/package.json')) {
-    const npmPkg = JSON.parse(await readFile('npm/package.json', 'utf8'))
-    if (Array.isArray(npmPkg.files) && npmPkg.files.includes('CHANGELOG.md')) {
-      passFn('npm/package.json: files містить "CHANGELOG.md"')
-    } else {
-      failFn('npm/package.json: масив files має містити "CHANGELOG.md"')
-    }
-
-    const version = typeof npmPkg.version === 'string' ? npmPkg.version : null
-    if (version) {
-      const text = await readFile(CHANGELOG_PATH, 'utf8')
-      if (changelogHasVersionEntry(text, version)) {
-        passFn(`${CHANGELOG_PATH}: знайдено запис для версії ${version}`)
-      } else {
-        failFn(
-          `${CHANGELOG_PATH}: відсутній запис для поточної версії ${version} (формат Keep a Changelog: "## [${version}] - YYYY-MM-DD")`
-        )
-      }
-    }
-  }
-}
-
 /**
  * Перевіряє npm/tsconfig.emit-types.json.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
@@ -387,12 +339,11 @@ 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)
 
-  await checkChangelog(pass, fail)
-
   if (!useSrcJsLayout) {
     await checkEmitTypesConfig(pass, fail)
   }