@nitra/cursor 1.8.161 → 1.8.164

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.164] - 2026-05-01
+
+### Added
+
+- `abie.mdc` (v1.16) / `check-abie.mjs`: нова перевірка `.github/actionlint.yaml`. Якщо файл відсутній — `npx @nitra/cursor check abie` створює його з канонічним вмістом (`self-hosted-runner.labels: ['ua', 'dev', 'ru']`); якщо є — звіряє, що в `self-hosted-runner.labels` присутні мітки `ua`, `dev`, `ru` (порядок, інші мітки й формат лапок дозволені). Експортовано `ABIE_REQUIRED_ACTIONLINT_LABELS`, `parseActionlintSelfHostedLabels`, `abieMissingActionlintLabels`.
+
+## [1.8.163] - 2026-05-01
+
+### Changed
+
+- `check-js-lint.mjs`: `ignorePatterns` у `.oxlintrc.json` тепер звіряється як `rules` — канонічні патерни мають бути присутні, додаткові локальні glob-и дозволені (раніше була строга рівність — будь-який зайвий запис зламував перевірку).
+- `check-text.mjs`: `OXFMT_REQUIRED_IGNORE_PATTERNS` доповнено `**/auto-imports.d.ts` (узгоджено з каноном oxlint); перевірка `.oxfmtrc.json` уже працює як subset, тому локальні розширення не падають.
+- `js-lint.mdc` / `n-js-lint.mdc`, `text.mdc` / `n-text.mdc`: документовано, що канон задає мінімум `ignorePatterns`, локальне розширення дозволене.
+
+## [1.8.162] - 2026-05-01
+
+### Changed
+
+- `oxlint-canonical-skeleton.json` (та перебудований `oxlint-canonical.json`): `ignorePatterns` тепер містить `["**/schema.graphql", "**/auto-imports.d.ts"]` (узгоджено з `.oxfmtrc.json`). Споживачі мають синхронізувати корінь `.oxlintrc.json` із каноном — `check-js-lint` падатиме, поки масив не збігається.
+
 ## [1.8.161] - 2026-05-01
 
 ### Added

package/mdc/abie.mdc

@@ -1,10 +1,10 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.15'
+version: '1.16'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
+Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua** / **ru**), у overlay **ru** — кожен **Service** (у т. ч. **headless** / **`-hl`**) → **`spec.type: NodePort`** через **JSON6902** у **`kustomization.yaml`**, видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, **`.github/actionlint.yaml`** із мітками **`self-hosted-runner`** **ua** / **dev** / **ru** (створюється автоматично за відсутності), а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -336,6 +336,18 @@ spec:
 
 У **кожному** підкаталозі, що лежить **безпосередньо** в корені репозиторію, не тримати конфіг і кеш **Firebase Hosting**: у таких каталогах не повинно бути **`.firebaserc`**, **`firebase.json`** та каталогу **`.firebase/`** (у **самому** корені репозиторію ці імена перевіркою abie **не** розглядаються; `node_modules` / `.git` зі скану вилучаються).
 
+## actionlint: self-hosted-runner labels
+
+У **`.github/actionlint.yaml`** має бути блок **`self-hosted-runner.labels`** з присутніми мітками **`ua`**, **`dev`**, **`ru`**. Якщо файлу немає — **`npx @nitra/cursor check abie`** створює його з канонічним вмістом. Інші мітки, інший порядок та формат лапок дозволені — перевіряється лише наявність трьох обов'язкових міток (деталі — **`check-abie.mjs`**).
+
+```yaml title=".github/actionlint.yaml"
+self-hosted-runner:
+  labels:
+    - 'ua'
+    - 'dev'
+    - 'ru'
+```
+
 ## Git branches
 
 У **`.github/workflows/clean-merged-branch.yml`** у кроці **`phpdocker-io/github-actions-delete-abandoned-branches`** значення **`with.ignore_branches`** має містити **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно):

package/mdc/js-lint.mdc

@@ -30,7 +30,7 @@ version: '1.16'
 }
 ```
 
-У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/scripts/utils/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**, **`ignorePatterns`**). Оновити можна з репозиторію пакета або скопіювавши файл після **`bun ./scripts/utils/rebuild-oxlint-canonical.mjs`** (джерело правил — **`oxlint-rules.tsv`** + скелет **`oxlint-canonical-skeleton.json`**). Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
+У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/scripts/utils/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Оновити канон можна з репозиторію пакета або скопіювавши файл після **`bun ./scripts/utils/rebuild-oxlint-canonical.mjs`** (джерело правил — **`oxlint-rules.tsv`** + скелет **`oxlint-canonical-skeleton.json`**). Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
 
 Мінімум для розуміння структури (реальний корінь конфігу має збігатися з каноном повністю):
 

package/mdc/text.mdc

@@ -82,7 +82,7 @@ version: '1.25'
 
 ```json title=".oxfmtrc.json"
 {
-  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql"],
+  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql", "**/auto-imports.d.ts"],
   "arrowParens": "avoid",
   "printWidth": 120,
   "bracketSpacing": true,
@@ -104,7 +104,7 @@ version: '1.25'
 }
 ```
 
-Поле **`ignorePatterns`** обовʼязкове: у масиві мають бути **`**/hasura/metadata/**`** та **`**/schema.graphql`**; інші glob-и додавай за потреби (згенеровані каталоги тощо).
+Поле **`ignorePatterns`** обовʼязкове: у масиві мають бути **`**/hasura/metadata/**`**, **`**/schema.graphql`** і **`**/auto-imports.d.ts`**; інші glob-и додавай за потреби (згенеровані каталоги тощо) — канон задає мінімум, локальні розширення дозволені.
 
 Також потрібно прибрати, якщо є в проєкті, модуль **`@nitra/prettier-config`**, **prettier** та всі виклики prettier і налаштування для нього.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.8.161",
+  "version": "1.8.164",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -47,5 +47,8 @@
   "engines": {
     "bun": ">=1.3",
     "node": ">=25"
+  },
+  "devDependencies": {
+    "@nitra/cursor": "^1.8.164"
   }
 }

package/scripts/check-abie.mjs

@@ -39,7 +39,7 @@
  * у файлі **`k8s/ru/kustomization.yaml`** того ж пакета (overlay середовища **ru**) — inline **JSON6902** на **`kind: Service`** з тим самим **`target.name`**: **`path: /spec/type`**, **`value: NodePort`**; якщо в base було **`spec.clusterIP: None`** — **`op: remove`** для **`/spec/clusterIP`**; якщо в base **явно** задано **`spec.clusterIPs`** — також **`remove`** для **`/spec/clusterIPs`** (інакше **API** може залишити **`None`** для **NodePort**; без ключа **`clusterIPs`** у base **`remove`** на **`/spec/clusterIPs`** ламає **`kubectl kustomize`**).
  */
 import { existsSync } from 'node:fs'
-import { readdir, readFile } from 'node:fs/promises'
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
 import { dirname, join, relative } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
@@ -118,6 +118,20 @@ const HTTPROUTE_BACKENDREF_PORT_8081_VALUE_FIRST_RE =
 /** Гілки, які мають бути в **`ignore_branches`** за abie.mdc. */
 export const ABIE_REQUIRED_IGNORE_BRANCHES = ['dev', 'ua', 'ru']
 
+/** Канонічний шлях до конфігу actionlint у репо (abie.mdc). */
+const ABIE_ACTIONLINT_PATH = '.github/actionlint.yaml'
+
+/** Канонічний вміст **`.github/actionlint.yaml`**, який ми створюємо за відсутності файлу (abie.mdc). */
+const ABIE_ACTIONLINT_TEMPLATE = `self-hosted-runner:
+  labels:
+    - 'ua'
+    - 'dev'
+    - 'ru'
+`
+
+/** Мітки **`self-hosted-runner.labels`**, які мають бути присутні в **`.github/actionlint.yaml`** (abie.mdc). */
+export const ABIE_REQUIRED_ACTIONLINT_LABELS = Object.freeze(['ua', 'dev', 'ru'])
+
 /**
  * Чи відносний шлях вказує на **`ru/kustomization.yaml`** (сегмент **`ru`** перед ім'ям файлу) — специфіка abie overlay.
  * @param {string} rel шлях від кореня репозиторію
@@ -1717,9 +1731,82 @@ async function ensureNoFirebaseHostingArtifacts(root, passFn, failFn) {
 }
 
 /**
- * Перевіряє відповідність проєкту правилам abie.mdc.
- * @returns {Promise<number>} 0 — OK, 1 — є порушення
+ * Витягує мітки **`self-hosted-runner.labels`** з тексту `.github/actionlint.yaml`.
+ * @param {string} raw повний вміст файлу (YAML)
+ * @returns {string[] | null} масив рядків-міток або null, якщо ключа/масиву не знайдено
+ */
+export function parseActionlintSelfHostedLabels(raw) {
+  let docs
+  try {
+    docs = parseAllDocuments(raw)
+  } catch {
+    return null
+  }
+  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 block = /** @type {Record<string, unknown>} */ (root)['self-hosted-runner']
+    if (block === null || typeof block !== 'object' || Array.isArray(block)) continue
+    const labels = /** @type {Record<string, unknown>} */ (block).labels
+    if (!Array.isArray(labels)) continue
+    return labels.filter(l => typeof l === 'string')
+  }
+  return null
+}
+
+/**
+ * Які з **`ABIE_REQUIRED_ACTIONLINT_LABELS`** відсутні в наданому списку міток (abie.mdc).
+ * @param {string[]} labels мітки **`self-hosted-runner.labels`**
+ * @returns {string[]} відсутні мітки (порожньо — все ок)
  */
+export function abieMissingActionlintLabels(labels) {
+  const present = new Set(labels.map(l => l.trim()))
+  return ABIE_REQUIRED_ACTIONLINT_LABELS.filter(r => !present.has(r))
+}
+
+/**
+ * Гарантує наявність **`.github/actionlint.yaml`** із потрібними мітками **`self-hosted-runner`** (abie.mdc):
+ * створює файл із канонічним вмістом, якщо його немає; якщо є — звіряє мітки.
+ * @param {string} root корінь репозиторію
+ * @param {(msg: string) => void} pass callback при успішній перевірці
+ * @param {(msg: string) => void} fail callback при помилці
+ */
+async function ensureAbieActionlintConfig(root, pass, fail) {
+  const abs = join(root, ABIE_ACTIONLINT_PATH)
+  if (!existsSync(abs)) {
+    try {
+      await mkdir(dirname(abs), { recursive: true })
+      await writeFile(abs, ABIE_ACTIONLINT_TEMPLATE, 'utf8')
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`${ABIE_ACTIONLINT_PATH}: не вдалося створити (${msg}) — abie.mdc`)
+      return
+    }
+    pass(`${ABIE_ACTIONLINT_PATH}: створено з self-hosted-runner.labels [ua, dev, ru] (abie.mdc)`)
+    return
+  }
+  let raw
+  try {
+    raw = await readFile(abs, 'utf8')
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error)
+    fail(`${ABIE_ACTIONLINT_PATH}: не вдалося прочитати (${msg}) — abie.mdc`)
+    return
+  }
+  const labels = parseActionlintSelfHostedLabels(raw)
+  if (labels === null) {
+    fail(`${ABIE_ACTIONLINT_PATH}: не знайдено self-hosted-runner.labels — додай мітки ua, dev, ru (abie.mdc)`)
+    return
+  }
+  const missing = abieMissingActionlintLabels(labels)
+  if (missing.length > 0) {
+    fail(`${ABIE_ACTIONLINT_PATH}: у self-hosted-runner.labels бракує ${missing.join(', ')} (abie.mdc)`)
+    return
+  }
+  pass(`${ABIE_ACTIONLINT_PATH}: self-hosted-runner.labels містить ua, dev, ru (abie.mdc)`)
+}
+
 /**
  * Перевіряє clean-merged-branch.yml на ignore_branches.
  * @param {string} root корінь репозиторію
@@ -2091,6 +2178,7 @@ export async function check() {
   pass('Правило abie увімкнено — виконуємо перевірки')
   await ensureNoFirebaseHostingArtifacts(root, pass, fail)
   await checkCleanMergedBranch(root, pass, fail)
+  await ensureAbieActionlintConfig(root, pass, fail)
 
   const yamlFiles = await findK8sYamlFiles(root)
   const deploymentDirs = await collectDeploymentDirs(root, yamlFiles, fail)

package/scripts/check-js-lint.mjs

@@ -133,6 +133,30 @@ function compareOxlintRules(expected, actual, failures) {
   }
 }
 
+/**
+ * Звіряє блок `ignorePatterns`: кожен патерн із канону має бути присутній в actual; додаткові локальні
+ * патерни дозволені (канон задає мінімум, проєкт може розширити).
+ * @param {unknown} expected канонічний масив `ignorePatterns`
+ * @param {unknown} actual поточний `ignorePatterns` із `.oxlintrc.json`
+ * @param {string[]} failures буфер для помилок
+ */
+function compareOxlintIgnorePatterns(expected, actual, failures) {
+  if (!Array.isArray(expected)) {
+    return
+  }
+  if (!Array.isArray(actual)) {
+    failures.push('.oxlintrc.json: поле "ignorePatterns" має бути масивом (канон задає мінімум, додаткові патерни дозволені)')
+    return
+  }
+  const set = new Set(actual)
+  const missing = expected.filter(p => !set.has(p))
+  if (missing.length > 0) {
+    failures.push(
+      `.oxlintrc.json: ignorePatterns має містити канонічні патерни — додай: ${missing.map(p => JSON.stringify(p)).join(', ')}`
+    )
+  }
+}
+
 /**
  * Перевіряє `.oxlintrc.json` проти канону пакета `@nitra/cursor` (усі правила з канону та інші поля з `oxlint-canonical.json`).
  * Додаткові ключі лише в `rules` дозволені; інші поля мають збігатися з каноном.
@@ -160,6 +184,11 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
       continue
     }
 
+    if (key === 'ignorePatterns') {
+      compareOxlintIgnorePatterns(expected, actual, failures)
+      continue
+    }
+
     if (!deepEqualOxlintCanonical(actual, expected)) {
       failures.push(
         `.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/scripts/utils/oxlint-canonical.json)`

package/scripts/check-text.mjs

@@ -29,8 +29,8 @@ const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)/
 /** Заголовок абзацу про апостроф у text.mdc / n-text.mdc. */
 const UK_APOSTROPHE_HEADING = '**Український апостроф:**'
 
-/** Мінімальні glob-и в `ignorePatterns` у `.oxfmtrc.json` (text.mdc). */
-const OXFMT_REQUIRED_IGNORE_PATTERNS = ['**/hasura/metadata/**', '**/schema.graphql']
+/** Мінімальні glob-и в `ignorePatterns` у `.oxfmtrc.json` (text.mdc) — додаткові патерни локально дозволені. */
+const OXFMT_REQUIRED_IGNORE_PATTERNS = ['**/hasura/metadata/**', '**/schema.graphql', '**/auto-imports.d.ts']
 
 /** Канонічні записи `ignorePaths` у `.cspell.json` (text.mdc) — кожен має бути присутнім. */
 const CSPELL_REQUIRED_IGNORE_PATHS = [
@@ -211,7 +211,7 @@ async function checkOxfmtRc(passFn, failFn) {
     const set = new Set(cfg.ignorePatterns)
     const missingPatterns = OXFMT_REQUIRED_IGNORE_PATTERNS.filter(p => !set.has(p))
     if (missingPatterns.length === 0) {
-      passFn('.oxfmtrc.json: ignorePatterns містить hasura/metadata та schema.graphql')
+      passFn('.oxfmtrc.json: ignorePatterns містить hasura/metadata, schema.graphql і auto-imports.d.ts')
     } else {
       failFn(
         `.oxfmtrc.json ignorePatterns: додай відсутні елементи: ${missingPatterns.join(', ')} (канонічний приклад у text.mdc)`

package/scripts/utils/oxlint-canonical-skeleton.json

@@ -23,5 +23,5 @@
     "builtin": true
   },
   "globals": {},
-  "ignorePatterns": []
+  "ignorePatterns": ["**/schema.graphql", "**/auto-imports.d.ts"]
 }

package/scripts/utils/oxlint-canonical.json

@@ -1,7 +1,17 @@
 {
   "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "plugins": ["unicorn", "oxc", "import", "jsdoc", "promise", "node", "vue"],
-  "jsPlugins": ["@e18e/eslint-plugin"],
+  "plugins": [
+    "unicorn",
+    "oxc",
+    "import",
+    "jsdoc",
+    "promise",
+    "node",
+    "vue"
+  ],
+  "jsPlugins": [
+    "@e18e/eslint-plugin"
+  ],
   "categories": {},
   "rules": {
     "e18e/prefer-includes": "error",
@@ -383,5 +393,8 @@
     "builtin": true
   },
   "globals": {},
-  "ignorePatterns": []
+  "ignorePatterns": [
+    "**/schema.graphql",
+    "**/auto-imports.d.ts"
+  ]
 }