@nitra/cursor 1.11.3 → 1.11.4

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.11.4] - 2026-05-15
+
+### Fixed
+
+- **`npm/rules/nginx-default-tpl/js/template/check.mjs`** — `findDefaultConfTemplatePaths` пропускає тестові `fixtures/` за будь-яким сегментом шляху, не лише `tests/fixtures/`. Після concern-split (фази 1-4) fixtures лежать у `rules/<rule>/js/<concern>/fixtures/`, і старий патерн пропускав їх повз → check шукав Dockerfile поруч із тестовим шаблоном і фалс-фейлив.
+
 ## [1.11.3] - 2026-05-15
 
 ### Fixed
@@ -55,7 +61,7 @@
 - **Інкрементальна міграція правил на `target.json`** (декларативні маніфести поруч із кожним `<concern>.rego`):
   - **Single-file правила** (11): `bun`, `text`, `style-lint`, `php`, `docker`, `npm-module`, `js-lint`, `image-compress`, `capacitor`, `hasura`, `adr` — `target.json` з `single` для кожного канонічного конфіг-файлу. Сумарно 27 нових маніфестів. `bun.bunfig`, `text.cspell`, `npm_module.npm_publish_yml` тощо тепер прогоняються через CLI `check <id>` без додаткового `bun run lint-conftest`.
   - **Walk-glob правила** (6): `js-mssql`, `js-bun-db`, `js-bun-redis`, `js-run` (package_json + configmap), `vue`, `image-avif` — `walkGlob: "**/package.json"` або відповідний патерн.
-  - **k8s.* концерни** (8): `manifest`, `gateway`, `hpa_pdb`, `kustomization`, `svc_yaml`, `svc_hl_yaml`, `base_kustomization`, `base_manifest` — `walkGlob` по YAML під сегментом `k8s/`; `base_manifest` використовує негативний glob для виключення `kustomization.yaml`.
+  - **k8s.\* концерни** (8): `manifest`, `gateway`, `hpa_pdb`, `kustomization`, `svc_yaml`, `svc_hl_yaml`, `base_kustomization`, `base_manifest` — `walkGlob` по YAML під сегментом `k8s/`; `base_manifest` використовує негативний glob для виключення `kustomization.yaml`.
   - **abie концерни** (4): `clean_merged_ignore_branches` (single), `health_check_policy` (walkGlob `**/k8s/**/hc.yaml`), `http_route_base` (walkGlob `**/k8s/**/base/**/hr.yaml`), `base_deployment_preem` (walkGlob `**/k8s/**/base/**/*.{yaml,yml}` з виключенням `kustomization.yaml`).
 - **`capture-decisions.sh` тепер пише чернетки напряму в `docs/adr/<timestamp>-<sid>.md`** (раніше — у `docs/adr/_inbox/`). Сам каталог `_inbox/` більше не створюється, але `normalize-decisions.sh` бачить його рекурсивно — старі чернетки з `_inbox/` поступово розчищаються нормалізацією. Можна також одноразово `git mv docs/adr/_inbox/*.md docs/adr/` і прибрати порожній каталог.
 - **Правило `adr` (`npm/rules/adr/adr.mdc`)**: повне переписування під дві фази (capture + normalize). Видалено згадки `_inbox/`. Версія `version: '2.0'`.
@@ -84,7 +90,7 @@
 
 ### Changed
 
-- **Rule-centric структура пакета.** Кожне правило тепер живе в одній директорії `npm/rules/{rule}/` з усіма своїми артефактами: `{rule}.mdc`, `auto.md` (умова автоактивації), `policy/` (rego-поліси), `js/` (check.mjs + опційні run/lint + co-located *.test.mjs + fixtures/). Видалив каталог правила — правило зникло без слідів у `bin/auto-rules.md`, `npm/policy/`, `npm/scripts/`. Дзеркальна структура для скілів у `npm/skills/{skill}/` (SKILL.md + auto.md + js/).
+- **Rule-centric структура пакета.** Кожне правило тепер живе в одній директорії `npm/rules/{rule}/` з усіма своїми артефактами: `{rule}.mdc`, `auto.md` (умова автоактивації), `policy/` (rego-поліси), `js/` (check.mjs + опційні run/lint + co-located \*.test.mjs + fixtures/). Видалив каталог правила — правило зникло без слідів у `bin/auto-rules.md`, `npm/policy/`, `npm/scripts/`. Дзеркальна структура для скілів у `npm/skills/{skill}/` (SKILL.md + auto.md + js/).
 - **Тести співрозташовуються з джерелами.** ~50 файлів з `npm/tests/` переїхали в `npm/rules/{rule}/js/*.test.mjs` (тести правил), `npm/scripts/*.test.mjs` (тести інфраструктури), `npm/scripts/utils/*.test.mjs` (тести утиліт). `tests/helpers.mjs` → `scripts/utils/test-helpers.mjs`. `npm/tests/` залишається тільки для 3 крос-правильних інтеграційних тестів.
 - **`bin/n-cursor.js`**: `BUNDLED_MDC_DIR` → `BUNDLED_RULES_DIR`. `discoverBundledRuleNames` і `discoverCheckScripts` тепер обходять підкаталоги `rules/` замість файлів у `mdc/` чи `check-*.mjs` у `scripts/`. Резолвер check-скриптів: `rules/{rule}/js/check.mjs`. `readBundledRuleContent` читає `rules/{rule}/{rule}.mdc`.
 - **`scripts/utils/run-conftest-batch.mjs` та `scripts/lint-conftest.mjs`**: шляхи до rego-полісі — `rules/{rule}/policy/{name}/` (замість `policy/{rule}/{name}/`). Snake_case `policyDirRel` у JS-call sites замінено на kebab-case.

