@nitra/cursor 1.8.111 → 1.8.113

package/bin/n-cursor.js

@@ -752,6 +752,76 @@ async function removeOrphanManagedCommandFiles(commandsDir, configSkills) {
   return removed.toSorted((a, b) => a.localeCompare(b))
 }
 
+/**
+ * Синхронізує .claude/commands/{dirName}.md для всіх локальних скілів з .cursor/skills/
+ * що не керуються пакетом (відсутні в configSkills).
+ * @param {string[]} configSkills id керованих skills (вже оброблені syncCommands)
+ * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
+ */
+async function syncLocalOnlySkillCommands(configSkills) {
+  const skillsRoot = join(cwd(), SKILLS_DIR)
+  if (!existsSync(skillsRoot)) return { success: 0, fail: 0 }
+
+  const commandsDir = join(cwd(), COMMANDS_DIR)
+  await mkdir(commandsDir, { recursive: true })
+
+  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
+  const allDirNames = await listProjectSkillDirNames()
+  const localOnly = allDirNames.filter(d => !managedDirNames.has(d))
+
+  let success = 0
+  let fail = 0
+
+  for (const dirName of localOnly) {
+    const skillMdPath = join(skillsRoot, dirName, 'SKILL.md')
+    const destFile = join(commandsDir, `${dirName}.md`)
+
+    process.stdout.write(`  ⬇  ${dirName} → ${COMMANDS_DIR}/${dirName}.md ... `)
+    try {
+      let desc = ''
+      if (existsSync(skillMdPath)) {
+        const raw = await readFile(skillMdPath, 'utf8')
+        const parsed = extractSkillDescription(raw)
+        if (parsed) desc = skillDescriptionSafeForMarkdownInline(parsed)
+      }
+      const header = desc ? `# ${dirName} — ${desc}\n\n` : ''
+      const body = `${header}Виконай інструкції зі скілу \`${SKILLS_DIR}/${dirName}/SKILL.md\`.\n`
+      await writeFile(destFile, body, 'utf8')
+      console.log(`✅`)
+      success++
+    } catch (error) {
+      console.log(`❌`)
+      console.error(`     Помилка: ${errorMessage(error)}`)
+      fail++
+    }
+  }
+  return { success, fail }
+}
+
+/**
+ * Видаляє .claude/commands/{dirName}.md файли локальних скілів, яких більше немає в .cursor/skills/
+ * @param {string} commandsDir абсолютний шлях до .claude/commands
+ * @param {string[]} configSkills id керованих skills
+ * @returns {Promise<string[]>} імена видалених файлів
+ */
+async function removeOrphanLocalSkillCommandFiles(commandsDir, configSkills) {
+  if (!existsSync(commandsDir)) return []
+
+  const managedDirNames = new Set(configSkills.map(s => managedSkillDirName(s)))
+  const allDirNames = new Set(await listProjectSkillDirNames())
+  const names = await readdir(commandsDir)
+  const removed = []
+
+  for (const name of names.filter(n => n.endsWith('.md') && !n.startsWith(RULE_PREFIX))) {
+    const dirName = name.slice(0, -3)
+    if (!managedDirNames.has(dirName) && !allDirNames.has(dirName)) {
+      await unlink(join(commandsDir, name))
+      removed.push(name)
+    }
+  }
+  return removed.toSorted((a, b) => a.localeCompare(b))
+}
+
 /**
  * Людинозрозумілий текст винятку для логів.
  * @param {unknown} error виняток із catch
@@ -1031,13 +1101,19 @@ async function runSync() {
 
   await runSyncStep('❌ Commands: ', async () => {
     const { success: cmdOk, fail: cmdFail } = await syncCommands(skills, bundledSkillsDir)
-    if (skills.length > 0) {
-      console.log(`\n⌨️  Commands: ${cmdOk} скопійовано, ${cmdFail} з помилками`)
+    const { success: localOk, fail: localFail } = await syncLocalOnlySkillCommands(skills)
+    const totalOk = cmdOk + localOk
+    const totalFail = cmdFail + localFail
+    if (totalOk + totalFail > 0) {
+      console.log(`\n⌨️  Commands: ${totalOk} скопійовано, ${totalFail} з помилками`)
     }
-    const removedCmds = await removeOrphanManagedCommandFiles(join(cwd(), COMMANDS_DIR), skills)
+    const commandsDir = join(cwd(), COMMANDS_DIR)
+    const removedCmds = await removeOrphanManagedCommandFiles(commandsDir, skills)
     logRemovedManagedItems('commands', COMMANDS_DIR, removedCmds)
-    if (cmdFail > 0) {
-      throw new Error(`Не вдалося скопіювати ${cmdFail} з ${skills.length} commands`)
+    const removedLocalCmds = await removeOrphanLocalSkillCommandFiles(commandsDir, skills)
+    logRemovedManagedItems('commands (local)', COMMANDS_DIR, removedLocalCmds)
+    if (totalFail > 0) {
+      throw new Error(`Не вдалося скопіювати ${totalFail} commands`)
     }
   })
 

package/mdc/abie.mdc

@@ -116,7 +116,7 @@ spec:
 ## k8s: overlay **ru** і nginx-sidecar для WebSocket (Hasura)
 
 YC ALB (gwin) має баг: якщо HTTPRoute-правило містить одночасно `URLRewrite` (ReplacePrefixMatch) і `upgrade_types: websocket` — ALB не обробляє WebSocket і повертає 404.
-https://center.yandex.cloud/support/tickets/TX549394
+<https://center.yandex.cloud/support/tickets/TX549394>
 
 Обхідний варіант: nginx-sidecar у поді, що сам виконує rewrite і проксіює WebSocket до Hasura.
 

package/mdc/ga.mdc

@@ -4,7 +4,7 @@ alwaysApply: true
 version: '1.3'
 ---
 
-У `.github/workflows/` лише **`.yml`**. Мають бути **`clean-ga-workflows.yml`**, **`clean-merged-branch.yml`**, **`lint-ga.yml`**. Якщо є **`apply-k8s.yml`** / **`apply-nats-consumer.yml`** — paths у тригері як у фрагментах.
+У `.github/workflows/` лише **`.yml`**. Мають бути **`clean-ga-workflows.yml`**, **`clean-merged-branch.yml`**, **`lint-ga.yml`**, **`git-ai.yml`**. Якщо є **`apply-k8s.yml`** / **`apply-nats-consumer.yml`** — paths у тригері як у фрагментах.
 
 Повинен бути файл .github/workflows/clean-ga-workflows.yml, зі змістом:
 
@@ -110,6 +110,37 @@ jobs:
         run: bun run lint-ga
 ```
 
+Повинен бути файл .github/workflows/git-ai.yml, зі змістом:
+
+```yaml
+name: Git AI
+
+on:
+  pull_request:
+    types: [closed]
+
+jobs:
+  git-ai:
+    if: github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Install git-ai
+        run: |
+          curl -fsSL https://usegitai.com/install.sh | bash
+          echo "$HOME/.git-ai/bin" >> $GITHUB_PATH
+      - name: Run git-ai
+        id: run-git-ai
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git-ai ci github run
+```
+
 **Локальний composite** (`uses: ./.github/actions/setup-bun-deps` або `./npm/github-actions/setup-bun-deps`): **спочатку** обов’язковий крок **`actions/checkout@v6`** (`persist-credentials: false`), інакше runner не знайде `action.yml`. Сам composite: **`actions/setup-node@v6`** (**Node 24**), **Bun**, **`actions/cache@v5`**, **`bun install --frozen-lockfile`**.
 
 ```json title=".vscode/extensions.json"

package/mdc/js-pino.mdc

@@ -10,8 +10,6 @@ version: '1.1'
 В **/k8s/base/configmap.yaml повинен бути заданий OTEL_RESOURCE_ATTRIBUTES: 'service.name=<project_name>,service.namespace=<project_namespace>'
 а в директоріях з kustomize повинні бути перевизначені значення OTEL_RESOURCE_ATTRIBUTES і в них service.namespace повинен відповідати namespace, в якому знаходиться дана директорія.
 
-Configmap повинен бути з тією самою назвою, що і deployment, якщо у deployment тільки один configmap.
-
 ## Перевірка
 
 `npx @nitra/cursor check js-pino`

package/mdc/k8s.mdc

@@ -210,6 +210,10 @@ spec:
 
 **Точні умови та повідомлення `fail`** — верхній JSDoc **`npm/scripts/check-k8s.mjs`**.
 
+## ConfigMap: ім'я збігається з Deployment
+
+Якщо в `k8s/base/` є **`configmap.yaml`** і **Deployment**, і цей Deployment посилається рівно на **один** ConfigMap — `metadata.name` ConfigMap має збігатися з `metadata.name` Deployment. Точні умови перевірки — **`check-k8s.mjs`**.
+
 ## Kustomize: структура каталогів (`base` / overlays)
 
 Трансформуй дерева **`**/k8s`**, щоб **винести спільне** через [Kustomize](https://kustomize.io/): один канонічний **`base`** і тонкі **overlays** для інших середовищ.

package/mdc/nginx-default-tpl.mdc

@@ -3,6 +3,7 @@ description: Правила nginx для статичних файлів
 version: '1.2'
 ---
 
+> **Автоміграція:** `npx @nitra/cursor check nginx-default-tpl` автоматично перейменовує `default.tpl.conf` → `default.conf.template` (або перезаписує вміст, якщо обидва файли існують). Якщо шаблон відсутній — перевірка пропускається.
 
 default.conf.template повинен виглядати так:
 

package/package.json

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

package/scripts/check-abie.mjs

@@ -89,6 +89,23 @@ const REMOVE_CLUSTER_IP_BEFORE_OP_RE = /path:\s*\/spec\/clusterIP\b[\s\S]{0,200}
 const REMOVE_CLUSTER_IPS_AFTER_OP_RE = /op:\s*remove\b[\s\S]{0,200}?path:\s*\/spec\/clusterIPs\b/mu
 const REMOVE_CLUSTER_IPS_BEFORE_OP_RE = /path:\s*\/spec\/clusterIPs\b[\s\S]{0,200}?op:\s*remove\b/mu
 
+/** Підрядок образу Hasura у контейнері Deployment (abie.mdc nginx-sidecar). */
+const HASURA_IMAGE_MARKER = 'hasura/graphql-engine'
+/** Nginx-sidecar image (abie.mdc): nginx:*-alpine. */
+const NGINX_SIDECAR_IMAGE_RE = /image:\s*nginx:\S*-alpine/u
+/** containerPort: 8081 у patch Deployment (abie.mdc). */
+const NGINX_SIDECAR_CONTAINER_PORT_RE = /containerPort:\s*8081\b/u
+/** port: 8081 у patch Service -hl (proxy порт, abie.mdc). */
+const PATCH_PROXY_PORT_8081_RE = /\bport:\s*8081\b/u
+/** configmap-nginx.yaml у resources kustomization (abie.mdc). */
+const RESOURCES_CONFIGMAP_NGINX_RE = /configmap-nginx\.yaml/u
+/** path /spec/rules/{i}/backendRefs/{j}/port … value: 8081 у patch HTTPRoute (path→value, abie.mdc). */
+const HTTPROUTE_BACKENDREF_PORT_8081_RE =
+  /path:\s*\/spec\/rules\/\d+\/backendRefs\/\d+\/port\b[\s\S]{0,200}?value:\s*8081\b/mu
+/** Те саме, value→path. */
+const HTTPROUTE_BACKENDREF_PORT_8081_VALUE_FIRST_RE =
+  /value:\s*8081\b[\s\S]{0,200}?path:\s*\/spec\/rules\/\d+\/backendRefs\/\d+\/port\b/mu
+
 /** Гілки, які мають бути в **`ignore_branches`** за abie.mdc. */
 export const ABIE_REQUIRED_IGNORE_BRANCHES = ['dev', 'ua', 'ru']
 
@@ -1627,6 +1644,203 @@ async function checkHcYamlFiles(root, deploymentDirs, pass, fail) {
   }
 }
 
