@nitra/cursor 1.8.29 → 1.8.38

package/bin/n-cursor.js

@@ -279,6 +279,16 @@ function extractSkillDescription(text) {
     .trim()
 }
 
+/**
+ * Підготовка опису skill для вставки в звичайний markdown (заголовок H1, bullet без code fence).
+ * Послідовність `<id>` сприймається markdownlint (MD033) як inline HTML — замінюємо на `{id}`.
+ * @param {string} desc один рядок з YAML frontmatter SKILL.md
+ * @returns {string} той самий рядок після заміни літералу з кутовими дужками навколо id на плейсхолдер у фігурних дужках (MD033).
+ */
+function skillDescriptionSafeForMarkdownInline(desc) {
+  return desc.replaceAll('<id>', '{id}')
+}
+
 /**
  * Розгортає в шаблоні блок Mustache {{#section}} … {{/section}} для масиву елементів
  * @param {string} template вихідний текст шаблону
@@ -382,7 +392,7 @@ async function buildSkillBulletItems(skillIds) {
       const text = await readFile(skillMdPath, 'utf8')
       const parsed = extractSkillDescription(text)
       if (parsed) {
-        desc = parsed
+        desc = skillDescriptionSafeForMarkdownInline(parsed)
       }
     }
     const pathLine = `- \`${SKILLS_DIR}/${dirName}/SKILL.md\``
@@ -442,7 +452,7 @@ async function syncClaudeMd(configRules, configSkills) {
       if (existsSync(skillMdPath)) {
         const text = await readFile(skillMdPath, 'utf8')
         const parsed = extractSkillDescription(text)
-        if (parsed) desc = parsed
+        if (parsed) desc = skillDescriptionSafeForMarkdownInline(parsed)
       }
       const ref = `- \`${SKILLS_DIR}/${dirName}/SKILL.md\``
       lines.push(desc ? `${ref} — ${desc}` : ref, `  Команда: \`/${RULE_PREFIX}${id}\``)
@@ -559,7 +569,8 @@ async function syncCommands(configSkills) {
     if (existsSync(srcSkillMd)) {
       try {
         const raw = await readFile(srcSkillMd, 'utf8')
-        const desc = extractSkillDescription(raw)
+        const descRaw = extractSkillDescription(raw)
+        const desc = descRaw ? skillDescriptionSafeForMarkdownInline(descRaw) : ''
         const header = desc ? `# ${RULE_PREFIX}${id} — ${desc}\n\n` : ''
         const body = `${header}Виконай інструкції зі скілу \`.cursor/skills/${dirName}/SKILL.md\`.\n`
         await writeFile(destFile, body, 'utf8')

package/mdc/abie.mdc

@@ -0,0 +1,56 @@
+---
+description: Правила для проєктів abinbevefes
+alwaysApply: true
+version: '1.0'
+---
+
+## k8s
+
+Якщо в проекті є k8s deployment, рядом з ним повинен бути:
+
+```yaml title="hc.yaml"
+# yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json
+apiVersion: networking.gke.io/v1
+kind: HealthCheckPolicy
+metadata:
+  name: НАЗВА_СЕРВІСУ_ДЛЯ_РОЗГОРТАННЯ
+  namespace: dev # буде замінено через kustomize
+spec:
+  default:
+    config:
+      type: HTTP
+      httpHealthCheck:
+        requestPath: /healthz
+        port: 8080
+  targetRef:
+    group: ''
+    kind: Service
+    name: НАЗВА_СЕРВІСУ_ДЛЯ_РОЗГОРТАННЯ
+```
+
+і підключення до kustomize. Але у директорії ru повинен бути файл kustomization.yaml з patch, що видаляє ресурс **HealthCheckPolicy**.
+
+```yaml title="kustomization.yaml"
+patches:
+  - target:
+      kind: HealthCheckPolicy
+    patch: |-
+      kind: HealthCheckPolicy
+      metadata:
+        name: НАЗВА_СЕРВІСУ_ДЛЯ_РОЗГОРТАННЯ
+      $patch: delete
+```
+
+## branch
+
+В lean-merged-branch.yml список гілок, які повинні бути:
+
+```yaml title=".github/workflows/clean-merged-branch.yml"
+ignore_branches: dev,ua,ru
+```
+
+## Перевірка
+
+`npx @nitra/cursor check abie`
+
+Програмна перевірка (**`check-abie.mjs`**) виконується лише якщо у **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень (щоб не вимагати **ua**/**ru** у репозиторіях без цього правила).

package/mdc/bun.mdc

@@ -1,7 +1,7 @@
 ---
 description: Bun як єдиний package manager у монорепо
 alwaysApply: true
-version: '1.4'
+version: '1.6'
 ---
 
 Проект використовує тільки Bun для керування залежностями та запуску скриптів.
