@nitra/cursor 1.8.96 → 1.8.98

package/mdc/abie.mdc

@@ -1,10 +1,10 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.11'
+version: '1.14'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`filelint-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона артефактів **Firebase Hosting** у корені репозиторію.
+Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`filelint-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона артефактів **Firebase Hosting** у корені репозиторію.
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -113,6 +113,21 @@ spec:
           gwin.yandex.cloud/rules.http.upgradeTypes: "websocket"
 ```
 
+## k8s: overlay **ru** і **Service** (у т. ч. headless → NodePort)
+
+Для кожного **Service** в YAML під **`…/k8s/…`**, де шлях файлу **не** містить **`k8s/ua/`** чи **`k8s/ru/`** (маніфести base / спільного шару; у т. ч. **headless** з **`spec.clusterIP: None`** і **`-hl`**), якщо ще не **`spec.type: NodePort`** / **`LoadBalancer`** / **`ExternalName`**, у **`k8s/ru/kustomization.yaml`** того ж пакета (overlay **ru**) додай **inline** **JSON6902** у **`patches`**: **`target.kind: Service`**, **`target.name`** як у маніфеста, **`path: /spec/type`**, **`value: NodePort`**. Деталі перевірки — **`check-abie.mjs`**.
+
+```yaml title="…/ru/kustomization.yaml (фрагмент)"
+patches:
+  - target:
+      kind: Service
+      name: my-app
+    patch: |-
+      - op: replace
+        path: /spec/type
+        value: NodePort
+```
+
 ## k8s: overlay **ru** і HealthCheckPolicy
 
 Якщо в дереві **k8s** є **HealthCheckPolicy**, у **`ru/kustomization.yaml`** має бути patch **`$patch: delete`** для політики (узгоджено з **k8s.mdc**; перевірка в **`check-k8s.mjs`**, **`ruKustomizationHasHealthCheckDeletePatch`**). Підстав реальне ім’я замість **`СЕРВІС`**:

package/mdc/bun.mdc

@@ -50,7 +50,7 @@ Lockfile у репозиторії: `bun.lock`.
 - Якщо залежність потрібна лише одному пакету, додавати її в директорії цього пакета.
 - У CI та локально запускати скрипти через `bun run`.
 
-В кореневому в package.json не повинно бути `dependencies`, а в  `devDependencies` будуть тільки `@cspell/*` та `@nitra/*` модулі.
+В кореневому в package.json не повинно бути `dependencies`, а в `devDependencies` — тільки модулі `@nitra/*`
 
 Якщо в package.json є поля `packageManager`, то прибрати їх, також прибрати всі директорії та файли для yarn
 

package/mdc/graphql.mdc

@@ -4,7 +4,7 @@ alwaysApply: true
 version: '1.0'
 ---
 
-Якщо в **`.vue`** або в **JavaScript / TypeScript** джерелах (`.js`, `.mjs`, `.cjs`, `.ts`, `.tsx`, `.jsx` тощо) зустрічається **tagged template literal** з тегом **`gql`** (типово `gql\`query …\`` для GraphQL-запиту), у **корені репозиторію** має бути файл **`.graphqlrc.yml`** ([GraphQL Config](https://the-guild.dev/graphql/config/docs)), а в **`.vscode/extensions.json`** у масиві **`recommendations`** — запис **`graphql.vscode-graphql`**, щоб підсвітка, навігація до схеми й діагностика працювали в редакторі.
+Якщо в **`.vue`** або в **JavaScript / TypeScript** джерелах (`.js`, `.mjs`, `.cjs`, `.ts`, `.tsx`, `.jsx` тощо) зустрічається **tagged template literal** з тегом **`gql`** (типово `gql\`query …\``для GraphQL-запиту), у **корені репозиторію** має бути файл **`.graphqlrc.yml`** ([GraphQL Config](https://the-guild.dev/graphql/config/docs)), а в **`.vscode/extensions.json`** у масиві **`recommendations`** — запис **`graphql.vscode-graphql`**, щоб підсвітка, навігація до схеми й діагностика працювали в редакторі.
 
 Деталі виявлення `gql` у скриптах (у т.ч. лише `<script>` у SFC) — **`npm/scripts/check-graphql.mjs`** / **`npm/scripts/utils/graphql-gql-scan.mjs`**.
 

package/mdc/js-lint.mdc

@@ -30,7 +30,7 @@ version: '1.13'
 }
 ```
 
-У корені має бути **`.oxlintrc.json`** з підключенням **`@e18e/eslint-plugin`** через **`jsPlugins`** і правилом **`e18e/prefer-includes`** зі значенням **`error`**. Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.5.0**), oxlint резолвить його з **`node_modules`**.
+У корені має бути **`.oxlintrc.json`** з підключенням **`@e18e/eslint-plugin`** через **`jsPlugins`** і правилом **`e18e/prefer-includes`** зі значенням **`error`**. Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.5.0**), oxlint підвантажує його з **`node_modules`**.
 
 ```json title=".oxlintrc.json (фрагмент)"
 {

package/mdc/text.mdc

@@ -110,7 +110,7 @@ version: '1.25'
 
 Завжди пиши **JSDoc** до функцій та методів.
 
-**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**. Для української додай **`@cspell/dict-uk-ua`**. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
+**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`** (**`^2.0.0`** або новіший у лінії 2.x) — з **2.0.0** у пакет транзитивно входять типові **`@cspell/dict-*`**, тому **не** додавай їх окремо в корінь. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
 
 У v8r **немає** прапорця тихого режиму; рекомендовано скрипт **`run-v8r.mjs`** з репозиторію пакета `@nitra/cursor` (`npm/scripts/run-v8r.mjs`): один виклик у `lint-text` — під капотом послідовні **`bunx v8r`** для кожного типу (**json**, **json5**, **yml**, **yaml**, **toml**), бо один процес v8r з кількома глобами падає з **98**, якщо хоч один glob порожній, і тоді інші розширення не перевіряються. Вивід при кодах **0** і **98** не показується. Каталог схем **`schemas/v8r-catalog.json`** пакета `@nitra/cursor` скрипт підставляє в v8r сам. За бажання можна передати власні glob-и аргументами скрипта. Шлях до скрипта: `./npm/scripts/…`, `./scripts/…` після копіювання, або `node_modules/@nitra/cursor/scripts/…`.
 
@@ -120,7 +120,7 @@ version: '1.25'
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^1.0.188"
+    "@nitra/cspell-dict": "^2.0.0"
   }
 }
 ```
@@ -235,17 +235,16 @@ jobs:
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^1.0.188",
-    "@cspell/dict-uk-ua": "^4.0.6"
+    "@nitra/cspell-dict": "^2.0.0"
   }
 }
 ```
 
-## Проєкт з українською мовою
+## Проєкт з українською та російською (і суміжні мови)
 
-Якщо в репозиторії є українська документація, коментарі або рядки в коді — потрібен **окремий словник** `@cspell/dict-ru_ru`, інакше cspell не перевірятиме російський правопис коректно.
+У **`@nitra/cspell-dict`** від **2.0.0** уже зібрані залежності на **`@cspell/dict-uk-ua`**, **`@cspell/dict-ru_ru`** та інші типові словники — **не** дублюй їх у кореневому `package.json` і **не** імпортуй **`@cspell/dict-*/cspell-ext.json`** у `.cspell.json`.
 
-**1. Залежності** — додай пакет словника поруч із `@nitra/cspell-dict`:
+**1. Залежності** — лише корпоративний пакет:
 
 ```json title="package.json"
 {
@@ -253,31 +252,26 @@ jobs:
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^1.0.188",
-    "@cspell/dict-uk-ua": "^4.0.6",
-    "@cspell/dict-ru_ru": "^2.3.2"
+    "@nitra/cspell-dict": "^2.0.0"
   }
 }
 ```
 
-Встановлення: `bun add -d @cspell/dict-uk-ua` (або `npm i -D @cspell/dict-uk-ua`).
+Встановлення: `bun add -d @nitra/cspell-dict@^2.0.0`.
 
-**2. `.cspell.json`** — у полі `language` має бути `uk` (разом з іншими мовами через кому), у `import` — підключення розширення українського словника:
+**2. `.cspell.json`** — у полі **`language`** додай потрібні коди (наприклад **`uk`**, **`ru-ru`** разом з **`en`** та **`nitra`**). У **`import`** залиш лише **`@nitra/cspell-dict/cspell-ext.json`**:
 
 ```json title=".cspell.json"
 {
   "version": "0.2",
-  "language": "en,uk,nitra",
+  "language": "en,uk,ru-ru,nitra",
   "ignorePaths": ["**/node_modules/**", "**/vscode-extension/**", "**/.git/**", ".vscode", "report", "*.svg", "**/k8s/**/*.yaml"],
-  "import": [
-    "@nitra/cspell-dict/cspell-ext.json",
-    "@cspell/dict-uk-ua/cspell-ext.json"
-  ],
+  "import": ["@nitra/cspell-dict/cspell-ext.json"],
   "words": []
 }
 ```
 
-Підлаштуй `language` під проєкт (наприклад додай `ru-ru`, якщо потрібна перевірка російською). Порядок у `import` може впливати на пріоритет словників — тримай корпоративний `@nitra/cspell-dict` там, де зручно для ваших правил.
+Підлаштуй **`language`** під проєкт. Порядок у **`import`** може впливати на пріоритет словників — тримай корпоративний **`@nitra/cspell-dict`** першим, якщо додаєш інші розширення (рідко).
 
 **Український апостроф:** у словах не використовуй прямий символ `'` (U+0027); потрібен типографський апостроф `’` (U+2019). Якщо після цього cspell досі підсвічує слово як невідоме — додай його до масиву `words` у `.cspell.json`.
 
