@nitra/cursor 1.8.79 → 1.8.80

package/mdc/abie.mdc

@@ -1,14 +1,14 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.7'
+version: '1.8'
 ---
 
 Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**), видалення **HealthCheckPolicy** у **ru**), а також гілки **dev**, **ua**, **ru** у **clean-merged-branch**.
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
-**Канон перевірки** — **`npm/scripts/check-abie.mjs`**: верхній JSDoc і реалізація задають точні умови, допустимі домени для hostnames, тексти помилок. Нижче — зміст правила й орієнтовні фрагменти YAML; не дублюй тут покроковий алгоритм зі скрипта.
+**Канон перевірки** — **`npm/scripts/check-abie.mjs`** у пакеті **`@nitra/cursor`**: верхній JSDoc і реалізація задають точні умови, допустимі домени для hostnames, тексти помилок. Нижче — зміст правила й орієнтовні фрагменти YAML; не дублюй тут покроковий алгоритм зі скрипта.
 
 ## k8s: `hc.yaml` поруч із Deployment
 
@@ -36,7 +36,7 @@ spec:
 
 ## k8s: overlay **HTTPRoute** (**ua** / **ru**)
 
-За наявності **Deployment** під **k8s** у **кожному** **`ua/kustomization.yaml`** та **`ru/kustomization.yaml`** потрібні **inline JSON6902** у **`patches`**: **target** **`kind: HTTPRoute`**, **непорожній `name`** (як у маніфесті маршруту). Мають бути зміни **`/spec/hostnames`** (домени abie — у скрипті) та **`/spec/parentRefs/0/namespace`** (**`ua`** / **`ru`**). Для **ru** — анотація **`gwin.yandex.cloud/rules.http.upgradeTypes: websocket`**. Як обирати **`op`** (**add** / **replace** тощо) у patch — **k8s.mdc** (розділ про JSON patch у kustomization).
+За наявності **Deployment** під **k8s** і наявності **Vite** (**`vite.config.js`**, **`vite.config.mjs`** або **`vite.config.ts`** у каталозі пакета) у **`ua/kustomization.yaml`** та **`ru/kustomization.yaml`** цього пакета потрібні **inline JSON6902** у **`patches`**: **target** **`kind: HTTPRoute`**, **непорожній `name`** (як у маніфесті маршруту). Мають бути зміни **`/spec/hostnames`** (домени abie — у скрипті) та **`/spec/parentRefs/0/namespace`** (**`ua`** / **`ru`**). Для **ru** — анотація **`gwin.yandex.cloud/rules.http.upgradeTypes: websocket`**. Як обирати **`op`** (**add** / **replace** тощо) у patch — **k8s.mdc** (розділ про JSON patch у kustomization).
 
 ```yaml title="…/ua/kustomization.yaml (фрагмент)"
   - target:
@@ -95,7 +95,7 @@ patches:
 
 ## k8s: overlay **ua** / **ru** і nodeSelector
 
-За наявності **Deployment** під **k8s** у **кожному** **`…/ua/kustomization.yaml`** та **`…/ru/kustomization.yaml`** — patch на **`kind: Deployment`**: **ua** — **`spec.template.spec.nodeSelector`** з **`preem: false`**; **ru** — **`spec.template.spec.nodeSelector`** з **`yandex.cloud/preemptible: false`**. Форму **JSON6902** (шлях **`/spec/template/spec/nodeSelector`**, **`op`**) див. **k8s.mdc**.
+У **`…/ua/kustomization.yaml`** та **`…/ru/kustomization.yaml`** того пакета, у дереві **`k8s`** якого є **Deployment**, потрібен patch на **`kind: Deployment`**: **ua** — **`spec.template.spec.nodeSelector`** з **`preem: false`**; **ru** — **`spec.template.spec.nodeSelector`** з **`yandex.cloud/preemptible: false`**. Форму **JSON6902** (шлях **`/spec/template/spec/nodeSelector`**, **`op`**) див. **k8s.mdc**.
 
 ```yaml title="…/ua/kustomization.yaml (фрагмент)"
 patches:

package/mdc/k8s.mdc