@@ -32,6 +32,8 @@ version: '1.4'
   - `bun add -d <pkg>` для devDependencies
 - Для одноразових CLI-команд використовуй `bunx <tool>`.
 
+**Не додавай** у `dependencies` / `devDependencies` пакети, які **використовуються лише як CLI** і їх достатньо викликати через **`bunx <pkg>`** (або **`npx`**, якщо в проєкті так прийнято): наприклад **oxlint**, **jscpd**, **eslint** у корені тощо. Виняток — пакет потрібен як **бібліотека** (імпорт у коді), peer для іншого пакета, або інструмент **не** покривається `bunx` у вашому CI.
+
 Заборонено використовувати:
 
 - `npm`
@@ -61,29 +63,16 @@ FROM oven/bun:alpine AS build-env
 
 замість образу node
 
-В Github actions bun повинен налаштований так:
+У **GitHub Actions** не вставляй у workflow окремі кроки **`actions/setup-node`**, **`oven-sh/setup-bun`**, **`actions/cache`** та **`bun install`** — їх **заборонено** дублювати в кожному job; завжди використовуй **локальний composite** (деталі й заборона дублювання — **ga.mdc**). Під капотом composite уже містить Node **24**, Bun, кеш і **`bun install --frozen-lockfile`**.
+
+Після **`actions/checkout@v6`** (`persist-credentials: false`):
 
 ```yaml
-- uses: actions/setup-node@v6
-  with:
-    node-version: '24'
-
-- uses: oven-sh/setup-bun@v2
-
-- name: Cache Bun dependencies
-  uses: actions/cache@v5
-  with:
-    path: |
-      ~/.bun/install/cache
-      node_modules
-    key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
-    restore-keys: |
-      ${{ runner.os }}-bun-
-
-- name: Install dependencies
-  run: bun install --frozen-lockfile
+- uses: ./.github/actions/setup-bun-deps
 ```
 
+Якщо в репозиторії action збережено під **`./npm/github-actions/setup-bun-deps`**, у `uses:` вкажи цей шлях замість `.github/actions/…` (**ga.mdc**).
+
 ## Перевірка
 
 `npx @nitra/cursor check bun`

package/mdc/js-lint.mdc

@@ -1,10 +1,10 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.9'
+version: '1.11'
 ---
 