+/**
+ * Чи Deployment-документ містить контейнер із образом **`hasura/graphql-engine`** (abie.mdc nginx-sidecar).
+ * @param {unknown} obj корінь YAML-документа
+ * @returns {boolean}
+ */
+function deploymentDocHasHasuraImage(obj) {
+  if (!isDeploymentDoc(obj)) return false
+  const rec = /** @type {Record<string, unknown>} */ (obj)
+  const spec = rec.spec
+  if (spec === null || typeof spec !== 'object' || Array.isArray(spec)) return false
+  const template = /** @type {Record<string, unknown>} */ (spec).template
+  if (template === null || typeof template !== 'object' || Array.isArray(template)) return false
+  const podSpec = /** @type {Record<string, unknown>} */ (template).spec
+  if (podSpec === null || typeof podSpec !== 'object' || Array.isArray(podSpec)) return false
+  const containers = /** @type {Record<string, unknown>} */ (podSpec).containers
+  if (!Array.isArray(containers)) return false
+  for (const c of containers) {
+    if (c !== null && typeof c === 'object' && !Array.isArray(c)) {
+      const img = /** @type {Record<string, unknown>} */ (c).image
+      if (typeof img === 'string' && img.includes(HASURA_IMAGE_MARKER)) return true
+    }
+  }
+  return false
+}
+
+/**
+ * Чи Kustomization-документ містить у **`images[*].newName`** рядок **`hasura/graphql-engine`** (abie.mdc nginx-sidecar).
+ * @param {unknown} obj корінь YAML-документа
+ * @returns {boolean}
+ */
+function kustomizationDocHasHasuraImageNewName(obj) {
+  if (obj === null || typeof obj !== 'object' || Array.isArray(obj)) return false
+  const rec = /** @type {Record<string, unknown>} */ (obj)
+  if (!Array.isArray(rec.images)) return false
+  for (const img of rec.images) {
+    if (img !== null && typeof img === 'object' && !Array.isArray(img)) {
+      const newName = /** @type {Record<string, unknown>} */ (img).newName
+      if (typeof newName === 'string' && newName.includes(HASURA_IMAGE_MARKER)) return true
+    }
+  }
+  return false
+}
+
+/**
+ * Збирає тексти inline **patch** для **Deployment** з **kustomization.yaml** (усі документи).
+ * @param {string} raw повний текст файлу
+ * @returns {string[]} рядки patch
+ */
+function collectDeploymentPatchTextsFromKustomization(raw) {
+  const body = stripBom(raw)
+  const lines = body.split(LINE_SPLIT_RE)
+  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 []
+  }
+  /** @type {string[]} */
+  const out = []
+  for (const doc of docs) {
+    if (doc.errors.length > 0) continue
+    const root = doc.toJSON()
+    if (root === null || typeof root !== 'object' || Array.isArray(root)) continue
+    const rec = /** @type {Record<string, unknown>} */ (root)
+    if (!Array.isArray(rec.patches)) continue
+    for (const p of rec.patches) {
+      if (p === null || typeof p !== 'object' || Array.isArray(p)) continue
+      const pr = /** @type {Record<string, unknown>} */ (p)
+      const target = pr.target
+      if (target === null || typeof target !== 'object' || Array.isArray(target)) continue
+      const tg = /** @type {Record<string, unknown>} */ (target)
+      if (tg.kind !== 'Deployment') continue
+      const patchStr = pr.patch
+      if (typeof patchStr === 'string' && patchStr.trim() !== '') out.push(patchStr)
+    }
+  }
+  return out
+}
+
+/**
+ * Каталоги пакетів, де в дереві **k8s** є **Deployment** з образом **`hasura/graphql-engine`** або
+ * **Kustomization** з **`images[*].newName`** на нього (abie.mdc nginx-sidecar).
+ * @param {string} root корінь репозиторію
+ * @param {string[]} yamlAbs абсолютні шляхи yaml під k8s
+ * @returns {Promise<Set<string>>} абсолютні шляхи каталогів пакетів
+ */
+async function collectHasuraK8sPackageDirs(root, yamlAbs) {
+  /** @type {Set<string>} */
+  const dirs = new Set()
+  for (const abs of yamlAbs) {
+    const rel = relative(root, abs).replaceAll('\\', '/') || abs
+    const docs = await readAndParseYamlDocs(abs, rel, silentFail)
+    if (!docs) continue
+    for (const doc of docs) {
+      if (doc.errors.length > 0) continue
+      const obj = doc.toJSON()
+      if (deploymentDocHasHasuraImage(obj) || kustomizationDocHasHasuraImageNewName(obj)) {
+        const pkgDir = abiePackageDirFromK8sYamlRel(root, rel)
+        if (pkgDir) dirs.add(pkgDir)
+      }
+    }
+  }
+  return dirs
+}
+
+/**
+ * Якщо в дереві **k8s** є Deployment з **`hasura/graphql-engine`** і **`ru/kustomization.yaml`** містить
+ * **`HASURA_GRAPHQL_JWT_SECRET`** — вимагає **nginx-sidecar** (abie.mdc):
+ * **`ru/configmap-nginx.yaml`**, **`resources`** у kustomization, patch **Service -hl** (port 8081),
+ * patch **Deployment** (nginx-sidecar image + containerPort 8081), patch **HTTPRoute** (port 8081).
+ * @param {string} root корінь репозиторію
+ * @param {string[]} yamlFilesAbs yaml під k8s
+ * @param {(msg: string) => void} fail callback при помилці
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @returns {Promise<void>}
+ */
+async function ensureAbieNginxSidecarForHasura(root, yamlFilesAbs, fail, passFn) {
+  const hasuraPkgDirs = await collectHasuraK8sPackageDirs(root, yamlFilesAbs)
+  if (hasuraPkgDirs.size === 0) {
+    passFn('Немає Deployment із hasura/graphql-engine у дереві k8s — nginx-sidecar не вимагається (abie.mdc)')
+    return
+  }
+  for (const pkgAbs of [...hasuraPkgDirs].toSorted((a, b) => a.localeCompare(b))) {
+    const relPkg = relative(root, pkgAbs).replaceAll('\\', '/') || pkgAbs
+    const ruAbs = join(pkgAbs, 'k8s', 'ru', 'kustomization.yaml')
+    if (!existsSync(ruAbs)) {
+      passFn(`${relPkg}/k8s: є Hasura Deployment, але немає ru/kustomization.yaml — nginx-sidecar не перевіряється`)
+      continue
+    }
+    let ruRaw
+    try {
+      ruRaw = await readFile(ruAbs, 'utf8')
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`${relPkg}/k8s/ru/kustomization.yaml: не вдалося прочитати (${msg})`)
+      return
+    }
+    if (!ruRaw.includes(HASURA_JWT_SECRET_IN_KUSTOMIZATION)) {
+      passFn(
+        `${relPkg}/k8s/ru/kustomization.yaml: немає ${HASURA_JWT_SECRET_IN_KUSTOMIZATION} — nginx-sidecar не вимагається (abie.mdc)`
+      )
+      continue
+    }
+    const relRu = relative(root, ruAbs).replaceAll('\\', '/') || ruAbs
+    // configmap-nginx.yaml must exist
+    const configmapNginxAbs = join(pkgAbs, 'k8s', 'ru', 'configmap-nginx.yaml')
+    if (!existsSync(configmapNginxAbs)) {
+      fail(`${relPkg}/k8s/ru: потрібен configmap-nginx.yaml з nginx.conf (nginx-sidecar для Hasura WebSocket, abie.mdc)`)
+      return
+    }
+    passFn(`${relPkg}/k8s/ru/configmap-nginx.yaml: існує`)
+    // kustomization resources must include configmap-nginx.yaml
+    if (!RESOURCES_CONFIGMAP_NGINX_RE.test(ruRaw)) {
+      fail(`${relRu}: у resources потрібен configmap-nginx.yaml (nginx-sidecar, abie.mdc)`)
+      return
+    }
+    passFn(`${relRu}: resources містить configmap-nginx.yaml`)
+    // Service -hl patch must include port: 8081 (proxy)
+    const svcPatchByName = collectAbieRuServicePatchTextByTargetNameFromRaw(ruRaw)
+    const hasHlWith8081 = [...svcPatchByName.entries()].some(
+      ([name, pt]) => name.endsWith('-hl') && PATCH_PROXY_PORT_8081_RE.test(pt)
+    )
+    if (!hasHlWith8081) {
+      fail(`${relRu}: у patch Service -hl потрібен port: 8081 (proxy) для nginx-sidecar (abie.mdc)`)
+      return
+    }
+    passFn(`${relRu}: Service -hl patch містить port 8081 (nginx-sidecar)`)
+    // Deployment patch must include nginx-sidecar (image nginx:*-alpine + containerPort: 8081)
+    const deployPatches = collectDeploymentPatchTextsFromKustomization(ruRaw)
+    const hasNginxSidecar = deployPatches.some(
+      pt => NGINX_SIDECAR_IMAGE_RE.test(pt) && NGINX_SIDECAR_CONTAINER_PORT_RE.test(pt)
+    )
+    if (!hasNginxSidecar) {
+      fail(
+        `${relRu}: у patch Deployment потрібен nginx-sidecar (image nginx:…-alpine, containerPort: 8081) — abie.mdc`
+      )
+      return
+    }
+    passFn(`${relRu}: Deployment patch містить nginx-sidecar (image + containerPort 8081)`)
+    // HTTPRoute patch must replace a backendRef port to 8081
+    const combined = getCombinedNginxRunPatchTextFromKustomization(ruRaw)
+    if (
+      !HTTPROUTE_BACKENDREF_PORT_8081_RE.test(combined) &&
+      !HTTPROUTE_BACKENDREF_PORT_8081_VALUE_FIRST_RE.test(combined)
+    ) {
+      fail(
+        `${relRu}: у patch HTTPRoute потрібен JSON6902 з path /spec/rules/…/backendRefs/…/port та value: 8081 (nginx-sidecar, abie.mdc)`
+      )
+      return
+    }
+    passFn(`${relRu}: HTTPRoute patch замінює порт на 8081 (nginx-sidecar)`)
+  }
+}
+
 /**
  * Перевіряє відповідність проєкту правилам abie.mdc.
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
@@ -1671,5 +1885,8 @@ export async function check() {
     await ensureUaRuAbieHttpRoutePatches(root, yamlFiles, fail, pass)
   }
 
+  pass('Перевіряємо nginx-sidecar для Hasura WebSocket у ru (abie.mdc)')
+  await ensureAbieNginxSidecarForHasura(root, yamlFiles, fail, pass)
+
   return reporter.getExitCode()
 }

package/scripts/check-ga.mjs

@@ -256,7 +256,7 @@ function checkGaWorkflowFiles(wfDir, files, pass, fail) {
     pass('Всі workflows мають розширення .yml')
   }
 
-  for (const f of ['clean-ga-workflows.yml', 'clean-merged-branch.yml', 'lint-ga.yml']) {
+  for (const f of ['clean-ga-workflows.yml', 'clean-merged-branch.yml', 'lint-ga.yml', 'git-ai.yml']) {
     if (files.includes(f)) {
       pass(`${f} існує`)
     } else {
@@ -265,6 +265,66 @@ function checkGaWorkflowFiles(wfDir, files, pass, fail) {
   }
 }
 
+/**
+ * Перевіряє git-ai.yml: тригер pull_request з types: [closed], умова merged у job, виклик git-ai.
+ * @param {string} wfDir директорія workflows
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkGitAiWorkflow(wfDir, passFn, failFn) {
+  const gitAiWf = join(wfDir, 'git-ai.yml')
+  if (!existsSync(gitAiWf)) return
+  const content = await readFile(gitAiWf, 'utf8')
+  const root = parseWorkflowYaml(content)
+
+  if (root) {
+    // on.pull_request.types має містити 'closed'
+    const on = root.on
+    let hasPrClosed = false
+    if (on && typeof on === 'object') {
+      const pr = /** @type {Record<string, unknown>} */ (on)['pull_request']
+      if (pr && typeof pr === 'object') {
+        const types = /** @type {Record<string, unknown>} */ (pr).types
+        hasPrClosed = Array.isArray(types) && types.includes('closed')
+      }
+    }
+    if (hasPrClosed) {
+      passFn('git-ai.yml: on.pull_request.types містить closed')
+    } else {
+      failFn('git-ai.yml: on.pull_request.types має містити closed (ga.mdc)')
+    }
+
+    // Job if-умова: запускати лише при злитті PR
+    const jobs = root.jobs
+    let hasMergedCondition = false
+    if (jobs && typeof jobs === 'object') {
+      for (const job of Object.values(jobs)) {
+        if (job && typeof job === 'object') {
+          const ifCond = String(/** @type {Record<string, unknown>} */ (job).if ?? '')
+          if (ifCond.includes('merged')) {
+            hasMergedCondition = true
+          }
+        }
+      }
+    }
+    if (hasMergedCondition) {
+      passFn('git-ai.yml: job має умову merged')
+    } else {
+      failFn('git-ai.yml: job має містити if: github.event.pull_request.merged == true (ga.mdc)')
+    }
+  }
+
+  // Крок викликає git-ai ci github run
+  const hasGitAiRun = root
+    ? anyRunStepIncludes(root, 'git-ai ci github run')
+    : content.includes('git-ai ci github run')
+  if (hasGitAiRun) {
+    passFn('git-ai.yml: крок виконує git-ai ci github run')
+  } else {
+    failFn('git-ai.yml: крок має містити git-ai ci github run (ga.mdc)')
+  }
+}
+
 /**
  * Перевіряє відповідність проєкту правилам ga.mdc
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
@@ -318,6 +378,7 @@ export async function check() {
   await checkZizmor(pass, fail)
   await checkLintGaScript(pass, fail)
   await checkLintGaWorkflow(wfDir, pass, fail)
+  await checkGitAiWorkflow(wfDir, pass, fail)
 
   return reporter.getExitCode()
 }

package/scripts/check-js-pino.mjs

@@ -5,6 +5,8 @@
  * (`import` / `require` / динамічний `import()`); наявність `OTEL_RESOURCE_ATTRIBUTES`
  * у `k8s/base/configmap.yaml`, якщо такий файл існує.
  *
+ * Перевірка відповідності імені ConfigMap імені Deployment — у `check-k8s.mjs` (k8s.mdc).
+ *
  * Імпорти в джерелах сканує AST через `oxc-parser` (див. `utils/bunyan-imports.mjs`),
  * щоб виявити випадки на кшталт `import log from '@nitra/bunyan'`, які лишаються в коді
  * після підміни залежності.
@@ -78,7 +80,7 @@ async function checkWorkspacePackage(rootDir, fail, passFn) {
     passFn(`${label}немає імпортів '@nitra/bunyan' / 'bunyan' у джерелах`)
   }
 
-  const configmapPath = join(rootDir, 'k8s/base/configmap.yaml')
+  const configmapPath = join(rootDir, 'k8s', 'base', 'configmap.yaml')
   if (existsSync(configmapPath)) {
     const content = await readFile(configmapPath, 'utf8')
     if (content.includes('OTEL_RESOURCE_ATTRIBUTES')) {

package/scripts/check-k8s.mjs

@@ -58,7 +58,7 @@
  * **Структура `HTTPRoute` для Hasura-Deployment:** звіряється канон 4 правил у **`spec.rules`** (редиректи **`<prefix>/ql`** і **`<prefix>/ql/`** на **`<prefix>/ql/console`** 302, **`PathPrefix <prefix>/ql`** + **URLRewrite** на **`/`**, окреме WebSocket-правило з **`RequestHeaderModifier`** remove **`Authorization`**). **Префікс параметризовано** (рядок перед **`/ql`** у першому Hasura-правилі). **Прив'язка** — за **`metadata.name`** у тому ж каталозі, що й **Deployment** з образом **`hasura/graphql-engine`** (див. k8s.mdc). **Додаткові правила** поверх канону дозволені.
  */
 import { existsSync } from 'node:fs'
-import { readFile, stat, unlink } from 'node:fs/promises'
+import { readFile, readdir, stat, unlink } from 'node:fs/promises'
 import { basename, dirname, join, relative, resolve } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
@@ -1959,6 +1959,88 @@ export function isHasuraDeploymentManifest(manifest) {
   return containerListHasHasuraImage(p.containers) || containerListHasHasuraImage(p.initContainers)
 }
 
+const K8S_YAML_EXT_RE = /\.ya?ml$/iu
+
+/**
+ * Знаходить перший документ **Deployment** серед YAML-файлів каталогу (для перевірки імені ConfigMap, js-pino.mdc).
+ * @param {string} dirPath абсолютний шлях до каталогу
+ * @returns {Promise<Record<string, unknown> | null>} об'єкт Deployment або null
+ */
+export async function findDeploymentDocInDir(dirPath) {
+  let entries
+  try {
+    entries = await readdir(dirPath)
+  } catch {
+    return null
+  }
+  for (const entry of entries) {
+    if (!K8S_YAML_EXT_RE.test(entry)) continue
+    let raw
+    try {
+      raw = await readFile(join(dirPath, entry), 'utf8')
+    } catch {
+      continue
+    }
+    let docs
+    try {
+      docs = parseAllDocuments(raw)
+    } catch {
+      continue
+    }
+    for (const doc of docs) {
+      if (doc.errors.length > 0) continue
+      const obj = doc.toJSON()
+      if (obj !== null && typeof obj === 'object' && !Array.isArray(obj)) {
+        const rec = /** @type {Record<string, unknown>} */ (obj)
+        if (rec.kind === 'Deployment') return rec
+      }
+    }
+  }
+  return null
+}
+
+/**
+ * Збирає унікальні імена **ConfigMap**, на які посилається **Deployment**
+ * через `spec.template.spec.containers[*].envFrom[*].configMapRef.name`
+ * та `spec.template.spec.volumes[*].configMap.name` (для перевірки js-pino.mdc).
+ * @param {Record<string, unknown>} deployment об'єкт Deployment
+ * @returns {Set<string>} унікальні імена ConfigMap
+ */
+export function collectDeploymentConfigMapRefs(deployment) {
+  /** @type {Set<string>} */
+  const names = new Set()
+  const spec = deployment.spec
+  if (spec === null || typeof spec !== 'object' || Array.isArray(spec)) return names
+  const template = /** @type {Record<string, unknown>} */ (spec).template
+  if (template === null || typeof template !== 'object' || Array.isArray(template)) return names
+  const podSpec = /** @type {Record<string, unknown>} */ (template).spec
+  if (podSpec === null || typeof podSpec !== 'object' || Array.isArray(podSpec)) return names
+  const ps = /** @type {Record<string, unknown>} */ (podSpec)
+  for (const c of Array.isArray(ps.containers) ? /** @type {unknown[]} */ (ps.containers) : []) {
+    if (c === null || typeof c !== 'object' || Array.isArray(c)) continue
+    const envFrom = /** @type {Record<string, unknown>} */ (c).envFrom
+    for (const ef of Array.isArray(envFrom) ? /** @type {unknown[]} */ (envFrom) : []) {
+      if (ef !== null && typeof ef === 'object' && !Array.isArray(ef)) {
+        const cmr = /** @type {Record<string, unknown>} */ (ef).configMapRef
+        if (cmr !== null && typeof cmr === 'object' && !Array.isArray(cmr)) {
+          const n = /** @type {Record<string, unknown>} */ (cmr).name
+          if (typeof n === 'string' && n.trim() !== '') names.add(n)
+        }
+      }
+    }
+  }
+  for (const v of Array.isArray(ps.volumes) ? /** @type {unknown[]} */ (ps.volumes) : []) {
+    if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+      const cm = /** @type {Record<string, unknown>} */ (v).configMap
+      if (cm !== null && typeof cm === 'object' && !Array.isArray(cm)) {
+        const n = /** @type {Record<string, unknown>} */ (cm).name
+        if (typeof n === 'string' && n.trim() !== '') names.add(n)
+      }
+    }
+  }
+  return names
+}
+
 /**
  * Чи **Service** містить заборонені анотації GKE у **`metadata.annotations`** (k8s.mdc).
  * @param {unknown} manifest корінь YAML-документа
@@ -3160,6 +3242,69 @@ async function ensureBaseKustomizationHasNamespace(root, yamlFiles, fail) {
   }
 }
 
+const CONFIGMAP_BASE_PATH_RE = /\/k8s\/base\/configmap\.yaml$/u
+
+/**
+ * Якщо в `k8s/base/` є `configmap.yaml` і Deployment посилається рівно на один ConfigMap —
+ * `metadata.name` ConfigMap має збігатися з `metadata.name` Deployment (k8s.mdc).
+ * @param {string} root корінь репозиторію
+ * @param {string[]} yamlFilesAbs yaml під k8s
+ * @param {(msg: string) => void} fail callback при помилці
+ * @param {(msg: string) => void} passFn callback при успіху
+ */
+async function validateConfigMapNameMatchesDeployment(root, yamlFilesAbs, fail, passFn) {
+  const cmFiles = yamlFilesAbs.filter(abs => {
+    const rel = relative(root, abs).replaceAll('\\', '/')
+    return CONFIGMAP_BASE_PATH_RE.test(`/${rel}`) || rel === 'k8s/base/configmap.yaml'
+  })
+  for (const cmAbs of cmFiles) {
+    const rel = relative(root, cmAbs).replaceAll('\\', '/') || cmAbs
+    let raw
+    try {
+      raw = await readFile(cmAbs, 'utf8')
+    } catch {
+      continue
+    }
+    let cmName = null
+    try {
+      for (const doc of parseAllDocuments(raw)) {
+        if (doc.errors.length > 0) continue
+        const obj = doc.toJSON()
+        if (obj !== null && typeof obj === 'object' && !Array.isArray(obj)) {
+          const rec = /** @type {Record<string, unknown>} */ (obj)
+          if (rec.kind === 'ConfigMap') {
+            const meta = rec.metadata
+            if (meta !== null && typeof meta === 'object' && !Array.isArray(meta)) {
+              const n = /** @type {Record<string, unknown>} */ (meta).name
+              if (typeof n === 'string' && n.trim() !== '') cmName = n
+            }
+            break
+          }
+        }
+      }
+    } catch {
+      continue
+    }
+    if (cmName === null) continue
+    const deployment = await findDeploymentDocInDir(dirname(cmAbs))
+    if (deployment === null) continue
+    const meta = deployment.metadata
+    const deployName =
+      meta !== null && typeof meta === 'object' && !Array.isArray(meta)
+        ? /** @type {Record<string, unknown>} */ (meta).name
+        : null
+    const cmRefs = collectDeploymentConfigMapRefs(deployment)
+    if (cmRefs.size !== 1 || typeof deployName !== 'string') continue
+    if (cmName === deployName) {
+      passFn(`${rel}: metadata.name '${cmName}' збігається з Deployment (k8s.mdc)`)
+    } else {
+      fail(
+        `${rel}: metadata.name '${cmName}' має збігатися з назвою Deployment '${deployName}' — Deployment посилається рівно на один ConfigMap (k8s.mdc)`
+      )
+    }
+  }
+}
+
 /**
  * Перевіряє відповідність проєкту правилам k8s.mdc.
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
@@ -3201,5 +3346,7 @@ export async function check() {
 
   await ensureBaseKustomizationHasNamespace(root, yamlFiles, fail)
 
+  await validateConfigMapNameMatchesDeployment(root, yamlFiles, fail, pass)
+
   return reporter.getExitCode()
 }