@@ -226,8 +226,6 @@ patches:
 
 **Не входить у check k8s:** наприклад **ReferenceGrant** і доступ між **namespace** (лише рекомендації тут), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
 
-
-
 ## Коли застосовувати (агентам)
 
 - Після змін у k8s YAML: **`npx @nitra/cursor check k8s`** і за наявності правила — **`bun run lint-k8s`**.

package/package.json

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

package/scripts/check-abie.mjs

@@ -17,11 +17,12 @@
  * **nodeSelector (base):** якщо **Deployment** лежить у шляху з сегментом **`base`** (наприклад **`…/k8s/base/deploy.yaml`**),
  * у **`spec.template.spec.nodeSelector`** має бути **`preem`** з булевим значенням **true** або рядком **`'true'`** — overlay **ua** та **ru** далі підміняють селектор.
  *
- * **nodeSelector (overlay):** якщо є **Deployment** під **k8s**, у **`ua`/`ru` kustomization** — inline patch на **`kind: Deployment`**
+ * **nodeSelector (overlay):** якщо в дереві **k8s** пакета є **Deployment**, у **`ua`/`ru` kustomization** цього пакета — inline patch на **`kind: Deployment`**
  * з **`path: /spec/template/spec/nodeSelector`**: **ua** — **`preem: false`**; **ru** — **`yandex.cloud/preemptible: false`**.
  * Узагальнені вимоги **k8s.mdc** до JSON6902 (зокрема заборона **remove** + **add** на той самий **path**) перевіряє **check-k8s.mjs**; **check-abie** — лише abie-специфічний вміст (без дублювання цього правила).
  *
- * **HTTPRoute (overlay):** тієї ж умови — patch на **`kind: HTTPRoute`**, **непорожній `target.name`**: **`/spec/hostnames`**
+ * **HTTPRoute (overlay):** лише якщо в каталозі пакета (батько **`k8s`**) є **`vite.config.js`**, **`vite.config.mjs`** або **`vite.config.ts`**
+ * — тоді в **`ua`/`ru` kustomization** потрібен patch на **`kind: HTTPRoute`**, **непорожній `target.name`**: **`/spec/hostnames`**
  * (домени abie.mdc), **`/spec/parentRefs/0/namespace`** (**ua** / **ru**); для **ru** — **`gwin.yandex.cloud/rules.http.upgradeTypes: websocket`**.
  * Вибір **`op`** — **k8s.mdc**.
  */
@@ -66,6 +67,58 @@ export function isUaKustomizationPath(rel) {
   return /(^|\/)ua\/kustomization\.yaml$/u.test(norm)
 }
 