-**oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`:** `oxlint` (без `bunx`), **`bunx eslint`**, **`bunx jscpd`**; у CI — `bunx oxlint` / `bunx eslint` / `bunx jscpd`. Без **prettier** і **@nitra/prettier-config**. Достатньо **`@nitra/eslint-config`** у devDependencies; пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
+**oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. Достатньо **`@nitra/eslint-config`** у devDependencies; пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
 
 ```json title=".vscode/extensions.json"
 {
@@ -19,7 +19,7 @@ version: '1.9'
 ```json title="package.json"
 {
   "scripts": {
-    "lint-js": "oxlint --fix && bunx eslint --fix . && bunx jscpd ."
+    "lint-js": "bunx oxlint --fix && bunx eslint --fix . && bunx jscpd ."
   },
   "devDependencies": {
     "@nitra/eslint-config": "^3.4.0"
@@ -38,7 +38,7 @@ version: '1.9'
   "exitCode": 1,
   "reporters": ["console"],
   "minLines": 25,
-  "ignore": ["**/dist/**",]
+  "ignore": ["**/dist/**"]
 }
 ```
 

package/mdc/k8s.mdc

@@ -206,7 +206,7 @@ resources: {}
 - Обхід з пропуском `node_modules`, `.git`, `dist`, `coverage`, `.turbo`, `.next`.
 - **`file:`** у `$schema` — URL до apiVersion/kind не звіряється; **`https:`** — kustomization за іменем файлу → Schema Store; далі перевіряється **`EXPLICIT_K8S_SCHEMAS`** (`Map`: `apiVersion` + `kind` + `type`, для записів без `type` у маніфесті — третій компонент **`*`**); потім `v1` → yannh; група з `YANNH_GROUPS` → yannh; інакше → datree (GitHub Pages), крім рядків явної таблиці (наприклад **InfisicalSecret** — raw на `main`).
 - У кожному YAML-документі з **`kind: Deployment`** — парсинг через **`yaml`**: у кожного елемента **`spec.template.spec.containers[]`** має існувати ключ **`resources`** зі значенням-об'єктом (допускається порожній **`{}`**); у кожного контейнера — **`imagePullPolicy: Always`**.
-- У файлах, ім’я яких **не** `kustomization.yaml` / `kustomization.yml`, у кожному документі — заборона поля **`metadata.namespace`** (**namespace** задається в Kustomize).
+- У файлах, ім’я яких **не** `kustomization.yaml`.
 - Документи з **`kind: Ingress`** — заборонені (потрібен перехід на Gateway API, див. розділ **Ingress → Gateway API**).
 - Якщо в будь-якому файлі під **`k8s`** є **`kind: HealthCheckPolicy`**, серед файлів має бути **`ru/kustomization.yaml`** (сегмент шляху **`ru`** перед іменем файлу), а його вміст — patch видалення **HealthCheckPolicy** з **`$patch: delete`** (див. той самий розділ).
 - Заборона шляхів **`…/k8s/dev/…`** (окремої директорії **`dev`** під **`k8s`** не має бути).

package/mdc/text.mdc

@@ -28,9 +28,9 @@ version: '1.24'
 }
 ```
 
-**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**. Для української додай **`@cspell/dict-uk-ua`**. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bun x v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
+**`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`** не потрібний.
 
-У v8r **немає** прапорця тихого режиму; рекомендовано скрипт **`run-v8r.mjs`** з репозиторію пакета `@nitra/cursor` (`npm/scripts/run-v8r.mjs`): один виклик у `lint-text` — під капотом послідовні **`bun x 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/…`.
+У 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/…`.
 
 ```json title="package.json"
 {

package/package.json

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

package/scripts/check-abie.mjs

@@ -0,0 +1,468 @@
+/**
+ * Перевіряє відповідність проєкту правилу abie.mdc (проєкти abinbevefes).
+ *
+ * Застосовується лише якщо у **`.n-cursor.json`** у масиві **`rules`** є **`abie`** — інакше вихід **0**
+ * без перевірок (щоб не суперечити типовому **ga.mdc** з **`ignore_branches: main,dev`**).
+ *
+ * **Гілки:** у **`.github/workflows/clean-merged-branch.yml`** у кроці з
+ * **`phpdocker-io/github-actions-delete-abandoned-branches`** у **`with.ignore_branches`** мають бути
+ * **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно).
+ *
+ * **k8s:** якщо під деревом із сегментом **`k8s`** є YAML з **`kind: Deployment`**, у тій самій директорії
+ * має існувати **`hc.yaml`** із **`HealthCheckPolicy`** (**`networking.gke.io/v1`**), modeline **`$schema`**
+ * як у abie.mdc, **`/healthz`**, порт **8080**, **`targetRef`** на **Service** з тим самим **`metadata.name`**.
+ * Якщо в дереві **k8s** є **HealthCheckPolicy**, перевіряється **`ru/kustomization.yaml`** з patch **`$patch: delete`**
+ * (узгоджено з **k8s.mdc** / **check-k8s.mjs**).
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+
+import { parseAllDocuments } from 'yaml'
+
+import { isRuKustomizationPath, pathHasK8sSegment, ruKustomizationHasHealthCheckDeletePatch } from './check-k8s.mjs'
+import { pass } from './utils/pass.mjs'
+import { flattenWorkflowSteps, getStepUses, parseWorkflowYaml } from './utils/gha-workflow.mjs'
+import { walkDir } from './utils/walkDir.mjs'
+
+const CONFIG_FILE = '.n-cursor.json'
+
+/** Очікуваний URL **`$schema`** для **hc.yaml** (abie.mdc). */
+export const ABIE_HC_SCHEMA_URL = 'https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json'
+
+const MODELINE_RE = /^#\s*yaml-language-server:\s*\$schema=(\S+)\s*$/
+
+/** Гілки, які мають бути в **`ignore_branches`** за abie.mdc. */
+export const ABIE_REQUIRED_IGNORE_BRANCHES = ['dev', 'ua', 'ru']
+
+/**
+ * Чи увімкнено правило **abie** у конфігу репозиторію.
+ * @param {string} root корінь репозиторію (cwd)
+ * @returns {Promise<boolean>} true, якщо **rules** містить **abie**
+ */
+export async function isAbieRuleEnabled(root) {
+  const p = join(root, CONFIG_FILE)
+  if (!existsSync(p)) {
+    return false
+  }
+  let raw
+  try {
+    raw = await readFile(p, 'utf8')
+  } catch {
+    return false
+  }
+  let cfg
+  try {
+    cfg = JSON.parse(raw)
+  } catch {
+    return false
+  }
+  const rules = cfg?.rules
+  if (!Array.isArray(rules)) {
+    return false
+  }
+  return rules.some(r => String(r).trim().toLowerCase() === 'abie')
+}
+
+/**
+ * Розбирає **`ignore_branches`** з workflow **clean-merged-branch** (крок delete-abandoned-branches).
+ * @param {string} content вміст **.yml**
+ * @returns {string | null} рядок **ignore_branches** або **null**
+ */
+export function parseCleanMergedIgnoreBranches(content) {
+  const root = parseWorkflowYaml(content)
+  if (!root) {
+    return null
+  }
+  for (const { step } of flattenWorkflowSteps(root)) {
+    const uses = getStepUses(step)
+    if (uses.includes('phpdocker-io/github-actions-delete-abandoned-branches')) {
+      const w = step.with
+      if (w && typeof w === 'object' && !Array.isArray(w)) {
+        const ib = /** @type {Record<string, unknown>} */ (w).ignore_branches
+        if (typeof ib === 'string') {
+          return ib
+        }
+      }
+    }
+  }
+  return null
+}
+
+/**
+ * Чи рядок **ignore_branches** містить усі гілки з **required** (для abie — dev, ua, ru).
+ * @param {string} ignoreBranches значення **ignore_branches**
+ * @param {string[]} required імена гілок (нижній регістр для порівняння)
+ * @returns {boolean} true, якщо всі **required** присутні як окремі токени
+ */
+export function ignoreBranchesIncludesRequired(ignoreBranches, required) {
+  const parts = new Set(
+    ignoreBranches
+      .split(',')
+      .map(s => s.trim().toLowerCase())
+      .filter(Boolean)
+  )
+  return required.every(r => parts.has(r.toLowerCase()))
+}
+
+/**
+ * Збирає абсолютні шляхи до **.yaml** / **.yml** під деревом, де є сегмент **k8s**.
+ * @param {string} root корінь репозиторію
+ * @returns {Promise<string[]>} відсортовані шляхи
+ */
+async function findK8sYamlFiles(root) {
+  /** @type {string[]} */
+  const out = []
+  await walkDir(root, p => {
+    if (!pathHasK8sSegment(p)) {
+      return
+    }
+    if (!/\.ya?ml$/iu.test(p)) {
+      return
+    }
+    out.push(p)
+  })
+  return [...out].toSorted((a, b) => a.localeCompare(b))
+}
+
+/**
+ * Чи документ — **Deployment**.
+ * @param {unknown} obj корінь YAML-документа
+ * @returns {boolean} true, якщо **kind** документа — **Deployment**
+ */
+function isDeploymentDoc(obj) {
+  return (
+    obj !== null &&
+    typeof obj === 'object' &&
+    !Array.isArray(obj) &&
+    /** @type {Record<string, unknown>} */ (obj).kind === 'Deployment'
+  )
+}
+
+/**
+ * Директорії, де є хоча б один **Deployment** у файлах **k8s**.
+ * @param {string} root корінь cwd
+ * @param {string[]} yamlAbs абсолютні шляхи yaml під k8s
+ * @param {(msg: string) => void} fail реєстрація помилки парсингу
+ * @returns {Promise<Set<string>>} абсолютні шляхи директорій
+ */
+async function collectDeploymentDirs(root, yamlAbs, fail) {
+  /** @type {Set<string>} */
+  const dirs = new Set()
+  for (const abs of yamlAbs) {
+    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(`${relative(root, abs) || abs}: не вдалося прочитати (${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(`${relative(root, abs) || abs}: YAML (${msg})`)
+      }
+      if (parseOk) {
+        for (const doc of docs) {
+          if (doc.errors.length === 0) {
+            const obj = doc.toJSON()
+            if (isDeploymentDoc(obj)) {
+              dirs.add(dirname(abs))
+            }
+          }
+        }
+      }
+    }
+  }
+  return dirs
+}
+
+/**
+ * Прибирає BOM на початку файлу.
+ * @param {string} s вміст
+ * @returns {string} той самий рядок без BOM (U+FEFF) на початку
+ */
+function stripBom(s) {
+  return s.startsWith('\uFEFF') ? s.slice(1) : s
+}
+
+/**
+ * Перевіряє **hc.yaml** на відповідність abie.mdc.
+ * @param {string} raw повний текст файлу
+ * @param {string} relPath відносний шлях для повідомлень
+ * @returns {string | null} текст помилки або **null**
+ */
+export function validateAbieHcYaml(raw, relPath) {
+  const body = stripBom(raw)
+  const lines = body.split(/\r?\n/u)
+  if (lines.length === 0 || lines[0].trim() === '') {
+    return `${relPath}: перший рядок порожній — потрібен # yaml-language-server: $schema=… (abie.mdc)`
+  }
+  const m = lines[0].match(MODELINE_RE)
+  if (!m) {
+    return `${relPath}: перший рядок має бути modeline $schema (abie.mdc)`
+  }
+  if (m[1] !== ABIE_HC_SCHEMA_URL) {
+    return `${relPath}: $schema має бути\n     ${ABIE_HC_SCHEMA_URL}\n     (abie.mdc)`
+  }
+  const yamlBody = lines
+    .slice(1)
+    .join('\n')
+    .replace(/^\s*\n/u, '')
+  /** @type {import('yaml').Document[]} */
+  let docs
+  try {
+    docs = parseAllDocuments(yamlBody)
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error)
+    return `${relPath}: не вдалося розібрати YAML (${msg})`
+  }
+  /** @type {Record<string, unknown> | null} */
+  let policy = null
+  for (const doc of docs) {
+    if (doc.errors.length > 0) {
+      return `${relPath}: YAML: ${doc.errors.map(e => e.message).join('; ')}`
+    }
+    const obj = doc.toJSON()
+    if (obj !== null && typeof obj === 'object' && !Array.isArray(obj)) {
+      const rec = /** @type {Record<string, unknown>} */ (obj)
+      if (rec.kind === 'HealthCheckPolicy') {
+        policy = rec
+        break
+      }
+    }
+  }
+  if (!policy) {
+    return `${relPath}: очікується документ kind: HealthCheckPolicy (abie.mdc)`
+  }
+  if (policy.apiVersion !== 'networking.gke.io/v1') {
+    return `${relPath}: apiVersion має бути networking.gke.io/v1 (abie.mdc)`
+  }
+  const meta = policy.metadata
+  if (meta === null || typeof meta !== 'object' || Array.isArray(meta)) {
+    return `${relPath}: відсутній metadata (abie.mdc)`
+  }
+  const name = /** @type {Record<string, unknown>} */ (meta).name
+  if (typeof name !== 'string' || name.trim() === '') {
+    return `${relPath}: metadata.name має бути непорожнім рядком (abie.mdc)`
+  }
+  const spec = policy.spec
+  if (spec === null || typeof spec !== 'object' || Array.isArray(spec)) {
+    return `${relPath}: відсутній spec (abie.mdc)`
+  }
+  const def = /** @type {Record<string, unknown>} */ (spec).default
+  if (def === null || typeof def !== 'object' || Array.isArray(def)) {
+    return `${relPath}: відсутній spec.default (abie.mdc)`
+  }
+  const config = /** @type {Record<string, unknown>} */ (def).config
+  if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+    return `${relPath}: відсутній spec.default.config (abie.mdc)`
+  }
+  if (config.type !== 'HTTP') {
+    return `${relPath}: spec.default.config.type має бути HTTP (abie.mdc)`
+  }
+  const httpHc = /** @type {Record<string, unknown>} */ (config).httpHealthCheck
+  if (httpHc === null || typeof httpHc !== 'object' || Array.isArray(httpHc)) {
+    return `${relPath}: відсутній httpHealthCheck (abie.mdc)`
+  }
+  if (httpHc.requestPath !== '/healthz') {
+    return `${relPath}: httpHealthCheck.requestPath має бути /healthz (abie.mdc)`
+  }
+  if (httpHc.port !== 8080) {
+    return `${relPath}: httpHealthCheck.port має бути 8080 (abie.mdc)`
+  }
+  const targetRef = /** @type {Record<string, unknown>} */ (spec).targetRef
+  if (targetRef === null || typeof targetRef !== 'object' || Array.isArray(targetRef)) {
+    return `${relPath}: відсутній targetRef (abie.mdc)`
+  }
+  if (targetRef.kind !== 'Service') {
+    return `${relPath}: targetRef.kind має бути Service (abie.mdc)`
+  }
+  const svcName = targetRef.name
+  if (typeof svcName !== 'string' || svcName !== name) {
+    return `${relPath}: targetRef.name має збігатися з metadata.name (${name}) (abie.mdc)`
+  }
+  return null
+}
+
+/**
+ * Збирає відносні шляхи файлів із **HealthCheckPolicy** у дереві k8s.
+ * @param {string} root корінь
+ * @param {string[]} yamlAbs абсолютні шляхи
+ * @returns {Promise<string[]>} унікальні відносні шляхи yaml із **HealthCheckPolicy**
+ */
+async function collectHealthCheckPolicyRelPaths(root, yamlAbs) {
+  /** @type {string[]} */
+  const out = []
+  for (const abs of yamlAbs) {
+    const rel = relative(root, abs).replaceAll('\\', '/') || abs
+    let raw
+    try {
+      raw = await readFile(abs, 'utf8')
+    } catch {
+      raw = null
+    }
+    if (raw !== null) {
+      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
+      try {
+        const docs = parseAllDocuments(rest)
+        for (const doc of docs) {
+          if (doc.errors.length === 0) {
+            const obj = doc.toJSON()
+            if (obj !== null && typeof obj === 'object' && !Array.isArray(obj)) {
+              const rec = /** @type {Record<string, unknown>} */ (obj)
+              if (rec.kind === 'HealthCheckPolicy' && !out.includes(rel)) {
+                out.push(rel)
+              }
+            }
+          }
+        }
+      } catch {
+        /* пропускаємо пошкоджені файли — їх ловить check-k8s */
+      }
+    }
+  }
+  return out
+}
+
+/**
+ * Якщо є **HealthCheckPolicy**, вимагає **ru/kustomization.yaml** з patch видалення (як **check-k8s**).
+ * @param {string} root корінь
+ * @param {string[]} yamlFilesAbs абсолютні шляхи yaml k8s
+ * @param {string[]} healthCheckPolicyRelativePaths відносні шляхи
+ * @param {(msg: string) => void} fail callback
+ * @returns {Promise<void>}
+ */
+async function ensureRuKustomizationHealthCheckDelete(root, yamlFilesAbs, healthCheckPolicyRelativePaths, fail) {
+  if (healthCheckPolicyRelativePaths.length === 0) {
+    return
+  }
+  const ruAbsList = yamlFilesAbs.filter(abs => isRuKustomizationPath(relative(root, abs).replaceAll('\\', '/') || abs))
+  if (ruAbsList.length === 0) {
+    fail(
+      `Знайдено HealthCheckPolicy у ${healthCheckPolicyRelativePaths.join(', ')} — додай ru/kustomization.yaml з patch видалення (abie.mdc)`
+    )
+    return
+  }
+  for (const abs of ruAbsList) {
+    let raw
+    try {
+      raw = await readFile(abs, 'utf8')
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`${relative(root, abs) || abs}: не вдалося прочитати (${msg})`)
+      return
+    }
+    if (ruKustomizationHasHealthCheckDeletePatch(raw)) {
+      return
+    }
+  }
+  fail(
+    'Є HealthCheckPolicy, але жоден ru/kustomization.yaml не містить очікуваного patch видалення (kind: HealthCheckPolicy, metadata.name, $patch: delete) — abie.mdc'
+  )
+}
+
+/**
+ * Перевіряє відповідність проєкту правилам abie.mdc.
+ * @returns {Promise<number>} 0 — OK, 1 — є порушення
+ */
+export async function check() {
+  let exitCode = 0
+  const fail = msg => {
+    console.log(`  ❌ ${msg}`)
+    exitCode = 1
+  }
+
+  const root = process.cwd()
+  const enabled = await isAbieRuleEnabled(root)
+  if (!enabled) {
+    pass(`Правило abie не увімкнено в ${CONFIG_FILE} (rules) — перевірку пропущено`)
+    return 0
+  }
+
+  pass('Правило abie увімкнено — виконуємо перевірки')
+
+  const cleanMergedPath = join(root, '.github/workflows/clean-merged-branch.yml')
+  if (existsSync(cleanMergedPath)) {
+    /** @type {string | undefined} */
+    let wfRaw
+    try {
+      wfRaw = await readFile(cleanMergedPath, 'utf8')
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`Не вдалося прочитати clean-merged-branch.yml (${msg})`)
+    }
+    if (wfRaw !== undefined) {
+      const ib = parseCleanMergedIgnoreBranches(wfRaw)
+      if (ib === null || ib.trim() === '') {
+        fail(
+          'clean-merged-branch.yml: не знайдено with.ignore_branches у кроці phpdocker-io/github-actions-delete-abandoned-branches (abie.mdc)'
+        )
+      } else if (ignoreBranchesIncludesRequired(ib, ABIE_REQUIRED_IGNORE_BRANCHES)) {
+        pass('clean-merged-branch.yml: ignore_branches містить dev, ua, ru')
+      } else {
+        fail(
+          `clean-merged-branch.yml: ignore_branches має містити dev, ua та ru (зараз: ${JSON.stringify(ib)}) — abie.mdc`
+        )
+      }
+    }
+  } else {
+    fail(`Відсутній ${cleanMergedPath} — потрібен для ignore_branches (abie.mdc)`)
+  }
+
+  const yamlFiles = await findK8sYamlFiles(root)
+  const deploymentDirs = await collectDeploymentDirs(root, yamlFiles, fail)
+
+  if (deploymentDirs.size > 0) {
+    pass(`Знайдено Deployment у ${deploymentDirs.size} директорія(ї/й) k8s — перевіряємо hc.yaml`)
+    for (const dir of [...deploymentDirs].toSorted((a, b) => a.localeCompare(b))) {
+      const hcAbs = join(dir, 'hc.yaml')
+      const relHc = relative(root, hcAbs).replaceAll('\\', '/') || 'hc.yaml'
+      if (existsSync(hcAbs)) {
+        let hcRaw
+        let hcReadOk = false
+        try {
+          hcRaw = await readFile(hcAbs, 'utf8')
+          hcReadOk = true
+        } catch (error) {
+          const msg = error instanceof Error ? error.message : String(error)
+          fail(`${relHc}: не вдалося прочитати (${msg})`)
+        }
+        if (hcReadOk) {
+          const v = validateAbieHcYaml(hcRaw, relHc)
+          if (v === null) {
+            pass(`${relHc}: відповідає abie.mdc`)
+          } else {
+            fail(v)
+          }
+        }
+      } else {
+        fail(
+          `${relative(root, dir) || dir}: є Deployment, але немає hc.yaml поруч — додай HealthCheckPolicy (abie.mdc)`
+        )
+      }
+    }
+  } else {
+    pass('Немає Deployment у дереві k8s — перевірку hc.yaml пропущено')
+  }
+
+  const healthCheckPolicyRelativePaths = await collectHealthCheckPolicyRelPaths(root, yamlFiles)
+  await ensureRuKustomizationHealthCheckDelete(root, yamlFiles, healthCheckPolicyRelativePaths, fail)
+
+  return exitCode
+}