@@ -293,7 +287,7 @@ jobs:
 
 ## Інші мови
 
-Для іншої мови встанови відповідний пакет `@cspell/dict-*`, додай його `cspell-ext.json` у `import` і код мови в `language`. Огляд словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
+Якщо потрібна мова вже є в залежностях **`@nitra/cspell-dict`** — додай лише код у **`language`**, без окремих **`@cspell/dict-*`** у споживачі. Якщо мови немає в корпоративному пакеті — розширюй **`@nitra/cspell-dict`**, а не підключай **`@cspell/dict-*`** у корені репозиторію-споживача. Огляд upstream-словників: [streetsidesoftware/cspell-dicts](https://github.com/streetsidesoftware/cspell-dicts).
 
 ## Перевірка
 

package/package.json

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

package/scripts/check-abie.mjs

@@ -32,6 +32,9 @@
  * **Спільні бекенди (`auth-run-hl`, `filelint-hl`):** у **HTTPRoute** під **`k8s`** поза overlay **ua** та **ru** (шлях не містить **`k8s/ua/`** чи **`k8s/ru/`**) кожен такий **`backendRefs`** має **`namespace: dev`** і порт **8080**;
  * у patch overlay **ua** та **ru** — по одному **JSON6902** на **`/spec/rules/…/backendRefs/…/namespace`** з **`value`**: **ua** або **ru** (кількість patch-ів = кількість таких **`backendRefs`** у пакеті).
  * Вибір **`op`** — **k8s.mdc**.
+ *
+ * **Service (overlay ru):** для кожного **Service**, оголошеного в YAML під **`…/k8s/…`**, де шлях **не** проходить через **`k8s/ua/`** чи **`k8s/ru/`** (маніфести base / спільного шару, у т. ч. **headless** з **`clusterIP: None`** і **`-hl`**), якщо ще не **NodePort** / **LoadBalancer** / **ExternalName**,
+ * у файлі **`k8s/ru/kustomization.yaml`** того ж пакета (overlay середовища **ru**) — inline **JSON6902** на **`kind: Service`** з тим самим **`target.name`**: **`path: /spec/type`**, **`value: NodePort`**.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
@@ -295,6 +298,286 @@ function isDeploymentDoc(obj) {
   )
 }
 