+/**
+ * Каталог пакета: шлях перед сегментом **`/k8s/`** для overlay **`…/k8s/(ua|ru)/kustomization.yaml`**.
+ * @param {string} root корінь репозиторію
+ * @param {string} kustomizationAbs абсолютний шлях до **ua** або **ru** kustomization.yaml
+ * @returns {string | null} абсолютний шлях до каталогу пакета або null, якщо шлях не overlay ua чи ru
+ */
+export function abiePackageDirFromK8sOverlay(root, kustomizationAbs) {
+  const rel = relative(root, kustomizationAbs).replaceAll('\\', '/') || kustomizationAbs
+  const m = rel.match(/^(.+)\/k8s\/(?:ua|ru)\/kustomization\.yaml$/u)
+  return m ? join(root, m[1]) : null
+}
+
+/**
+ * Чи для цього overlay застосовувати вимоги **HTTPRoute** (лише Vite-пакети).
+ * @param {string} root корінь репозиторію
+ * @param {string} kustomizationAbs абсолютний шлях до **ua** або **ru** kustomization.yaml
+ * @returns {boolean} **true**, якщо поруч із **k8s** є **vite.config** (**js** / **mjs** / **ts**)
+ */
+export function abieOverlayRequiresHttpRouteByVite(root, kustomizationAbs) {
+  const pkg = abiePackageDirFromK8sOverlay(root, kustomizationAbs)
+  if (!pkg) {
+    return false
+  }
+  return (
+    existsSync(join(pkg, 'vite.config.js')) ||
+    existsSync(join(pkg, 'vite.config.mjs')) ||
+    existsSync(join(pkg, 'vite.config.ts'))
+  )
+}
+
+/**
+ * Чи в дереві **k8s** того ж пакета, що й overlay **ua** або **ru**, є **Deployment** (за каталогами з **collectDeploymentDirs**).
+ * @param {Set<string>} deploymentDirs абсолютні каталоги YAML-файлів із **Deployment**
+ * @param {string} root корінь репозиторію
+ * @param {string} kustomizationAbs абсолютний шлях до **ua** або **ru** kustomization.yaml
+ * @returns {boolean} **true**, якщо хоч один каталог із **deploymentDirs** лежить під **`…/k8s/`** цього пакета
+ */
+export function abieOverlayK8sTreeHasDeployment(deploymentDirs, root, kustomizationAbs) {
+  const pkg = abiePackageDirFromK8sOverlay(root, kustomizationAbs)
+  if (!pkg) {
+    return false
+  }
+  const k8sRoot = join(pkg, 'k8s').replaceAll('\\', '/')
+  for (const dir of deploymentDirs) {
+    const norm = dir.replaceAll('\\', '/')
+    if (norm === k8sRoot || norm.startsWith(`${k8sRoot}/`)) {
+      return true
+    }
+  }
+  return false
+}
+
 /**
  * Чи відносний шлях до YAML під **k8s** вказує на файл у каталозі **`base`** (сегмент **`base`** у шляху), abie.mdc.
  * @param {string} rel шлях від кореня репозиторію
@@ -766,14 +819,16 @@ async function ensureRuKustomizationHealthCheckDelete(root, yamlFilesAbs, health
 }
 
 /**
- * Якщо є **Deployment** під **k8s**, вимагає в кожному overlay **ua** та **ru** (**kustomization.yaml**) JSON6902 patch nodeSelector (abie.mdc).
+ * Якщо є **Deployment** під **k8s**, вимагає в overlay **ua** та **ru** (**kustomization.yaml**) JSON6902 patch nodeSelector (abie.mdc)
+ * лише для kustomization того пакета, у дереві **k8s** якого є **Deployment**.
  * @param {string} root корінь репозиторію
  * @param {string[]} yamlFilesAbs yaml під k8s
+ * @param {Set<string>} deploymentDirs абсолютні каталоги YAML-файлів із **Deployment**
  * @param {(msg: string) => void} fail callback
  * @param {(msg: string) => void} passFn успішне повідомлення
  * @returns {Promise<void>}
  */