package/scripts/check-js-lint.mjs

@@ -9,11 +9,11 @@
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 
-import { pass } from './utils/pass.mjs'
 import { parseWorkflowYaml, verifyLintJsWorkflowStructure } from './utils/gha-workflow.mjs'
+import { pass } from './utils/pass.mjs'
 
-/** Очікуваний локальний скрипт (oxlint без bunx; eslint/jscpd через bunx). */
-export const CANONICAL_LINT_JS = 'oxlint --fix && bunx eslint --fix . && bunx jscpd .'
+/** Очікуваний локальний скрипт. */
+export const CANONICAL_LINT_JS = 'bunx oxlint --fix && bunx eslint --fix . && bunx jscpd .'
 
 /** Мінімальні рекомендації розширень редактора з js-lint.mdc (eslint, oxlint, GA). */
 export const REQUIRED_VSCODE_EXTENSIONS = ['dbaeumer.vscode-eslint', 'github.vscode-github-actions', 'oxc.oxc-vscode']
@@ -28,14 +28,12 @@ export function normalizeLintJsScript(s) {
 }
 
 /**
- * Чи рядок `lint-js` збігається з каноном і без `bunx oxlint`.
+ * Чи рядок `lint-js` збігається з каноном (`bunx oxlint`, `bunx eslint`, `bunx jscpd`).
  * @param {string} script значення `scripts.lint-js` з package.json
  * @returns {boolean} true, якщо рядок канонічний
  */
 export function isCanonicalLintJs(script) {
-  const n = normalizeLintJsScript(script)
-  if (n.includes('bunx oxlint')) return false
-  return n === CANONICAL_LINT_JS
+  return normalizeLintJsScript(script) === CANONICAL_LINT_JS
 }
 
 /**
@@ -89,7 +87,7 @@ export async function check() {
         pass(`lint-js збігається з каноном: ${CANONICAL_LINT_JS}`)
       } else {
         fail(
-          `lint-js має бути рівно: "${CANONICAL_LINT_JS}" (oxlint без bunx; див. js-lint.mdc / check-js-lint.mjs). Зараз: ${JSON.stringify(normalizeLintJsScript(lintJs))}`
+          `lint-js має бути рівно: "${CANONICAL_LINT_JS}" (див. js-lint.mdc / check-js-lint.mjs). Зараз: ${JSON.stringify(normalizeLintJsScript(lintJs))}`
         )
       }
     } else {
@@ -182,7 +180,7 @@ export async function check() {
         }
       }
       if (content.includes('bunx oxlint') && /bunx\s+oxlint[^\n]*--fix/u.test(content)) {
-        fail('lint-js.yml: у CI не використовуй oxlint --fix (лише bunx oxlint)')
+        fail('lint-js.yml: у CI не використовуй bunx oxlint --fix (лише bunx oxlint)')
       }
       if (content.includes('eslint --fix')) {
         fail('lint-js.yml: у CI не використовуй eslint --fix (лише bunx eslint .)')

package/scripts/run-v8r.mjs

@@ -2,7 +2,7 @@
  * Тихий запуск v8r для усіх типів файлів, які підтримує v8r (json, json5, yaml, yml, toml).
  *
  * Один виклик цього скрипта з `lint-text` замість чотирьох окремих викликів v8r: під капотом для
- * кожного glob окремий `bun x v8r`, бо v8r у одному процесі падає з кодом 98, якщо хоч один із
+ * кожного glob окремий `bunx v8r`, бо v8r у одному процесі падає з кодом 98, якщо хоч один із
  * переданих глобів не знаходить файлів — тоді решта розширень не перевіряються.
  *
  * Каталог схем `@nitra/cursor` (`v8r-catalog.json` у каталозі `schemas` пакета) передається в v8r

package/skills/n-mdc-check/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: n-mdc-check
+description: >-
+  Проаналізувати правило в npm/mdc і перенести максимум перевірюваної логіки в check-{id}.mjs;
+  залишити в .mdc лише те, що не автоматизується або служить контекстом для агента
+---
+
+# n-mdc-check — від правила до скрипта
+
+Навичка для роботи з правилами пакета `@nitra/cursor`: **перевірювані критерії** мають жити в **`npm/scripts/check-<id>.mjs`**, а **`npm/mdc/<id>.mdc`** (і дзеркало **`.cursor/rules/n-<id>.mdc`**) — бути **коротким орієнтиром**: навіщо правило, як виправляти порушення, яка команда підтверджує відповідність.
+
+Канонічні вимоги до скриптів, тестів і AST — **`.cursor/rules/scripts.mdc`**.
+
+## Коли застосовувати
+
+- Додали або змінили вимоги в **`npm/mdc/<id>.mdc`** (або локальному **`n-<id>.mdc`**).
+- У правилі багато «має містити», «заборонено», точних фрагментів файлів — і агенти повторюють перевірку вручну.
+- Потрібно зменшити обсяг `.mdc` і уникнути роз’їзду тексту й фактичної перевірки.
+
+## Ідентифікатор правила
+
+- Файл правила в пакеті: **`npm/mdc/<id>.mdc`** → скрипт: **`npm/scripts/check-<id>.mjs`**, команда CLI: **`npx @nitra/cursor check <id>`**.
+- CLI підхоплює всі **`check-*.mjs`** з каталогу `scripts` пакета; окремої реєстрації не потрібно.
+- Якщо правило згадане в **`AGENTS.md`**, для нього доречна programmatic перевірка — має існувати відповідний **`check-<id>.mjs`** (коли вимоги формалізовані).
+
+## Workflow
+
+### 1. Базова лінія
+
+```bash
+npx @nitra/cursor check <id>
+```
+
+Зафіксуй поточний вивід (якщо скрипт уже є).
+
+### 2. Розбір тексту правила
+
+Прочитай **`npm/mdc/<id>.mdc`** повністю. Для кожної вимоги виріши:
+
+| Тип                                                                                | Куди                                                                                     |
+| ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| Перевірювана структура (файли, поля JSON/YAML, наявність ключів, заборонені шляхи) | **`check-<id>.mjs`**                                                                     |
+| Семантика JS/TS у файлах                                                           | **`check-<id>.mjs`** через **Oxc AST** (`oxc-parser`), не «сліпі» regex по всьому файлу  |
+| Вміст у Vue SFC / MDX / Astro                                                      | Спочатку **виділи** валідний JS/TS-фрагмент, потім AST; regex — лише для ізоляції блоків |
+| Не-JS конфіги, сирі workflow                                                       | Текстовий/структурний парсинг або обґрунтований regex; у JSDoc коротко **чому** не AST   |
+| Смак, архітектура, «навіщо так», поради без однозначного критерію                  | Залиш у **`.mdc`**                                                                       |
+
+### 3. Скрипт
+
+- **Новий** `check-<id>.mjs`: орієнтуйся на наявні файли в **`npm/scripts/`** (наприклад **`check-bun.mjs`**) — стиль **`fail` / `pass`**, **`export async function check()`**, exit code **0 / 1**.
+- **На початку файлу** (перед `import`) — **багаторядковий** верхній JSDoc **українською**: що перевіряє файл; між смисловими блоками — рядок `*`; перші рядки без службових префіксів — одразу зрозуміло призначення.
+- **JSDoc** до експортованих функцій і нетривіальних внутрішніх функцій.
+- Повідомлення **`fail`**: конкретно, що не так і як виправити (як у інших check-скриптах).
+- Залежність **`oxc-parser`** не додавай у корінь споживача — вона в **`dependencies`** пакета **`@nitra/cursor`** (див. **dev-dep** / **scripts.mdc**).
+
+### 4. Тести
+
+Якщо логіка нетривіальна або її легко зламати — додай **`npm/tests/check-<id>.test.mjs`** (або розшир наявні тести). Після змін:
+
+```bash
+cd npm && bun test
+```
+
+### 5. Спрощення `.mdc`
+
+- Прибери з правила **дубль** детальних умов, які тепер у скрипті; залиш **короткий зміст**, мотивацію, посилання на файли/конвенції.
+- Потрібно зберегти (або додати) секцію **«Перевірка»** з **`npx @nitra/cursor check <id>`** (або повним ім’ям правила з `AGENTS.md`).
+- Якщо оновлюєш пакетне правило, **синхронно** онови дзеркало **`.cursor/rules/n-<id>.mdc`**, щоб текст не розходився (як прийнято в цьому репозиторії).
+
+### 6. Верифікація та версія пакета
+
+```bash
+npx @nitra/cursor check <id>
+```
+
+Після змін у **`npm/`** (у тому числі `skills/`, `scripts/`, `mdc/`) підвищ **patch**-версію в **`npm/package.json`** на **один** крок відносно вже запланованого релізу (див. **n-npm-module**).
+
+## Антипатерни
+
+- Залишати в `.mdc` великі «еталонні» YAML/JSON, якщо перевірка може читати очікувану структуру з репозиторію або константи в скрипті.
+- Оновлювати лише текст правила без оновлення **`check-<id>.mjs`**, коли для правила вже є скрипт або з’явилась нова перевірювана умова.
+- Дублювати однакову логіку в кількох check-скриптах замість спільної утиліти в **`npm/scripts/utils/`**.
+
+## Команда в чаті
+
+`/n-mdc-check` — застосуй цей workflow до правила з поточного контексту або до `<id>`, який вкаже користувач.