package/bin/n-cursor.js

@@ -266,8 +266,9 @@ async function readConfig(paths = {}) {
     // правило, додане вручну (напр. `adr` без auto.md-умови), не активувало б залежні
     // скіли (`adr-normalize`).
     const disableRulesSet = new Set(disableRules)
-    const effectiveRulesForSkills = [...new Set([...normalizeIdList(parsedConfig.rules), ...autoDetectedRules.rules])]
-      .filter(id => !disableRulesSet.has(id))
+    const effectiveRulesForSkills = [
+      ...new Set([...normalizeIdList(parsedConfig.rules), ...autoDetectedRules.rules])
+    ].filter(id => !disableRulesSet.has(id))
     const autoDetectedSkills = detectAutoSkills({
       availableSkills,
       detectedRules: effectiveRulesForSkills,

package/package.json

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

package/rules/abie/js/applies/check.mjs

@@ -8,16 +8,16 @@ import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mj
 import { isAbieRuleEnabled } from '../../utils/enabled.mjs'
 
 /**
- * @returns {Promise<boolean>}
+ * @returns {Promise<boolean>} `true` — правило застосовне; `false` — пропустити
  */
-export async function applies() {
+export function applies() {
   return isAbieRuleEnabled(process.cwd())
 }
 
 /**
- * @returns {Promise<number>}
+ * @returns {number} exit-код (0 — OK, 1 — порушення)
  */
-export async function check() {
+export function check() {
   const reporter = createCheckReporter()
   reporter.pass('Правило abie увімкнено — виконуємо перевірки')
   return reporter.getExitCode()

package/rules/abie/js/env_dns/check.mjs

@@ -15,7 +15,7 @@ import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-con
 import { abieEnvNameFromBasename, collectAbieEnvFiles, validateAbieEnvInternalUrls } from '../../utils/env-dns.mjs'
 
 /**
- * @returns {Promise<number>}
+ * @returns {Promise<number>} результат
  */
 export async function check() {
   const reporter = createCheckReporter()

package/rules/abie/js/firebase_hosting/check.mjs

@@ -12,7 +12,7 @@ import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mj
 const SKIP_TOP_DIR_NAMES = new Set(['.git', 'node_modules'])
 
 /**
- * @returns {Promise<number>}
+ * @returns {Promise<number>} результат
  */
 export async function check() {
   const reporter = createCheckReporter()

package/rules/abie/js/hc_pairing/check.mjs

@@ -17,7 +17,7 @@ import { validateAbieHcModeline } from '../../utils/hc-yaml.mjs'
 import { collectDeploymentDirs, findK8sYamlFiles } from '../../utils/k8s-tree.mjs'
 
 /**
- * @returns {Promise<number>}
+ * @returns {Promise<number>} результат
  */
 export async function check() {
   const reporter = createCheckReporter()
@@ -50,8 +50,8 @@ export async function check() {
       continue
     }
     const modelineErr = validateAbieHcModeline(hcRaw, relHc)
-    if (modelineErr !== null) fail(modelineErr)
-    else pass(`${relHc}: modeline OK`)
+    if (modelineErr === null) pass(`${relHc}: modeline OK`)
+    else fail(modelineErr)
   }
 
   return reporter.getExitCode()

package/rules/abie/js/ua_http_route/check.mjs

@@ -26,7 +26,7 @@ import {
 } from '../../utils/overlay-paths.mjs'
 
 /**
- * @returns {Promise<number>}
+ * @returns {Promise<number>} результат
  */
 export async function check() {
   const reporter = createCheckReporter()
@@ -78,8 +78,8 @@ export async function check() {
     }
     const combined = getCombinedNginxRunPatchTextFromKustomization(raw)
     const v = validateAbieNginxRunHttpRoutePatches(combined, 'ua', raw, sharedAnalysis.refCount)
-    if (v !== null) fail(`${rel}: ${v}`)
-    else pass(`${rel}: HTTPRoute patch (ua) відповідає abie.mdc`)
+    if (v === null) pass(`${rel}: HTTPRoute patch (ua) відповідає abie.mdc`)
+    else fail(`${rel}: ${v}`)
   }
 
   return reporter.getExitCode()

package/rules/abie/js/ua_node_selector/check.mjs

@@ -16,7 +16,7 @@ import { kustomizationHasAbieDeploymentNodeSelectorPatch } from '../../utils/kus
 import { abieOverlayK8sTreeHasDeployment, isUaKustomizationPath } from '../../utils/overlay-paths.mjs'
 
 /**
- * @returns {Promise<number>}
+ * @returns {Promise<number>} результат
  */
 export async function check() {
   const reporter = createCheckReporter()
@@ -55,7 +55,9 @@ export async function check() {
       continue
     }
     if (!kustomizationHasAbieDeploymentNodeSelectorPatch(raw, 'ua')) {
-      fail(`${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та preem: false (abie.mdc)`)
+      fail(
+        `${rel}: потрібен patch target kind Deployment: path /spec/template/spec/nodeSelector та preem: false (abie.mdc)`
+      )
       continue
     }
     pass(`${rel}: nodeSelector patch (ua) відповідає abie.mdc`)

package/rules/abie/policy/base_deployment_preem/target.json

@@ -1,10 +1,6 @@
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
   "files": {
-    "walkGlob": [
-      "**/k8s/**/base/**/*.yaml",
-      "**/k8s/**/base/**/*.yml",
-      "!**/k8s/**/base/**/kustomization.yaml"
-    ]
+    "walkGlob": ["**/k8s/**/base/**/*.yaml", "**/k8s/**/base/**/*.yml", "!**/k8s/**/base/**/kustomization.yaml"]
   }
 }

package/rules/abie/utils/enabled.mjs

@@ -12,7 +12,7 @@ const CONFIG_FILE = '.n-cursor.json'
 /**
  * Чи увімкнено правило **abie** у `.n-cursor.json:rules`.
  * @param {string} root корінь репозиторію (cwd)
- * @returns {Promise<boolean>}
+ * @returns {Promise<boolean>} `true` — `rules` містить `abie`; `false` — інакше
  */
 export async function isAbieRuleEnabled(root) {
   const p = join(root, CONFIG_FILE)

package/rules/abie/utils/env-dns.mjs

@@ -23,8 +23,8 @@ const ABIE_ENV_CLUSTER_DNS_MAP = Object.freeze({
 /**
  * Дістає `dev` / `ua` з basename env-файлу abie.
  * Не-abie env-файли (`production.env`, `.env` без імені) → null.
- * @param {string} basenameOfEnvFile
- * @returns {('dev' | 'ua') | null}
+ * @param {string} basenameOfEnvFile опис.
+ * @returns {('dev' | 'ua') | null} результат
  */
 export function abieEnvNameFromBasename(basenameOfEnvFile) {
   const m = basenameOfEnvFile.match(ABIE_ENV_FILE_BASENAME_RE)
@@ -35,7 +35,7 @@ export function abieEnvNameFromBasename(basenameOfEnvFile) {
  * Сканує вміст env-файла, повертає помилки невідповідності кластерного DNS / namespace
  * для кожного internal URL (один URL у двох змінних = дві окремі помилки).
  * @param {string} content вміст env-файла (UTF-8)
- * @param {'dev' | 'ua'} envName
+ * @param {'dev' | 'ua'} envName опис.
  * @returns {string[]} порожній масив, якщо все OK
  */
 export function validateAbieEnvInternalUrls(content, envName) {
@@ -63,7 +63,7 @@ export function validateAbieEnvInternalUrls(content, envName) {
  * Збирає `*.env` файли, які є abie env (`dev.env`/`ua.env`, опц. з провідною крапкою).
  * @param {string} root корінь репозиторію
  * @param {string[]} ignorePaths абсолютні шляхи каталогів-виключень
- * @returns {Promise<string[]>}
+ * @returns {Promise<string[]>} результат
  */
 export async function collectAbieEnvFiles(root, ignorePaths) {
   /** @type {string[]} */

package/rules/abie/utils/http-route.mjs

@@ -14,7 +14,7 @@ const ABIE_SHARED_CROSS_NS_BACKEND_SET = new Set(ABIE_SHARED_CROSS_NS_BACKEND_NA
 
 /**
  * Перевіряє один `backendRef`: якщо це спільний `-hl` сервіс, має бути `namespace: dev`.
- * @param {unknown} br
+ * @param {unknown} br опис.
  * @param {string} rel rel-шлях файла
  * @param {string[]} errors мутабельний список помилок
  * @returns {number} 1 — це shared backend, 0 — інакше
@@ -33,8 +33,8 @@ function checkSharedBackendRef(br, rel, errors) {
 /**
  * Збирає по HTTPRoute-документу кількість посилань на shared backends і порушення namespace.
  * @param {unknown} obj корінь YAML
- * @param {string} rel
- * @returns {{ refCount: number, errors: string[] }}
+ * @param {string} rel опис.
+ * @returns {{ refCount: number, errors: string[] }} статистика shared-backend посилань і порушення namespace
  */
 function httpRouteDocSharedCrossNsBackendStats(obj, rel) {
   /** @type {string[]} */
@@ -66,7 +66,7 @@ function httpRouteDocSharedCrossNsBackendStats(obj, rel) {
  * @param {string} root корінь репозиторію
  * @param {string} pkgAbs абсолютний шлях каталогу пакета
  * @param {string[]} yamlFilesAbs усі yaml під k8s
- * @returns {Promise<{ refCount: number, baseErrors: string[] }>}
+ * @returns {Promise<{ refCount: number, baseErrors: string[] }>} агрегована статистика й помилки base-шару
  */
 export async function analyzeAbieSharedBackendRefsInPackageK8s(root, pkgAbs, yamlFilesAbs) {
   const pkgRel = relative(root, pkgAbs).replaceAll('\\', '/') || pkgAbs

package/rules/abie/utils/k8s-tree.mjs

@@ -22,7 +22,7 @@ const deploymentCache = new Map()
 
 /**
  * Скидає кеш — тести мусять викликати між фікстурами.
- * @returns {void}
+ * @returns {void} результат
  */
 export function resetAbieK8sTreeCache() {
   yamlCache.clear()
@@ -31,9 +31,9 @@ export function resetAbieK8sTreeCache() {
 
 /**
  * Стабільний ключ кешу за (root, ignorePaths).
- * @param {string} root
- * @param {string[]} ignorePaths
- * @returns {string}
+ * @param {string} root опис.
+ * @param {string[]} ignorePaths опис.
+ * @returns {string} результат
  */
 function cacheKey(root, ignorePaths) {
   return `${root}|${[...ignorePaths].toSorted((a, b) => a.localeCompare(b)).join(':')}`
@@ -44,7 +44,7 @@ function cacheKey(root, ignorePaths) {
  * Каталог `.github/` свідомо пропускається (належить `ga.mdc`).
  * @param {string} root корінь репозиторію
  * @param {string[]} [ignorePaths] абсолютні шляхи каталогів-виключень
- * @returns {Promise<string[]>}
+ * @returns {Promise<string[]>} результат
  */
 export function findK8sYamlFiles(root, ignorePaths = []) {
   const key = cacheKey(root, ignorePaths)
@@ -77,7 +77,16 @@ export function findK8sYamlFiles(root, ignorePaths = []) {
  * @param {(msg: string) => void} [fail] репортер помилок парсингу (опц.)
  * @returns {Promise<Set<string>>} абсолютні шляхи директорій
  */
-export function collectDeploymentDirs(root, yamlAbs, fail = () => {}) {
+/**
+ * No-op fail-handler за замовчуванням для `collectDeploymentDirs` — пошкоджені YAML
+ * під час cross-rule сканування мовчки пропускаються; формальний reporter передає сам caller.
+ * @param {string} _msg повідомлення про помилку (ігнорується)
+ */
+const silentFail = _msg => {
+  // noop
+}
+
+export function collectDeploymentDirs(root, yamlAbs, fail = silentFail) {
   const key = `${root}|${[...yamlAbs].toSorted((a, b) => a.localeCompare(b)).join(':')}`
   const cached = deploymentCache.get(key)
   if (cached) return cached

package/rules/abie/utils/kustomization-patches.mjs

@@ -24,8 +24,8 @@ const ABIE_UA_HTTPROUTE_HOST_MARKERS = ['abie.app', 'vybeerai.com.ua', '*.abie.a
 
 /**
  * Чи patch-рядок містить очікуваний ua nodeSelector (preem: false).
- * @param {string} patchText
- * @returns {boolean}
+ * @param {string} patchText опис.
+ * @returns {boolean} результат
  */
 function jsonPatchTextHasUaDeploymentNodeSelector(patchText) {
   if (typeof patchText !== 'string' || patchText.trim() === '') return false
@@ -36,9 +36,9 @@ function jsonPatchTextHasUaDeploymentNodeSelector(patchText) {
 
 /**
  * Чи один елемент `patches` відповідає abie nodeSelector для `mode`.
- * @param {unknown} p
- * @param {'ua'} mode
- * @returns {boolean}
+ * @param {unknown} p опис.
+ * @param {'ua'} mode опис.
+ * @returns {boolean} результат
  */
 function inlineKustomizationPatchMatchesAbieMode(p, mode) {
   if (p === null || typeof p !== 'object' || Array.isArray(p)) return false
@@ -55,9 +55,9 @@ function inlineKustomizationPatchMatchesAbieMode(p, mode) {
 
 /**
  * Чи документ Kustomization містить відповідний inline patch на Deployment.
- * @param {import('yaml').Document} doc
- * @param {'ua'} mode
- * @returns {boolean}
+ * @param {import('yaml').Document} doc опис.
+ * @param {'ua'} mode опис.
+ * @returns {boolean} результат
  */
 function kustomizationDocumentHasAbieDeploymentNodeSelectorPatch(doc, mode) {
   if (doc.errors.length > 0) return false
@@ -76,8 +76,8 @@ function kustomizationDocumentHasAbieDeploymentNodeSelectorPatch(doc, mode) {
 /**
  * Чи `kustomization.yaml` містить валідні inline patch для Deployment nodeSelector (ua).
  * @param {string} raw повний текст файла
- * @param {'ua'} mode
- * @returns {boolean}
+ * @param {'ua'} mode опис.
+ * @returns {boolean} результат
  */
 export function kustomizationHasAbieDeploymentNodeSelectorPatch(raw, mode) {
   const body = stripBom(raw)
@@ -100,8 +100,8 @@ export function kustomizationHasAbieDeploymentNodeSelectorPatch(raw, mode) {
 // ── HTTPRoute (ua) ────────────────────────────────────────────────────────
 
 /**
- * @param {unknown} p
- * @returns {string | null}
+ * @param {unknown} p опис.
+ * @returns {string | null} результат
  */
 function extractHttpRoutePatchString(p) {
   if (p === null || typeof p !== 'object' || Array.isArray(p)) return null
@@ -116,8 +116,8 @@ function extractHttpRoutePatchString(p) {
 
 /**
  * Збирає inline `patch`-рядки для HTTPRoute (непорожній `target.name`) з одного Kustomization-документа.
- * @param {import('yaml').Document} doc
- * @returns {string[]}
+ * @param {import('yaml').Document} doc опис.
+ * @returns {string[]} результат
  */
 function collectAbieHttpRoutePatchStringsFromKustomizationDoc(doc) {
   if (doc.errors.length > 0) return []
@@ -137,7 +137,7 @@ function collectAbieHttpRoutePatchStringsFromKustomizationDoc(doc) {
 /**
  * Збирає всі inline JSON6902-фрагменти HTTPRoute (непорожній `target.name`) у kustomization.yaml.
  * @param {string} raw повний текст файла
- * @returns {string}
+ * @returns {string} результат
  */
 export function getCombinedNginxRunPatchTextFromKustomization(raw) {
   const body = stripBom(raw)
@@ -162,8 +162,8 @@ export function getCombinedNginxRunPatchTextFromKustomization(raw) {
 /**
  * Рахує операції JSON6902 з `path: /spec/rules/.../backendRefs/.../namespace` і `value: ua[-…]`.
  * @param {string} combined сукупний текст patch
- * @param {'ua'} mode
- * @returns {number}
+ * @param {'ua'} mode опис.
+ * @returns {number} результат
  */
 function countAbieHttpRouteBackendRefNamespacePatchesInCombined(combined, mode) {
   if (mode !== 'ua') return 0
@@ -175,7 +175,7 @@ function countAbieHttpRouteBackendRefNamespacePatchesInCombined(combined, mode)
 /**
  * Перевіряє сукупний текст patch(ів) HTTPRoute на відповідність abie.mdc.
  * @param {string} combined сукупний текст patch
- * @param {'ua'} mode
+ * @param {'ua'} mode опис.
  * @param {string} [_fullKustomizationRaw] зберігається для API-сумісності, не використовується
  * @param {number} [sharedCrossNsBackendRefCount] кількість `auth-run-hl`/`file-link-hl` у base HTTPRoute
  * @returns {string | null} повідомлення про помилку або null
@@ -215,8 +215,8 @@ export function validateAbieNginxRunHttpRoutePatches(
 /**
  * Чи kustomization містить валідні patch для HTTPRoute (ua).
  * @param {string} raw повний текст kustomization.yaml
- * @param {'ua'} mode
- * @returns {boolean}
+ * @param {'ua'} mode опис.
+ * @returns {boolean} результат
  */
 export function kustomizationHasAbieNginxRunHttpRoutePatch(raw, mode) {
   const combined = getCombinedNginxRunPatchTextFromKustomization(raw)

package/rules/abie/utils/overlay-paths.mjs

@@ -17,7 +17,7 @@ const TRAILING_SLASH_RE = /\/$/u
 /**
  * Чи `rel` — це `…/ua/kustomization.yaml` (abie overlay).
  * @param {string} rel посі від кореня репозиторію
- * @returns {boolean}
+ * @returns {boolean} результат
  */
 export function isUaKustomizationPath(rel) {
   const norm = rel.replaceAll('\\', '/')
@@ -28,7 +28,7 @@ export function isUaKustomizationPath(rel) {
  * Каталог пакета (батько `k8s/`) для overlay `…/k8s/ua/kustomization.yaml`.
  * @param {string} root корінь репозиторію
  * @param {string} kustomizationAbs абсолютний шлях до ua kustomization
- * @returns {string | null}
+ * @returns {string | null} результат
  */
 export function abiePackageDirFromK8sOverlay(root, kustomizationAbs) {
   const rel = relative(root, kustomizationAbs).replaceAll('\\', '/') || kustomizationAbs
@@ -41,7 +41,7 @@ export function abiePackageDirFromK8sOverlay(root, kustomizationAbs) {
  * застосовується лише до Vite-пакетів.
  * @param {string} root корінь репозиторію
  * @param {string} kustomizationAbs абсолютний шлях до ua kustomization
- * @returns {boolean}
+ * @returns {boolean} результат
  */
 export function abieOverlayRequiresHttpRouteByVite(root, kustomizationAbs) {
   const pkg = abiePackageDirFromK8sOverlay(root, kustomizationAbs)
@@ -58,7 +58,7 @@ export function abieOverlayRequiresHttpRouteByVite(root, kustomizationAbs) {
  * @param {Set<string>} deploymentDirs абсолютні каталоги з Deployment
  * @param {string} root корінь репозиторію
  * @param {string} kustomizationAbs абсолютний шлях до ua kustomization
- * @returns {boolean}
+ * @returns {boolean} результат
  */
 export function abieOverlayK8sTreeHasDeployment(deploymentDirs, root, kustomizationAbs) {
   const pkg = abiePackageDirFromK8sOverlay(root, kustomizationAbs)
@@ -73,8 +73,8 @@ export function abieOverlayK8sTreeHasDeployment(deploymentDirs, root, kustomizat
 
 /**
  * Чи rel-шлях `…/k8s/base/…` (base-шар abie, не overlay).
- * @param {string} rel
- * @returns {boolean}
+ * @param {string} rel опис.
+ * @returns {boolean} результат
  */
 export function isAbieK8sBaseYamlPath(rel) {
   const norm = rel.replaceAll('\\', '/')
@@ -85,7 +85,7 @@ export function isAbieK8sBaseYamlPath(rel) {
  * Чи yaml належить до `<pkgRel>/k8s/**` поза `ua/` піддеревом (base-шар abie).
  * @param {string} relFromRoot шлях від кореня
  * @param {string} pkgRelFromRoot каталог пакета від кореня
- * @returns {boolean}
+ * @returns {boolean} результат
  */
 export function isK8sYamlInAbiePackageExcludingUaOverlay(relFromRoot, pkgRelFromRoot) {
   const normRel = relFromRoot.replaceAll('\\', '/')

package/rules/abie/utils/yaml.mjs

@@ -12,7 +12,7 @@ export const LINE_SPLIT_RE = /\r?\n/u
 /**
  * Прибирає BOM на початку файлу.
  * @param {string} s вміст
- * @returns {string}
+ * @returns {string} результат
  */
 export function stripBom(s) {
   return s.startsWith('') ? s.slice(1) : s
@@ -21,7 +21,7 @@ export function stripBom(s) {
 /**
  * Чи YAML-документ — це `kind: Deployment`.
  * @param {unknown} obj корінь YAML-документа
- * @returns {boolean}
+ * @returns {boolean} результат
  */
 export function isDeploymentDoc(obj) {
   return (
@@ -46,8 +46,8 @@ export const silentFail = _msg => {
  * викликає `failFn` і повертає `null`.
  * @param {string} abs абсолютний шлях
  * @param {string} rel відносний (для повідомлень)
- * @param {(msg: string) => void} failFn
- * @returns {Promise<import('yaml').Document[] | null>}
+ * @param {(msg: string) => void} failFn опис.
+ * @returns {Promise<import('yaml').Document[] | null>} результат
  */
 export async function readAndParseYamlDocs(abs, rel, failFn) {
   let raw

package/rules/hasura/js/internal_urls/check.mjs

@@ -143,7 +143,7 @@ async function checkEnvFile(relPath, expected, reporter) {
   const value = m[1].trim()
   const parsed = parseInternalHasuraEndpoint(value)
   if (!parsed.ok) {
-    const example = "https://<service>.<namespace>.svc.<cluster>.internal:<port>"
+    const example = 'https://<service>.<namespace>.svc.<cluster>.internal:<port>'
     fail(
       `${relPath}: HASURA_GRAPHQL_ENDPOINT="${value}" — потрібен внутрішній кластерний URL виду ${example} (hasura.mdc)`
     )

package/rules/js-bun-redis/js/imports/check.mjs

@@ -16,7 +16,11 @@ import { join, relative } from 'node:path'
 
 import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
-import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from '../../../../scripts/utils/redis-imports.mjs'
+import {
+  findRedisImportsInText,
+  isRedisScanSourceFile,
+  shouldSkipFileForRedisScan
+} from '../../../../scripts/utils/redis-imports.mjs'
 import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
 
 /**

package/rules/js-run/js/runtime/check.mjs

@@ -49,7 +49,10 @@ import {
   resolveConnDirFromPackageJson
 } from '../../../../scripts/utils/conn-imports-scan.mjs'
 import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
-import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../../../../scripts/utils/promise-settimeout-scan.mjs'
+import {
+  findPromiseSetTimeoutInText,
+  isPromiseSetTimeoutScanSourceFile
+} from '../../../../scripts/utils/promise-settimeout-scan.mjs'
 import { walkDir } from '../../../../scripts/utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from '../../../../scripts/utils/workspaces.mjs'
 

package/rules/k8s/policy/base_manifest/target.json

@@ -1,10 +1,6 @@
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
   "files": {
-    "walkGlob": [
-      "**/k8s/**/base/**/*.yaml",
-      "**/k8s/**/base/**/*.yml",
-      "!**/k8s/**/base/**/kustomization.yaml"
-    ]
+    "walkGlob": ["**/k8s/**/base/**/*.yaml", "**/k8s/**/base/**/*.yml", "!**/k8s/**/base/**/kustomization.yaml"]
   }
 }

package/rules/nginx-default-tpl/js/template/check.mjs

@@ -34,7 +34,9 @@ const GZIP_CMD_RE = /\bgzip\b/u
 const GZIP_EXTENSION_RE = /\*\.(?:js|css)/u
 
 /**
- * Збирає абсолютні шляхи до **default.conf.template** у репозиторії; шлях `tests/fixtures` не обходиться як проєктний шаблон.
+ * Збирає абсолютні шляхи до **default.conf.template** у репозиторії; будь-який сегмент
+ * `fixtures/` у шляху виключається — це тестові артефакти (як `tests/fixtures/` так і
+ * co-located `rules/<rule>/js/<concern>/fixtures/`).
  * @param {string} root корінь cwd
  * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<string[]>} відсортовані абсолютні шляхи до шаблонів
@@ -47,7 +49,7 @@ export async function findDefaultConfTemplatePaths(root, ignorePaths = []) {
     p => {
       if (basename(p) !== 'default.conf.template') return
       const rel = relative(root, p).replaceAll('\\', '/')
-      if (rel.includes('tests/fixtures/')) return
+      if (rel.split('/').includes('fixtures')) return
       out.push(p)
     },
     ignorePaths

package/rules/npm-module/js/package_structure/check.mjs

@@ -32,7 +32,12 @@ import { promisify } from 'node:util'
 
 import { parseSync } from 'oxc-parser'
 
-import { dynamicImportModule, langFromPath, requireCallModule, walkAstWithAncestors } from '../../../../scripts/utils/ast-scan-utils.mjs'
+import {
+  dynamicImportModule,
+  langFromPath,
+  requireCallModule,
+  walkAstWithAncestors
+} from '../../../../scripts/utils/ast-scan-utils.mjs'
 import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
 import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
 import { walkDir } from '../../../../scripts/utils/walkDir.mjs'

package/rules/rego/js/applies/check.mjs

@@ -45,9 +45,9 @@ export async function applies() {
 
 /**
  * Друкує короткий context-pass — самі полісі прогонить CLI через `policy/<name>/target.json`.
- * @returns {Promise<number>} 0 — все ок (фактичні порушення повертають policy-концерни)
+ * @returns {number} 0 — все ок (фактичні порушення повертають policy-концерни)
  */
-export async function check() {
+export function check() {
   const reporter = createCheckReporter()
   reporter.pass('Знайдено *.rego у дереві — перевіряємо канонічні конфіги rego.mdc')
   return reporter.getExitCode()

package/rules/tauri/js/tooling/check.mjs

@@ -70,7 +70,9 @@ export async function check() {
 
   const extPath = '.vscode/extensions.json'
   if (!existsSync(extPath)) {
-    fail(`${extPath} не існує — створи з recommendations "tauri-apps.tauri-vscode" і "rust-lang.rust-analyzer" (tauri.mdc)`)
+    fail(
+      `${extPath} не існує — створи з recommendations "tauri-apps.tauri-vscode" і "rust-lang.rust-analyzer" (tauri.mdc)`
+    )
     return reporter.getExitCode()
   }
   const violations = runConftestBatch({

package/scripts/auto-skills.mjs

@@ -52,7 +52,7 @@ function parseSkillAutoSpec(text) {
  * Сканує `npm/skills/<id>/auto.md`. Скіли без `auto.md` або з нерозпізнаним
  * вмістом не потрапляють у результат — їх можна вмикати лише вручну в конфізі.
  * @param {string} [skillsDir] override для тестів
- * @returns {Record<string, SkillAutoSpec>}
+ * @returns {Record<string, SkillAutoSpec>} мапа `skillId → spec`
  */
 export function discoverSkillAutoActivation(skillsDir = SKILLS_DIR) {
   if (!existsSync(skillsDir)) return {}
@@ -75,9 +75,7 @@ const SKILL_AUTO_ACTIVATION = discoverSkillAutoActivation()
  * Стабільний алфавітний порядок скілів з автоактивацією. Експортовано для зворотної
  * сумісності (попередня версія мала жорстко прописаний `AUTO_SKILL_ORDER`).
  */
-export const AUTO_SKILL_ORDER = Object.freeze(
-  Object.keys(SKILL_AUTO_ACTIVATION).toSorted((a, b) => a.localeCompare(b))
-)
+export const AUTO_SKILL_ORDER = Object.freeze(Object.keys(SKILL_AUTO_ACTIVATION).toSorted((a, b) => a.localeCompare(b)))
 
 /**
  * Похідна view на `SKILL_AUTO_ACTIVATION`: лише скіли з rule-залежностями.

package/scripts/utils/discover-checkable-rules.mjs

@@ -32,8 +32,8 @@ const TEST_SUFFIX = '.test.mjs'
 /**
  * @typedef {object} CheckableRule
  * @property {string} id ідентифікатор правила (імʼя каталогу `rules/<id>/`)
- * @property {JsConcern[]} jsConcerns
- * @property {PolicyConcern[]} policyConcerns
+ * @property {JsConcern[]} jsConcerns JS-концерни правила (алфавітно)
+ * @property {PolicyConcern[]} policyConcerns policy-концерни правила (алфавітно)
  */
 
 /**
@@ -52,7 +52,8 @@ async function listJsConcerns(jsDir) {
   for (const entry of topLevel) {
     if (!entry.isDirectory() || entry.name === 'utils' || entry.name.startsWith('.')) continue
     const concernDir = join(jsDir, entry.name)
-    const files = (await readdir(concernDir))
+    const dirContents = await readdir(concernDir)
+    const files = dirContents
       .filter(n => CHECK_FILENAME_RE.test(n) && !n.endsWith(TEST_SUFFIX))
       .toSorted((a, b) => a.localeCompare(b))
     if (files.length > 0) {

package/scripts/utils/run-rule.mjs

@@ -68,7 +68,8 @@ async function runPolicyConcern(bundledRulesDir, ruleId, concernName, walkCache)
   if (files.length === 0) {
     if (target.files.required && target.files.single) {
       const msg =
-        target.missingMessage ?? `${target.files.single} не існує — створи згідно ${ruleId}.mdc (${ruleId}.${concernName})`
+        target.missingMessage ??
+        `${target.files.single} не існує — створи згідно ${ruleId}.mdc (${ruleId}.${concernName})`
       reporter.fail(msg)
     }
     return reporter.getExitCode()
@@ -91,7 +92,7 @@ async function runPolicyConcern(bundledRulesDir, ruleId, concernName, walkCache)
 
 /**
  * Запускає одне правило: applies-гейт → JS-концерни → policy-концерни.
- * @param {import('./discover-checkable-rules.mjs').CheckableRule} rule
+ * @param {import('./discover-checkable-rules.mjs').CheckableRule} rule опис правила з discovery
  * @param {string} bundledRulesDir абсолютний шлях до `rules/`
  * @param {Map<string, Promise<string[]>>} walkCache shared cache (один на check-прогон)
  * @returns {Promise<number>} 0 — OK, 1 — є порушення в одному чи більше концернів

package/skills/abie-clean/SKILL.md

@@ -131,7 +131,6 @@ RUN bun install && bun vite build --mode "prod-$BRANCH" --base="$BASE"
 
 Те саме стосується `nginx`-конфігів (`server_name`, `proxy_pass` з ru-доменами), `*.sh`-скриптів та `package.json` scripts (`build:ru`, `deploy:ru`, `prod-ru` тощо).
 
-
 ## 5. Переклади
 
 Замінити переклад з російської на англійську в @nitra/tfm, @nitra/tf та @nitra/tfm-node. Якщо англійська вже є, то прибираємо російську:
@@ -175,8 +174,8 @@ const t = tf.bind({ tr })
 import { tf } from '@nitra/tfm'
 
 const tr = {
-  Так: { ru: 'Да' },
-  Ні: { ru: 'Нет' }
+Так: { ru: 'Да' },
+Ні: { ru: 'Нет' }
 }
 
 на
@@ -184,11 +183,10 @@ const tr = {
 import { tf } from '@nitra/tfm'
 
 const tr = {
-  Так: { ru: 'Yes' },
-  Ні: { ru: 'No' }
+Так: { ru: 'Yes' },
+Ні: { ru: 'No' }
 }
 
-
 ## 6. Після очистки
 
 - Переконайся, що `kustomization.yaml` у кожній директорії `k8s/` не посилається на видалені overlay або файли.

package/skills/adr-normalize/SKILL.md

@@ -51,7 +51,6 @@ description: >-
    Видалені файли — `delete`-операція. Нові файли `<slug>.md` — `rewrite`. Модифіковані clean-файли — `merge-into`.
 
 4. **Прийняти / відкотити:**
-
    - Прийняти все: `git add docs/adr/ && git commit -m "adr: normalize batch"`.
    - Відкотити конкретний файл: `git checkout -- docs/adr/<file>` (для `rewrite` цього мало — треба ще `git restore --staged` і `rm` нового).
    - Відкотити весь батч: `git checkout -- docs/adr/ && git clean -f docs/adr/` (видалить і untracked rewrite-результати).