-async function ensureUaRuAbieNodeSelectorPatches(root, yamlFilesAbs, fail, passFn) {
+async function ensureUaRuAbieNodeSelectorPatches(root, yamlFilesAbs, deploymentDirs, fail, passFn) {
   const uaAbsList = yamlFilesAbs.filter(abs => isUaKustomizationPath(relative(root, abs).replaceAll('\\', '/') || abs))
   if (uaAbsList.length === 0) {
     fail(
@@ -783,21 +838,25 @@ async function ensureUaRuAbieNodeSelectorPatches(root, yamlFilesAbs, fail, passF
   }
   for (const abs of uaAbsList) {
     const rel = relative(root, abs).replaceAll('\\', '/') || abs
-    let raw
-    try {
-      raw = await readFile(abs, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${rel}: не вдалося прочитати (${msg})`)
-      return
-    }
-    if (!kustomizationHasAbieDeploymentNodeSelectorPatch(raw, 'ua')) {
-      fail(
-        `${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та preem: false (abie.mdc)`
-      )
-      return
+    if (abieOverlayK8sTreeHasDeployment(deploymentDirs, root, abs)) {
+      let raw
+      try {
+        raw = await readFile(abs, 'utf8')
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error)
+        fail(`${rel}: не вдалося прочитати (${msg})`)
+        return
+      }
+      if (!kustomizationHasAbieDeploymentNodeSelectorPatch(raw, 'ua')) {
+        fail(
+          `${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та preem: false (abie.mdc)`
+        )
+        return
+      }
+      passFn(`${rel}: nodeSelector patch (ua) відповідає abie.mdc`)
+    } else {
+      passFn(`${rel}: nodeSelector patch (ua) не застосовується — немає Deployment у дереві k8s цього пакета (abie)`)
     }
-    passFn(`${rel}: nodeSelector patch (ua) відповідає abie.mdc`)
   }
 
   const ruAbsList = yamlFilesAbs.filter(abs => isRuKustomizationPath(relative(root, abs).replaceAll('\\', '/') || abs))
@@ -809,26 +868,31 @@ async function ensureUaRuAbieNodeSelectorPatches(root, yamlFilesAbs, fail, passF
   }
   for (const abs of ruAbsList) {
     const rel = relative(root, abs).replaceAll('\\', '/') || abs
-    let raw
-    try {
-      raw = await readFile(abs, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${rel}: не вдалося прочитати (${msg})`)
-      return
-    }
-    if (!kustomizationHasAbieDeploymentNodeSelectorPatch(raw, 'ru')) {
-      fail(
-        `${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та yandex.cloud/preemptible: false (abie.mdc)`
-      )
-      return
+    if (abieOverlayK8sTreeHasDeployment(deploymentDirs, root, abs)) {
+      let raw
+      try {
+        raw = await readFile(abs, 'utf8')
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error)
+        fail(`${rel}: не вдалося прочитати (${msg})`)
+        return
+      }
+      if (!kustomizationHasAbieDeploymentNodeSelectorPatch(raw, 'ru')) {
+        fail(
+          `${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та yandex.cloud/preemptible: false (abie.mdc)`
+        )
+        return
+      }
+      passFn(`${rel}: nodeSelector patch (ru) відповідає abie.mdc`)
+    } else {
+      passFn(`${rel}: nodeSelector patch (ru) не застосовується — немає Deployment у дереві k8s цього пакета (abie)`)
     }
-    passFn(`${rel}: nodeSelector patch (ru) відповідає abie.mdc`)
   }
 }
 
 /**
- * Якщо є **Deployment** під **k8s**, вимагає в кожному overlay **ua** та **ru** patch **HTTPRoute** (непорожній **target.name**) за abie.mdc.
+ * Якщо є **Deployment** під **k8s**, вимагає в overlay **ua** та **ru** patch **HTTPRoute** (непорожній **target.name**) за abie.mdc
+ * лише для пакетів з **vite.config.{js,mjs,ts}** у каталозі пакета (батько **k8s**).
  * @param {string} root корінь репозиторію
  * @param {string[]} yamlFilesAbs yaml під k8s
  * @param {(msg: string) => void} fail callback
@@ -838,54 +902,60 @@ async function ensureUaRuAbieNodeSelectorPatches(root, yamlFilesAbs, fail, passF
 async function ensureUaRuAbieHttpRoutePatches(root, yamlFilesAbs, fail, passFn) {
   const uaAbsList = yamlFilesAbs.filter(abs => isUaKustomizationPath(relative(root, abs).replaceAll('\\', '/') || abs))
   if (uaAbsList.length === 0) {
-    fail(
-      'Є Deployment у k8s — додай ua/kustomization.yaml з patch HTTPRoute (будь-який target.name: hostnames, parentRefs namespace ua) — abie.mdc'
+    passFn(
+      'Немає ua/kustomization.yaml у дереві k8s — patch HTTPRoute (ua) не вимагається (abie.mdc, лише Vite-пакети)'
     )
-    return
   }
   for (const abs of uaAbsList) {
     const rel = relative(root, abs).replaceAll('\\', '/') || abs
-    let raw
-    try {
-      raw = await readFile(abs, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${rel}: не вдалося прочитати (${msg})`)
-      return
-    }
-    const combined = getCombinedNginxRunPatchTextFromKustomization(raw)
-    const v = validateAbieNginxRunHttpRoutePatches(combined, 'ua')
-    if (v !== null) {
-      fail(`${rel}: ${v}`)
-      return
+    if (abieOverlayRequiresHttpRouteByVite(root, abs)) {
+      let raw
+      try {
+        raw = await readFile(abs, 'utf8')
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error)
+        fail(`${rel}: не вдалося прочитати (${msg})`)
+        return
+      }
+      const combined = getCombinedNginxRunPatchTextFromKustomization(raw)
+      const v = validateAbieNginxRunHttpRoutePatches(combined, 'ua')
+      if (v !== null) {
+        fail(`${rel}: ${v}`)
+        return
+      }
+      passFn(`${rel}: HTTPRoute patch (ua) відповідає abie.mdc`)
+    } else {
+      passFn(`${rel}: HTTPRoute patch (ua) не застосовується — немає vite.config.{js,mjs,ts} у пакеті (abie)`)
     }
-    passFn(`${rel}: HTTPRoute patch (ua) відповідає abie.mdc`)
   }
 
   const ruAbsList = yamlFilesAbs.filter(abs => isRuKustomizationPath(relative(root, abs).replaceAll('\\', '/') || abs))
   if (ruAbsList.length === 0) {
-    fail(
-      'Є Deployment у k8s — додай ru/kustomization.yaml з patch HTTPRoute (будь-який target.name: hostnames, namespace ru, gwin websocket) — abie.mdc'
+    passFn(
+      'Немає ru/kustomization.yaml у дереві k8s — patch HTTPRoute (ru) не вимагається (abie.mdc, лише Vite-пакети)'
     )
-    return
   }
   for (const abs of ruAbsList) {
     const rel = relative(root, abs).replaceAll('\\', '/') || abs
-    let raw
-    try {
-      raw = await readFile(abs, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${rel}: не вдалося прочитати (${msg})`)
-      return
-    }
-    const combined = getCombinedNginxRunPatchTextFromKustomization(raw)
-    const v = validateAbieNginxRunHttpRoutePatches(combined, 'ru')
-    if (v !== null) {
-      fail(`${rel}: ${v}`)
-      return
+    if (abieOverlayRequiresHttpRouteByVite(root, abs)) {
+      let raw
+      try {
+        raw = await readFile(abs, 'utf8')
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error)
+        fail(`${rel}: не вдалося прочитати (${msg})`)
+        return
+      }
+      const combined = getCombinedNginxRunPatchTextFromKustomization(raw)
+      const v = validateAbieNginxRunHttpRoutePatches(combined, 'ru')
+      if (v !== null) {
+        fail(`${rel}: ${v}`)
+        return
+      }
+      passFn(`${rel}: HTTPRoute patch (ru) відповідає abie.mdc`)
+    } else {
+      passFn(`${rel}: HTTPRoute patch (ru) не застосовується — немає vite.config.{js,mjs,ts} у пакеті (abie)`)
     }
-    passFn(`${rel}: HTTPRoute patch (ru) відповідає abie.mdc`)
   }
 }
 
@@ -977,7 +1047,7 @@ export async function check() {
 
   if (deploymentDirs.size > 0) {
     pass('Є Deployment — перевіряємо nodeSelector у ua/ru kustomization (abie.mdc)')
-    await ensureUaRuAbieNodeSelectorPatches(root, yamlFiles, fail, pass)
+    await ensureUaRuAbieNodeSelectorPatches(root, yamlFiles, deploymentDirs, fail, pass)
     pass('Є Deployment — перевіряємо HTTPRoute у ua/ru kustomization (abie.mdc)')
     await ensureUaRuAbieHttpRoutePatches(root, yamlFiles, fail, pass)
   }

package/scripts/check-k8s.mjs

@@ -735,7 +735,7 @@ function extractJson6902OpsFromArray(arr) {
  * Витягує операції JSON6902 з тексту inline **patch** або окремого файлу patch (YAML-масив або JSON-масив).
  * Інший вміст (strategic merge, `$patch: delete` тощо) дає порожній масив.
  * @param {string} patchText вміст поля **patch** або файлу
- * @returns {Array<{ op: string, path: string }>}
+ * @returns {Array<{ op: string, path: string }>} нормалізовані **op** / **path** або порожній масив, якщо не JSON6902-масив
  */
 export function collectJson6902OperationsFromPatchText(patchText) {
   const t = typeof patchText === 'string' ? patchText.trim() : ''
@@ -745,12 +745,11 @@ export function collectJson6902OperationsFromPatchText(patchText) {
   try {
     const docs = parseAllDocuments(t)
     for (const d of docs) {
-      if (d.errors.length > 0) {
-        continue
-      }
-      const j = d.toJSON()
-      if (Array.isArray(j)) {
-        return extractJson6902OpsFromArray(j)
+      if (d.errors.length === 0) {
+        const j = d.toJSON()
+        if (Array.isArray(j)) {
+          return extractJson6902OpsFromArray(j)
+        }
       }
     }
   } catch {
@@ -778,13 +777,12 @@ export function json6902PathsWithRemoveAndAddOnSamePath(ops) {
   /** @type {Map<string, Set<string>>} */
   const byPath = new Map()
   for (const { op, path } of ops) {
-    if (!path) {
-      continue
-    }
-    if (!byPath.has(path)) {
-      byPath.set(path, new Set())
+    if (path) {
+      if (!byPath.has(path)) {
+        byPath.set(path, new Set())
+      }
+      byPath.get(path).add(op)
     }
-    byPath.get(path).add(op)
   }
   /** @type {string[]} */
   const out = []
@@ -806,93 +804,91 @@ export function json6902PathsWithRemoveAndAddOnSamePath(ops) {
 async function validateKustomizationJson6902NoRemoveAddSamePath(root, yamlFilesAbs, fail) {
   const rootNorm = resolve(root)
   for (const kustAbs of yamlFilesAbs) {
-    if (basename(kustAbs).toLowerCase() !== 'kustomization.yaml') {
-      continue
-    }
-    const rel = (relative(root, kustAbs) || kustAbs).replaceAll('\\', '/')
-    let raw
-    try {
-      raw = await readFile(kustAbs, 'utf8')
-    } catch (error) {
-      const msg = error instanceof Error ? error.message : String(error)
-      fail(`${rel}: не вдалося прочитати для перевірки JSON6902 (${msg})`)
-      continue
-    }
-    const lines = toLines(raw)
-    const body = lines.length > 0 && MODELINE_RE.test(lines[0]) ? yamlBodyAfterModeline(lines) : lines.join('\n')
-    /** @type {import('yaml').Document[]} */
-    let docs
-    try {
-      docs = parseAllDocuments(body)
-    } catch {
-      continue
-    }
-    for (const doc of docs) {
-      if (doc.errors.length > 0) {
-        continue
-      }
-      const rootObj = doc.toJSON()
-      if (rootObj === null || typeof rootObj !== 'object' || Array.isArray(rootObj)) {
-        continue
-      }
-      const rec = /** @type {Record<string, unknown>} */ (rootObj)
-      if (rec.kind !== 'Kustomization') {
-        continue
-      }
-      const patches = rec.patches
-      if (!Array.isArray(patches)) {
-        continue
+    if (basename(kustAbs).toLowerCase() === 'kustomization.yaml') {
+      const rel = (relative(root, kustAbs) || kustAbs).replaceAll('\\', '/')
+      /** @type {string | undefined} */
+      let raw
+      let readOk = false
+      try {
+        raw = await readFile(kustAbs, 'utf8')
+        readOk = true
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error)
+        fail(`${rel}: не вдалося прочитати для перевірки JSON6902 (${msg})`)
       }
-      let patchIdx = 0
-      for (const p of patches) {
-        patchIdx++
-        if (p === null || typeof p !== 'object' || Array.isArray(p)) {
-          continue
-        }
-        const pr = /** @type {Record<string, unknown>} */ (p)
-        if (typeof pr.patch === 'string' && pr.patch.trim() !== '') {
-          const ops = collectJson6902OperationsFromPatchText(pr.patch)
-          const bad = json6902PathsWithRemoveAndAddOnSamePath(ops)
-          if (bad.length > 0) {
-            fail(
-              `${rel}: patches[${patchIdx}] inline JSON6902: один path має і remove, і add — оформи як op: replace (k8s.mdc): ${bad.join(', ')}`
-            )
-          }
+      if (readOk && raw !== undefined) {
+        const lines = toLines(raw)
+        const body = lines.length > 0 && MODELINE_RE.test(lines[0]) ? yamlBodyAfterModeline(lines) : lines.join('\n')
+        /** @type {import('yaml').Document[] | null} */
+        let docs = null
+        try {
+          docs = parseAllDocuments(body)
+        } catch {
+          docs = null
         }
-        if (typeof pr.path === 'string' && pr.path.trim() !== '') {
-          const patchRef = pr.path.trim()
-          const resolved = resolve(dirname(kustAbs), patchRef)
-          if (!resolvedFilePathIsUnderRoot(rootNorm, resolved)) {
-            continue
-          }
-          if (!existsSync(resolved)) {
-            continue
-          }
-          let st
-          try {
-            st = await stat(resolved)
-          } catch {
-            continue
-          }
-          if (!st.isFile()) {
-            continue
-          }
-          let pRaw
-          try {
-            pRaw = await readFile(resolved, 'utf8')
-          } catch {
-            continue
-          }
-          const ops = collectJson6902OperationsFromPatchText(pRaw)
-          if (ops.length === 0) {
-            continue
-          }
-          const bad = json6902PathsWithRemoveAndAddOnSamePath(ops)
-          if (bad.length > 0) {
-            const relPatch = (relative(root, resolved) || patchRef).replaceAll('\\', '/')
-            fail(
-              `${rel}: patch-файл «${relPatch}»: один path має і remove, і add — оформи як op: replace (k8s.mdc): ${bad.join(', ')}`
-            )
+        if (docs !== null) {
+          for (const doc of docs) {
+            if (doc.errors.length === 0) {
+              const rootObj = doc.toJSON()
+              if (rootObj !== null && typeof rootObj === 'object' && !Array.isArray(rootObj)) {
+                const rec = /** @type {Record<string, unknown>} */ (rootObj)
+                if (rec.kind === 'Kustomization') {
+                  const patches = rec.patches
+                  if (Array.isArray(patches)) {
+                    let patchIdx = 0
+                    for (const p of patches) {
+                      patchIdx++
+                      if (p !== null && typeof p === 'object' && !Array.isArray(p)) {
+                        const pr = /** @type {Record<string, unknown>} */ (p)
+                        if (typeof pr.patch === 'string' && pr.patch.trim() !== '') {
+                          const ops = collectJson6902OperationsFromPatchText(pr.patch)
+                          const bad = json6902PathsWithRemoveAndAddOnSamePath(ops)
+                          if (bad.length > 0) {
+                            fail(
+                              `${rel}: patches[${patchIdx}] inline JSON6902: один path має і remove, і add — оформи як op: replace (k8s.mdc): ${bad.join(', ')}`
+                            )
+                          }
+                        }
+                        if (typeof pr.path === 'string' && pr.path.trim() !== '') {
+                          const patchRef = pr.path.trim()
+                          const resolved = resolve(dirname(kustAbs), patchRef)
+                          if (resolvedFilePathIsUnderRoot(rootNorm, resolved) && existsSync(resolved)) {
+                            /** @type {import('node:fs').Stats | null} */
+                            let st = null
+                            try {
+                              st = await stat(resolved)
+                            } catch {
+                              st = null
+                            }
+                            if (st !== null && st.isFile()) {
+                              /** @type {string | undefined} */
+                              let pRaw
+                              try {
+                                pRaw = await readFile(resolved, 'utf8')
+                              } catch {
+                                pRaw = undefined
+                              }
+                              if (pRaw !== undefined) {
+                                const ops = collectJson6902OperationsFromPatchText(pRaw)
+                                if (ops.length > 0) {
+                                  const bad = json6902PathsWithRemoveAndAddOnSamePath(ops)
+                                  if (bad.length > 0) {
+                                    const relPatch = (relative(root, resolved) || patchRef).replaceAll('\\', '/')
+                                    fail(
+                                      `${rel}: patch-файл «${relPatch}»: один path має і remove, і add — оформи як op: replace (k8s.mdc): ${bad.join(', ')}`
+                                    )
+                                  }
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }