@nitra/cursor 1.8.30 → 1.8.40

package/README.md

@@ -85,10 +85,11 @@ CLI автоматично (команда завантаження правил
 ```
 npm/
 ├── AGENTS.template.md   # шаблон AGENTS.md для цільових репозиторіїв (потрапляє в npm-архів)
-├── mdc/                 # cursor-правила
+├── mdc/                 # cursor-правила (без префікса n-; після синку — .cursor/rules/n-<id>.mdc)
 │   ├── js-format.mdc
 │   ├── npm-module.mdc
 │   └── text.mdc
+├── skills/              # skills (каталоги <id>/; після синку — .cursor/skills/n-<id>/)
 └── bin/
     └── n-cursor.js  # CLI-скрипт
 ```

package/bin/n-cursor.js

@@ -24,8 +24,9 @@
  * `github-actions/` пакету при кожному успішному синку (workflows з правил ga / js-lint / text).
  *
  * Skills копіюються з npm/skills пакету лише для id з масиву «skills» у .n-cursor.json
- * (у JSON — без префікса, каталоги в проєкті — n-<id>, як і для правил). Якщо ключа skills
- * немає, за замовчуванням підтягуються всі bundled skills з префіксом n- у пакеті.
+ * (у JSON — без префікса, як імена файлів у mdc/ без n-). У пакеті джерело — каталоги
+ * skills/<id>/ (без префікса); у проєкті — .cursor/skills/n-<id>/ (префікс n-, як n-*.mdc).
+ * Якщо ключа skills немає, за замовчуванням підтягуються всі підкаталоги skills/ (лише імена без префікса n-).
  * Зайві каталоги n-* у .cursor/skills, яких немає у списку, видаляються.
  *
  * Якщо в корені є package.json і в ньому ще немає \@nitra/cursor у devDependencies (і не оголошено
@@ -87,7 +88,7 @@ async function discoverBundledRuleNames() {
 }
 
 /**
- * Імена skills (без префікса n-) з каталогу skills пакету — лише директорії n-*
+ * Імена skills (id без префікса n-) з каталогу skills пакету — лише підкаталоги `<id>/` без префікса n-
  * @returns {Promise<string[]>} відсортовані id
  */
 async function discoverBundledSkillNames() {
@@ -96,8 +97,8 @@ async function discoverBundledSkillNames() {
   }
   const entries = await readdir(BUNDLED_SKILLS_DIR, { withFileTypes: true })
   return entries
-    .filter(e => e.isDirectory() && e.name.startsWith(RULE_PREFIX))
-    .map(e => e.name.slice(RULE_PREFIX.length))
+    .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith(RULE_PREFIX))
+    .map(e => e.name)
     .toSorted((a, b) => a.localeCompare(b))
 }
 
@@ -233,28 +234,13 @@ function normalizeSkillId(skillName) {
   return s
 }
 
-/** Legacy id у `.n-cursor.json` → поточний bundled id (каталог `n-<id>` у пакеті) */
-const LEGACY_SKILL_ID_MAP = {
-  'fix-cursor': 'fix'
-}
-
-/**
- * Поточний id skill для шляхів у пакеті та `.cursor/skills`
- * @param {string} skillName елемент масиву skills або ім'я каталогу
- * @returns {string} canonical id без префікса n-
- */
-function canonicalSkillId(skillName) {
-  const id = normalizeSkillId(skillName)
-  return LEGACY_SKILL_ID_MAP[id] ?? id
-}
-
 /**
  * Ім'я керованого каталогу skill у .cursor/skills (префікс n-)
- * @param {string} skillId id без префікса
+ * @param {string} skillId id без префікса (або з префіксом n- у конфігу — нормалізується)
  * @returns {string} наприклад n-fix
  */
 function managedSkillDirName(skillId) {
-  return `${RULE_PREFIX}${canonicalSkillId(skillId)}`
+  return `${RULE_PREFIX}${normalizeSkillId(skillId)}`
 }
 
 /**
@@ -279,6 +265,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 +378,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\``
@@ -435,14 +431,14 @@ async function syncClaudeMd(configRules, configSkills) {
     lines.push('', '## Skills', '')
     const skillsRoot = join(cwd(), SKILLS_DIR)
     for (const skillId of configSkills) {
-      const id = canonicalSkillId(skillId)
+      const id = normalizeSkillId(skillId)
       const dirName = managedSkillDirName(skillId)
       const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
       let desc = ''
       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}\``)
@@ -485,7 +481,7 @@ async function syncAgentsMd(configSkills) {
 }
 
 /**
- * Копіює лише skills зі списку configSkills (каталоги n-* у пакеті)
+ * Копіює лише skills зі списку configSkills (джерело: skills/<id>/ у пакеті)
  * @param {string[]} configSkills id без префікса n-
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих копіювань
  */
@@ -501,13 +497,13 @@ async function syncSkills(configSkills) {
   let fail = 0
 
   for (const skillId of configSkills) {
-    const id = canonicalSkillId(skillId)
-    const dirName = managedSkillDirName(skillId)
-    const srcDir = join(BUNDLED_SKILLS_DIR, dirName)
-    const destDir = join(skillsRoot, dirName)
+    const id = normalizeSkillId(skillId)
+    const srcDir = join(BUNDLED_SKILLS_DIR, id)
+    const destDirName = managedSkillDirName(skillId)
+    const destDir = join(skillsRoot, destDirName)
 
     if (existsSync(srcDir)) {
-      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${dirName} ... `)
+      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${destDirName} ... `)
       try {
         await mkdir(destDir, { recursive: true })
         const files = await readdir(srcDir)
@@ -523,9 +519,9 @@ async function syncSkills(configSkills) {
         fail++
       }
     } else {
-      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${dirName} ... `)
+      process.stdout.write(`  ⬇  ${id} → ${SKILLS_DIR}/${destDirName} ... `)
       console.log(`❌`)
-      console.error(`     Немає каталогу в пакеті: ${dirName}`)
+      console.error(`     Немає каталогу в пакеті: skills/${id}`)
       fail++
     }
   }
@@ -550,18 +546,19 @@ async function syncCommands(configSkills) {
   let fail = 0
 
   for (const skillId of configSkills) {
-    const id = canonicalSkillId(skillId)
-    const dirName = managedSkillDirName(skillId)
-    const srcSkillMd = join(BUNDLED_SKILLS_DIR, dirName, 'SKILL.md')
+    const id = normalizeSkillId(skillId)
+    const srcSkillMd = join(BUNDLED_SKILLS_DIR, id, 'SKILL.md')
+    const destDirName = managedSkillDirName(skillId)
     const destFile = join(commandsDir, `${RULE_PREFIX}${id}.md`)
 
     process.stdout.write(`  ⬇  ${id} → ${COMMANDS_DIR}/${RULE_PREFIX}${id}.md ... `)
     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`
+        const body = `${header}Виконай інструкції зі скілу \`.cursor/skills/${destDirName}/SKILL.md\`.\n`
         await writeFile(destFile, body, 'utf8')
         console.log(`✅`)
         success++
@@ -572,7 +569,7 @@ async function syncCommands(configSkills) {
       }
     } else {
       console.log(`❌`)
-      console.error(`     Немає SKILL.md у пакеті: ${dirName}`)
+      console.error(`     Немає SKILL.md у пакеті: skills/${id}`)
       fail++
     }
   }
@@ -589,7 +586,7 @@ async function removeOrphanManagedCommandFiles(commandsDir, configSkills) {
   if (!existsSync(commandsDir)) {
     return []
   }
-  const expected = new Set(configSkills.map(s => `${RULE_PREFIX}${canonicalSkillId(s)}.md`))
+  const expected = new Set(configSkills.map(s => `${RULE_PREFIX}${normalizeSkillId(s)}.md`))
   const names = await readdir(commandsDir)
   const removed = []
   for (const name of names) {

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.5'
+version: '1.6'
 ---
 
 Проект використовує тільки Bun для керування залежностями та запуску скриптів.
@@ -63,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"
 {
@@ -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.30",
+  "version": "1.8.40",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/schemas/n-cursor.json

@@ -21,7 +21,7 @@
     },
     "skills": {
       "type": "array",
-      "description": "Ідентифікатори skills без префікса n- (каталог .cursor/skills). Якщо відсутній, CLI доповнить списком skills з пакету.",
+      "description": "Ідентифікатори skills без префікса n- (у пакеті — підкаталог skills/<id>/, у проєкті після синку — .cursor/skills/n-<id>/). Якщо відсутній, CLI доповнить списком skills з пакету.",
       "items": {
         "type": "string",
         "minLength": 1

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

@@ -12,7 +12,7 @@ import { readFile } from 'node:fs/promises'
 import { parseWorkflowYaml, verifyLintJsWorkflowStructure } from './utils/gha-workflow.mjs'
 import { pass } from './utils/pass.mjs'
 
-/** Очікуваний локальний скрипт (oxlint без bunx; eslint/jscpd через bunx). */
+/** Очікуваний локальний скрипт. */
 export const CANONICAL_LINT_JS = 'bunx oxlint --fix && bunx eslint --fix . && bunx jscpd .'
 
 /** Мінімальні рекомендації розширень редактора з js-lint.mdc (eslint, oxlint, GA). */
@@ -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 {

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/abie-kustomize/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: abie-kustomize
+description: >-
+  Трансформація дерев k8s у структуру Kustomize (base + overlays): dev → base, без окремої dev/
+version: '1.0'
+---
+
+Трансформуй директорії, щоб виділити спільне за допомогою kustomize. За основу беремо все, що в середовищі dev, і саме в такому вигляді з dev воно має стати **base**; якщо вже є base і немає dev — це нормально, рухайся далі.
+
+У інших середовищах має бути лише `kustomization.yaml` і зміни через оверрайди.
+
+У **base** у всіх ресурсів (окрім `base/kustomization.yaml`) має бути namespace **dev**.
+
+Окремої директорії **dev** не має бути — за середовище dev відповідає **base**.
+
+README має бути в директорії **k8s**.
+
+Рядки в маніфестах у **base**, які змінюватимуться в інших середовищах, позначай коментарем на тому самому рядку: `# буде замінено через kustomize`.
+
+Патчів лише на namespace не роби — namespace задається в `kustomization.yaml`.
+
+Застарілі файли прибирай.
+
+У всіх Deployment має бути `imagePullPolicy: Always`.
+
+Для overlays **ru** та **ua** `namespace` задавай у `kustomization.yaml` (без окремих patch лише на зміну namespace). Деталі — **n-k8s** / **abie** у `.cursor/rules/`, якщо ці правила увімкнені в проєкті.

package/skills/{n-fix → fix}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: n-fix
+name: fix
 description: >-
   Виправити проєкт відповідно до всіх правил в .cursor/rules/
 ---

package/skills/{n-publish-telegram → publish-telegram}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: n-publish-telegram
+name: publish-telegram
 description: >-
   Підготовка матеріалу з поточного контексту для публікації в Telegram-каналі команди
 ---