+/**
+ * Чи документ — **Service**.
+ * @param {unknown} obj корінь YAML-документа
+ * @returns {boolean} true, якщо **kind** — **Service**
+ */
+function isServiceDoc(obj) {
+  return (
+    obj !== null &&
+    typeof obj === 'object' &&
+    !Array.isArray(obj) &&
+    /** @type {Record<string, unknown>} */ (obj).kind === 'Service'
+  )
+}
+
+/**
+ * Чи відносний шлях до YAML під **`…/k8s/…`** не в каталозі overlay **`k8s/ua/`** чи **`k8s/ru/`** у репозиторії (після **`k8s/`** одразу не йде **`ua/`** чи **`ru/`**).
+ * @param {string} relFromRoot шлях від кореня
+ * @returns {boolean} true для base / спільних маніфестів; **false** для файлів усередині **`k8s/ua/…`** або **`k8s/ru/…`**
+ */
+function k8sYamlRelOutsideUaRuOverlays(relFromRoot) {
+  const norm = relFromRoot.replaceAll('\\', '/')
+  const idx = norm.indexOf('/k8s/')
+  if (idx === -1) {
+    return false
+  }
+  const after = norm.slice(idx + '/k8s/'.length)
+  return after.length > 0 && !after.startsWith('ua/') && !after.startsWith('ru/')
+}
+
+/**
+ * Каталог пакета з відносного шляху **`…/k8s/…`** (частина до **`/k8s/`**).
+ * @param {string} root корінь репозиторію
+ * @param {string} relFromRoot відносний шлях
+ * @returns {string | null} абсолютний шлях до каталогу пакета або **null**
+ */
+function abiePackageDirFromK8sYamlRel(root, relFromRoot) {
+  const norm = relFromRoot.replaceAll('\\', '/')
+  const m = norm.match(/^(.+)\/k8s\//u)
+  return m ? join(root, m[1]) : null
+}
+
+/**
+ * Чи **Service** у base-шарі abie потребує в **ru** patch **`spec.type: NodePort`** (у т. ч. **headless**; не вже **NodePort** / **LoadBalancer** / **ExternalName**).
+ * @param {unknown} obj корінь YAML (**Service**)
+ * @returns {boolean} true, якщо для overlay **ru** очікується **NodePort**
+ */
+export function serviceDocumentRequiresAbieRuNodePortOverlay(obj) {
+  if (!isServiceDoc(obj)) {
+    return false
+  }
+  const rec = /** @type {Record<string, unknown>} */ (obj)
+  const meta = rec.metadata
+  if (meta === null || typeof meta !== 'object' || Array.isArray(meta)) {
+    return false
+  }
+  const name = /** @type {Record<string, unknown>} */ (meta).name
+  if (typeof name !== 'string' || name.trim() === '') {
+    return false
+  }
+  const spec = rec.spec
+  if (spec === null || typeof spec !== 'object' || Array.isArray(spec)) {
+    return true
+  }
+  const sp = /** @type {Record<string, unknown>} */ (spec)
+  const t = sp.type
+  if (t === 'NodePort' || t === 'LoadBalancer' || t === 'ExternalName') {
+    return false
+  }
+  return true
+}
+
+/**
+ * Чи фрагмент **JSON6902** у **`patch`** задає **`/spec/type`** зі значенням **NodePort** (abie overlay **ru**).
+ * @param {string} patchText поле **patch** у kustomization
+ * @returns {boolean} true, якщо знайдено **path** і **value**
+ */
+export function jsonPatchTextSetsServiceTypeNodePort(patchText) {
+  if (typeof patchText !== 'string' || patchText.trim() === '') {
+    return false
+  }
+  if (!/path:\s*\/spec\/type\b/u.test(patchText)) {
+    return false
+  }
+  if (!/value:\s*['"]?NodePort['"]?(?:\s|$)/iu.test(patchText)) {
+    return false
+  }
+  return true
+}
+
+/**
+ * З одного документа **Kustomization** збирає пари **Service name → patch text** для **inline patches** з **target.kind: Service**.
+ * @param {import('yaml').Document} doc документ після **parseAllDocuments**
+ * @returns {Map<string, string>} ім’я сервісу → текст **patch**
+ */
+function collectAbieServicePatchTextsByNameFromKustomizationDoc(doc) {
+  /** @type {Map<string, string>} */
+  const out = new Map()
+  if (doc.errors.length > 0) {
+    return out
+  }
+  const root = doc.toJSON()
+  if (root === null || typeof root !== 'object' || Array.isArray(root)) {
+    return out
+  }
+  const rec = /** @type {Record<string, unknown>} */ (root)
+  if (rec.kind !== 'Kustomization') {
+    return out
+  }
+  const patches = rec.patches
+  if (!Array.isArray(patches)) {
+    return out
+  }
+  for (const p of patches) {
+    if (p !== null && typeof p === 'object' && !Array.isArray(p)) {
+      const pr = /** @type {Record<string, unknown>} */ (p)
+      const target = pr.target
+      if (target !== null && typeof target === 'object' && !Array.isArray(target)) {
+        const tg = /** @type {Record<string, unknown>} */ (target)
+        if (tg.kind === 'Service' && typeof tg.name === 'string' && tg.name.trim() !== '') {
+          const patchStr = pr.patch
+          if (typeof patchStr === 'string' && patchStr.trim() !== '') {
+            const prev = out.get(tg.name)
+            out.set(tg.name, prev === undefined ? patchStr : `${prev}\n${patchStr}`)
+          }
+        }
+      }
+    }
+  }
+  return out
+}
+
+/**
+ * Імена **Service**, для яких у **ru/kustomization.yaml** немає очікуваного patch **`/spec/type` → NodePort** (abie.mdc).
+ * @param {string} raw повний текст **kustomization.yaml**
+ * @param {Iterable<string>} serviceNames імена **metadata.name** з base-шару
+ * @returns {string[]} відсортовані імена без коректного patch
+ */
+export function getMissingAbieRuServiceNodePortPatchServiceNames(raw, serviceNames) {
+  const req = [...new Set([...serviceNames].filter(n => typeof n === 'string' && n.trim() !== ''))].toSorted((a, b) =>
+    a.localeCompare(b)
+  )
+  if (req.length === 0) {
+    return []
+  }
+  const body = stripBom(raw)
+  const lines = body.split(/\r?\n/u)
+  const first = lines[0] ?? ''
+  const rest = MODELINE_RE.test(first.trim()) ? lines.slice(1).join('\n') : body
+  /** @type {import('yaml').Document[]} */
+  let docs
+  try {
+    docs = parseAllDocuments(rest)
+  } catch {
+    return req
+  }
+  /** @type {Map<string, string>} */
+  const byName = new Map()
+  for (const doc of docs) {
+    const chunk = collectAbieServicePatchTextsByNameFromKustomizationDoc(doc)
+    for (const [k, v] of chunk) {
+      const prev = byName.get(k)
+      byName.set(k, prev === undefined ? v : `${prev}\n${v}`)
+    }
+  }
+  return req.filter(n => {
+    const pt = byName.get(n)
+    return pt === undefined || !jsonPatchTextSetsServiceTypeNodePort(pt)
+  })
+}
+
+/**
+ * Для кожного пакета збирає імена **Service**, які в overlay **ru** мають стати **NodePort** (abie.mdc).
+ * @param {string} root корінь репозиторію
+ * @param {string[]} yamlAbs абсолютні шляхи yaml під **k8s**
+ * @param {(msg: string) => void} fail реєстрація помилки читання/парсингу
+ * @returns {Promise<Map<string, Set<string>>>} **pkgAbs** → множина імен **Service**
+ */
+async function collectAbieRuNodePortServiceNamesByPackage(root, yamlAbs, fail) {
+  /** @type {Map<string, Set<string>>} */
+  const map = new Map()
+  for (const abs of yamlAbs) {
+    const rel = relative(root, abs).replaceAll('\\', '/') || abs
+    if (k8sYamlRelOutsideUaRuOverlays(rel)) {
+      const pkgAbs = abiePackageDirFromK8sYamlRel(root, rel)
+      if (pkgAbs) {
+        let raw
+        let readOk = false
+        try {
+          raw = await readFile(abs, 'utf8')
+          readOk = true
+        } catch (error) {
+          const msg = error instanceof Error ? error.message : String(error)
+          fail(`${rel}: не вдалося прочитати (${msg})`)
+        }
+        if (readOk) {
+          const body = stripBom(raw)
+          const lines = body.split(/\r?\n/u)
+          const first = lines[0] ?? ''
+          const rest = MODELINE_RE.test(first.trim()) ? lines.slice(1).join('\n') : body
+          /** @type {import('yaml').Document[]} */
+          let docs
+          let parseOk = false
+          try {
+            docs = parseAllDocuments(rest)
+            parseOk = true
+          } catch (error) {
+            const msg = error instanceof Error ? error.message : String(error)
+            fail(`${rel}: YAML (${msg})`)
+          }
+          if (parseOk) {
+            for (const doc of docs) {
+              if (doc.errors.length === 0) {
+                const obj = doc.toJSON()
+                if (serviceDocumentRequiresAbieRuNodePortOverlay(obj)) {
+                  const rec = /** @type {Record<string, unknown>} */ (obj)
+                  const meta = /** @type {Record<string, unknown>} */ (rec.metadata)
+                  const n = meta.name
+                  if (typeof n === 'string' && n.trim() !== '') {
+                    let s = map.get(pkgAbs)
+                    if (!s) {
+                      s = new Set()
+                      map.set(pkgAbs, s)
+                    }
+                    s.add(n)
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  return map
+}
+
+/**
+ * У **`k8s/ru/kustomization.yaml`** для кожного **Service** з YAML **`k8s`**, шлях якого без сегментів **`k8s/ua/`** та **`k8s/ru/`** (у т. ч. **headless** / **`-hl`**) — **JSON6902** **`/spec/type` → NodePort**, якщо ще не **NodePort** / **LoadBalancer** / **ExternalName** (abie.mdc).
+ * @param {string} root корінь
+ * @param {string[]} yamlFilesAbs yaml під **k8s**
+ * @param {(msg: string) => void} fail callback
+ * @param {(msg: string) => void} passFn успішне повідомлення
+ * @returns {Promise<void>}
+ */
+async function ensureRuAbieServiceNodePortPatches(root, yamlFilesAbs, fail, passFn) {
+  const byPkg = await collectAbieRuNodePortServiceNamesByPackage(root, yamlFilesAbs, fail)
+  const entries = [...byPkg.entries()].filter(([, names]) => names.size > 0)
+  if (entries.length === 0) {
+    passFn('Немає Service у шарі k8s без k8s/ua/ та k8s/ru/ — patch NodePort у k8s/ru/ не вимагається (abie.mdc)')
+    return
+  }
+  for (const [pkgAbs, names] of entries.toSorted((a, b) => a[0].localeCompare(b[0]))) {
+    const relPkg = relative(root, pkgAbs).replaceAll('\\', '/') || pkgAbs
+    const ruAbs = join(pkgAbs, 'k8s', 'ru', 'kustomization.yaml')
+    if (!existsSync(ruAbs)) {
+      fail(
+        `${relPkg}/k8s: є Service (у т. ч. headless), для overlay ru потрібен patch /spec/type → NodePort: ${[...names].toSorted((a, b) => a.localeCompare(b)).join(', ')} — додай ru/kustomization.yaml (abie.mdc)`
+      )
+      return
+    }
+    const relRu = relative(root, ruAbs).replaceAll('\\', '/') || ruAbs
+    let raw
+    try {
+      raw = await readFile(ruAbs, 'utf8')
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`${relRu}: не вдалося прочитати (${msg})`)
+      return
+    }
+    const missing = getMissingAbieRuServiceNodePortPatchServiceNames(raw, names)
+    if (missing.length > 0) {
+      fail(
+        `${relRu}: для kind: Service потрібен inline JSON6902 з path /spec/type та value NodePort (ім’я target: ${missing.join(', ')}) — abie.mdc`
+      )
+      return
+    }
+    passFn(`${relRu}: patch Service → NodePort (ru) відповідає abie.mdc`)
+  }
+}
+
 /**
  * Директорії, де є хоча б один **Deployment** у файлах **k8s**.
  * @param {string} root корінь cwd
@@ -1273,6 +1556,9 @@ export async function check() {
   const healthCheckPolicyRelativePaths = await collectHealthCheckPolicyRelPaths(root, yamlFiles)
   await ensureRuKustomizationHealthCheckDelete(root, yamlFiles, healthCheckPolicyRelativePaths, fail)
 
+  pass('Перевіряємо Service → NodePort у ru/kustomization (abie.mdc)')
+  await ensureRuAbieServiceNodePortPatches(root, yamlFiles, fail, pass)
+
   if (deploymentDirs.size > 0) {
     pass('Є Deployment — перевіряємо nodeSelector у ua/ru kustomization (abie.mdc)')
     await ensureUaRuAbieNodeSelectorPatches(root, yamlFiles, deploymentDirs, fail, pass)

package/scripts/check-bun.mjs

@@ -4,8 +4,8 @@
  * Очікує наявність `bun.lock`, забороняє lockfile та артефакти yarn/pnpm, директорію `.yarn`
  * і поле `packageManager` у кореневому `package.json`.
  *
- * У кореневому `package.json` не має бути поля **`dependencies`**; у **`devDependencies`** дозволені
- * лише пакети з префіксами **`@cspell/`** та **`@nitra/`** (інші залежності — у workspace-пакетах).
+ * У кореневому `package.json` не має бути поля **`dependencies`**; у **`devDependencies`** дозволені лише
+ * пакети **`@nitra/*`** (наприклад **`@nitra/cspell-dict`**, **`@nitra/eslint-config`**).
  *
  * Якщо в `.n-cursor.json` у `rules` є `docker` або `k8s`, вимагає у кореневому `package.json`
  * відповідно скриптів `lint-docker` / `lint-k8s` (див. docker.mdc, k8s.mdc).
@@ -20,12 +20,12 @@ import { readFile } from 'node:fs/promises'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 
 /**
- * Чи ім'я пакета дозволене в кореневих `devDependencies` за bun.mdc (лише `@cspell/*` та `@nitra/*`).
+ * Чи ім'я пакета дозволене в кореневих `devDependencies` за bun.mdc (лише **`@nitra/*`**).
  * @param {string} name ключ з поля `devDependencies`
  * @returns {boolean} true, якщо префікс дозволений
  */
 export function isAllowedRootDevDependency(name) {
-  return name.startsWith('@cspell/') || name.startsWith('@nitra/')
+  return name.startsWith('@nitra/')
 }
 
 /**
@@ -105,14 +105,14 @@ export async function check() {
       const bad = Object.keys(dev).filter(n => !isAllowedRootDevDependency(n))
       if (bad.length > 0) {
         fail(
-          `Кореневі devDependencies дозволені лише @cspell/* та @nitra/* — прибери або перенеси: ${bad.join(', ')} (bun.mdc)`
+          `Кореневі devDependencies: дозволені лише @nitra/* — прибери або перенеси: ${bad.join(', ')} (bun.mdc)`
         )
       } else {
         const n = Object.keys(dev).length
         pass(
           n === 0
-            ? 'Кореневі devDependencies порожні (дозволені лише @cspell/* та @nitra/*)'
-            : `Кореневі devDependencies лише @cspell/* та @nitra/* (${n} пак.)`
+            ? 'Кореневі devDependencies порожні або відсутні (лише @nitra/*)'
+            : `Кореневі devDependencies: лише @nitra/* (${n} пак.)`
         )
       }
     }

package/scripts/check-graphql.mjs

@@ -1,7 +1,7 @@
 /**
  * Перевіряє правило graphql.mdc: наявність **`.graphqlrc.yml`** і рекомендації **`graphql.vscode-graphql`**, якщо у дереві є **`gql\`…\``**.
  *
- * Обхід репозиторію — **`walkDir`** від **`process.cwd()`** (пропуски як у інших check). Кандидати — **`.vue`** та **`.js`/`.ts`/`.jsx`/`.tsx`** тощо; ігнор **`.d.ts`**, **auto-imports.d.ts** тощо — **`shouldSkipFileForGqlScan`**.
+ * Обхід репозиторію — **`walkDir`** від **`process.cwd()`** (пропуски як у інших check). Кандидати — **`.vue`** та **`.js`/`.ts`/`.jsx`/`.tsx`** тощо; пропуск **`.d.ts`**, **auto-imports.d.ts** тощо — **`shouldSkipFileForGqlScan`**.
  *
  * Виявлення **`gql`** — **oxc-parser** після витягування `<script>` з SFC (**`graphql-gql-scan.mjs`**). Якщо збігів немає — перевірка завершується успішно без вимог до конфігів.
  */

package/scripts/check-js-lint.mjs

@@ -59,7 +59,7 @@ export function nitraEslintConfigDeclaresE18eTransitive(versionSpec) {
 }
 
 /**
- * Перевіряє обов’язкові поля `.oxlintrc.json` для плагіна e18e (js-lint.mdc).
+ * Перевіряє потрібні поля `.oxlintrc.json` для розширення e18e (js-lint.mdc).
  *
  * @param {unknown} cfg корінь JSON-конфігурації oxlint
  * @returns {{ ok: boolean, failures: string[] }} `ok` і перелік повідомлень для `fail`
@@ -67,7 +67,7 @@ export function nitraEslintConfigDeclaresE18eTransitive(versionSpec) {
 export function verifyOxlintRcE18e(cfg) {
   const failures = []
   if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {
-    return { ok: false, failures: ['.oxlintrc.json: корінь має бути об’єктом'] }
+    return { ok: false, failures: ['.oxlintrc.json: корінь має бути значенням типу object'] }
   }
   const o = /** @type {Record<string, unknown>} */ (cfg)
   const jsPlugins = o.jsPlugins
@@ -76,7 +76,7 @@ export function verifyOxlintRcE18e(cfg) {
   }
   const rules = o.rules
   if (!rules || typeof rules !== 'object' || Array.isArray(rules)) {
-    failures.push('.oxlintrc.json: поле rules має бути об’єктом')
+    failures.push('.oxlintrc.json: поле rules має бути значенням типу object')
   } else {
     const r = /** @type {Record<string, unknown>} */ (rules)
     if (r['e18e/prefer-includes'] !== 'error') {

package/scripts/check-text.mjs

@@ -4,7 +4,8 @@
  * oxfmt: `.oxfmtrc.json` з обовʼязковими ключами, VSCode (formatOnSave, defaultFormatter для js/ts/json/vue/css/html),
  * відсутність Prettier у конфігах і залежностях.
  *
- * cspell, markdownlint через `bunx markdownlint-cli2` у `lint-text` (без оголошення пакета в package.json), заборона
+ * cspell, markdownlint через `bunx markdownlint-cli2` у `lint-text` (без оголошення пакета в package.json); у кореневих **`devDependencies`**
+ * дозволені лише **`@nitra/*`** (як у bun.mdc), зокрема **`@nitra/cspell-dict` ^2.0.0+**; без імпорту **`@cspell/dict-*`** у `.cspell.json`, заборона
  * `markdownlint-cli2` у dependencies/devDependencies, v8r (`run-v8r.mjs` або чотири `bunx v8r`),
  * `.v8rignore` (vscode JSON),
  * workflow `lint-text.yml`, розширення VSCode (markdownlint, oxc).
@@ -15,12 +16,27 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
+import { isAllowedRootDevDependency } from './check-bun.mjs'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 import { anyRunStepIncludes, parseWorkflowYaml } from './utils/gha-workflow.mjs'
 
 /** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
 const UK_APOSTROPHE_HEADING = '**Український апостроф:**'
 
+/**
+ * Чи діапазон версії @nitra/cspell-dict у package.json означає лінію 2.0.0+ (з цієї версії словники входять у пакет).
+ * @param {string|undefined} range наприклад "^2.0.0"
+ * @returns {boolean}
+ */
+function cspellDictVersionAtLeast200(range) {
+  if (typeof range !== 'string' || !range.trim()) return false
+  const cleaned = range.trim().replace(/^workspace:\*/, '').replace(/^[\^~>=<]+\s*/, '')
+  const m = cleaned.match(/^(\d+)\.(\d+)\.(\d+)/)
+  if (!m) return false
+  const major = Number(m[1])
+  return major >= 2
+}
+
 /**
  * Перевіряє абзац про український апостроф у вмісті правила text.
  * @param {string} filePath шлях до файлу (для повідомлень)
@@ -217,11 +233,22 @@ export async function check() {
     if (pkg.prettier) fail('package.json містить поле "prettier" — видали його')
 
     const devDeps = pkg.devDependencies || {}
+    const nonNitraDev = Object.keys(devDeps).filter(n => !isAllowedRootDevDependency(n))
+    if (nonNitraDev.length > 0) {
+      fail(
+        `Кореневі devDependencies: дозволені лише @nitra/* — прибери або перенеси: ${nonNitraDev.join(', ')} (bun.mdc)`
+      )
+    } else {
+      pass('Кореневі devDependencies лише @nitra/*')
+    }
 
-    if (devDeps['@nitra/cspell-dict']) {
-      pass('@nitra/cspell-dict є в devDependencies')
+    const cspellRange = devDeps['@nitra/cspell-dict']
+    if (!cspellRange) {
+      fail('@nitra/cspell-dict у devDependencies обовʼязковий для cspell — bun add -d @nitra/cspell-dict@^2.0.0')
+    } else if (!cspellDictVersionAtLeast200(cspellRange)) {
+      fail('@nitra/cspell-dict має бути ^2.0.0 або новіший (словники зібрані в пакеті з 2.x)')
     } else {
-      fail('@nitra/cspell-dict відсутній — bun add -d @nitra/cspell-dict')
+      pass('@nitra/cspell-dict ^2.0.0+')
     }
 
     const rootDeps = pkg.dependencies || {}
@@ -276,9 +303,13 @@ export async function check() {
 
     if (existsSync('.cspell.json')) {
       const cfg = JSON.parse(await readFile('.cspell.json', 'utf8'))
-      const hasUkImport = (cfg.import || []).some(i => i.includes('@cspell/dict-uk-ua'))
-      if (hasUkImport && !devDeps['@cspell/dict-uk-ua']) {
-        fail('.cspell.json імпортує @cspell/dict-uk-ua, але пакет відсутній в devDependencies')
+      const dictImports = (cfg.import || []).filter(i => typeof i === 'string' && i.includes('@cspell/dict-'))
+      if (dictImports.length > 0) {
+        fail(
+          `.cspell.json не має імпортувати @cspell/dict-* (${dictImports.join(', ')}) — використовуй лише @nitra/cspell-dict/cspell-ext.json`
+        )
+      } else {
+        pass('.cspell.json без прямих імпортів @cspell/dict-*')
       }
     }
   }

package/skills/lint/SKILL.md

@@ -26,6 +26,7 @@ bun run lint
 2. **Якщо exit code не 0** — проаналізуй вивід (останній упавший крок у ланцюжку **`lint`** часто видно з stderr / логів):
    - Де скрипт уже робить **auto-fix** (**`--fix`**, **`markdownlint-cli2 --fix`**, **`oxfmt`** тощо) — перезапусти **`bun run lint`** після змін файлів.
    - Де auto-fix **немає** (наприклад, **jscpd**, **cspell**, **zizmor**, перевірки без прапорця fix) — виправ код, конфіги або винятки **узгоджено з** `.cursor/rules/` (не розширюй ignore лише щоб приховати проблему без причини).
+   - Якщо спрацьовує **`sonarjs/cognitive-complexity`** — див. окремий блок нижче.
 
 3. **Цикл** — повторюй кроки 1–2, доки **`bun run lint`** не завершиться успішно. Після суттєвих правок за потреби ще раз **`bun run lint`**, щоб переконатися, що не зламав наступний крок у скрипті **`lint`**.
 
@@ -37,6 +38,15 @@ bun run lint
 
 5. **Результат** — коротко опиши, що саме виправлено; якщо щось блокує нульовий exit code — залиш чітке пояснення й наступні кроки для людини.
 
+## sonarjs/cognitive-complexity
+
+- **Не** додавай **`eslint-disable`** (у т.ч. на **`sonarjs/cognitive-complexity`**) чи інші коментарі-винятки лише щоб приховати порушення — потрібен саме **рефакторинг коду**, щоб зменшити **cognitive complexity**.
+- **Перед будь-яким рефакторингом** перевір, чи є **тести**, які покривають змінювану поведінку:
+  - **unit** — **`bun test`** (або скрипт тестів у відповідному пакеті репозиторію);
+  - **e2e** — **Playwright**, якщо в проєкті він використовується для UI/потоків.
+- Якщо тестів **немає** або вони **не покривають** блок, який змінюєш — **спочатку** додай/розшир тести, переконайся, що вони стабільно проходять, **потім** роби рефакторинг, **потім** знову прогони тести й **`bun run lint`**, щоб підтвердити, що функціональність коректна й лінт чистий.
+- Якщо після рефакторингу тести або лінт падають — **не** залишай «половинчастий» рефакторинг: відкотись або доведи зміни до зеленого стану.
+
 ## Примітка
 
 Цей скіл **не** замінює **`npx @nitra/cursor check`**: **`lint`** перевіряє лінтери/формат у **`package.json`**, а **`check`** — програмні правила пакета **`@nitra/cursor`**. За потреби запускай обидва.