@nitra/cursor 1.8.109 → 1.8.111

package/bin/n-cursor.js

@@ -221,6 +221,10 @@ async function readConfig(paths = {}) {
     if ('skills' in parsedConfig && !Array.isArray(parsedConfig.skills)) {
       throw new Error(`У ${CONFIG_FILE} поле "skills" має бути масивом рядків`)
     }
+    const { ignore } = parsedConfig
+    if (ignore !== undefined && (!Array.isArray(ignore) || ignore.some(p => typeof p !== 'string'))) {
+      throw new Error(`У ${CONFIG_FILE} поле "ignore" має бути масивом рядків (шляхів до директорій)`)
+    }
 
     const rootPkg = await readRootPackageJsonSafe()
     const disableRules = normalizeIdList(parsedConfig['disable-rules'])
@@ -571,10 +575,23 @@ async function buildClaudeSkillsSectionLines() {
  * Завдяки цьому Claude Code автоматично завантажує вміст кожного правила при старті.
  * @returns {Promise<void>}
  */
-async function syncClaudeMd() {
+/**
+ * @param {string[]} [ignore] директорії заборонені для редагування
+ */
+async function syncClaudeMd(ignore) {
   const lines = [`<!-- Цей файл генерується автоматично через \`npx ${PACKAGE_NAME}\`. Не редагуй вручну. -->`, '']
-  const mdcFiles = await listProjectRulesMdcFiles()
 
+  if (Array.isArray(ignore) && ignore.length > 0) {
+    lines.push('## Захищені директорії', '', 'Ніколи не змінюй, не видаляй і не створюй файли у цих директоріях:')
+    for (const dir of ignore) {
+      let d = dir
+      while (d.endsWith('/')) d = d.slice(0, -1)
+      lines.push(`- \`${d}/\``)
+    }
+    lines.push('')
+  }
+
+  const mdcFiles = await listProjectRulesMdcFiles()
   for (const mdcFile of mdcFiles) {
     lines.push(`@${RULES_DIR}/${mdcFile}`)
   }
@@ -971,7 +988,7 @@ async function runSync() {
 
   const config = await runSyncStep('❌ ', () => readConfig({ bundledMdcDir, bundledSkillsDir }))
 
-  const { rules, skills, version } = config
+  const { rules, skills, version, ignore } = config
   const bundledVer = await readBundledVersionAt(effectivePackageRoot)
   if (bundledVer) {
     const line =
@@ -1025,7 +1042,9 @@ async function runSync() {
   })
 
   await runSyncStep(`❌ Не вдалося оновити ${AGENTS_FILE}: `, () => syncAgentsMd(bundledAgentsTemplatePath))
-  await runSyncStep('❌ Не вдалося оновити CLAUDE.md: ', () => syncClaudeMd())
+  await runSyncStep('❌ Не вдалося оновити CLAUDE.md: ', () =>
+    syncClaudeMd(/** @type {string[] | undefined} */ (ignore))
+  )
 
   console.log(`\n✨ Готово: ${successCount} завантажено, ${failCount} з помилками\n`)
   if (failCount > 0) {

package/mdc/abie.mdc

@@ -4,7 +4,7 @@ alwaysApply: true
 version: '1.15'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`filelint-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**, а також заборона артефактів **Firebase Hosting** у корені репозиторію.
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -38,7 +38,7 @@ spec:
 
 За наявності **Deployment** під **k8s** і наявності **Vite** (**`vite.config.js`**, **`vite.config.mjs`** або **`vite.config.ts`** у каталозі пакета) у **`ua/kustomization.yaml`** та **`ru/kustomization.yaml`** цього пакета потрібні **inline JSON6902** у **`patches`**: **target** **`kind: HTTPRoute`**, **непорожній `name`** (як у маніфесті маршруту). Мають бути зміни **`/spec/hostnames`** (домени abie — у скрипті) та **`/spec/parentRefs/0/namespace`** (**`ua`** / **`ru`**). Для **ru** — анотація **`gwin.yandex.cloud/rules.http.upgradeTypes: websocket`** лише якщо в **тому ж** **`ru/kustomization.yaml`** є згадка **`HASURA_GRAPHQL_JWT_SECRET`** (типово patch на **ConfigMap** Hasura). Як обирати **`op`** (**add** / **replace** тощо) у patch — **k8s.mdc** (розділ про JSON patch у kustomization).
 
-### HTTPRoute: спільні сервіси **`auth-run-hl`**, **`filelint-hl`**
+### HTTPRoute: спільні сервіси **`auth-run-hl`**, **`file-link-hl`**
 
 Ці **Service** (headless **`-hl`**) живуть у **базовому** неймспейсі **`dev`**. У маніфесті **HTTPRoute** під **`k8s`** (шар без **`ua/`** та **`ru/`** — наприклад **`…/k8s/base/hr.yaml`**) для кожного **`backendRefs`** до такого сервісу явно вкажи **`namespace: dev`** і порт **8080**:
 
@@ -53,7 +53,7 @@ spec:
         - name: auth-run-hl
           namespace: dev
           port: 8080
-        - name: filelint-hl
+        - name: file-link-hl
           namespace: dev
           port: 8080
 ```
@@ -113,6 +113,148 @@ spec:
           gwin.yandex.cloud/rules.http.upgradeTypes: "websocket"
 ```
 
+## 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
+
+Обхідний варіант: nginx-sidecar у поді, що сам виконує rewrite і проксіює WebSocket до Hasura.
+
+**Умова:** в дереві `k8s` є Deployment з image `hasura/graphql-engine` (або `newName` на нього через `images:` у kustomization) **і** `ru/kustomization.yaml` містить `HASURA_GRAPHQL_JWT_SECRET` (patch на ConfigMap Hasura з JWT).
+
+### Що потрібно зробити
+
+**1. `ru/configmap-nginx.yaml`** — ConfigMap з nginx.conf:
+
+```yaml title="…/k8s/ru/configmap-nginx.yaml"
+# yaml-language-server: $schema=https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/v1.33.9-standalone-strict/configmap-v1.json
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: СЕРВІС-nginx
+  namespace: ru-NAMESPACE
+data:
+  nginx.conf: |
+    user nginx;
+    worker_processes auto;
+    error_log /dev/null;
+
+    events {
+        worker_connections 1024;
+    }
+
+    http {
+        access_log off;
+
+        map $http_upgrade $connection_upgrade {
+            default upgrade;
+            ''      close;
+        }
+
+        server {
+            listen 8081;
+            server_name _;
+
+            location /healthz {
+                add_header Content-Type text/plain;
+                return 200 "healthy";
+            }
+
+            # WebSocket: ALB не робить rewrite (URLRewrite + upgrade = bug YC ALB)
+            # nginx реврайтить /PREFIX/* → /* і проксіює до Hasura
+            location /PREFIX/ {
+                rewrite ^/PREFIX/(.*)$ /$1 break;
+                proxy_pass http://127.0.0.1:8080;
+                proxy_http_version 1.1;
+                proxy_set_header Upgrade $http_upgrade;
+                proxy_set_header Connection $connection_upgrade;
+                proxy_set_header Host $host;
+            }
+
+            # HTTP: ALB вже зробив prefix_rewrite → /, nginx просто проксіює
+            location / {
+                proxy_pass http://127.0.0.1:8080;
+                proxy_http_version 1.1;
+                proxy_set_header Upgrade $http_upgrade;
+                proxy_set_header Connection $connection_upgrade;
+                proxy_set_header Host $host;
+            }
+        }
+    }
+```
+
+**2. `ru/kustomization.yaml`** — додати до `resources` та чотири patch-блоки:
+
+```yaml title="…/k8s/ru/kustomization.yaml (фрагмент)"
+resources:
+  - ../base
+  - configmap-nginx.yaml   # ← додати
+
+patches:
+  # Headless Service: замінити ports на два іменованих (hasura:8080 + proxy:8081)
+  - target:
+      kind: Service
+      name: СЕРВІС-hl
+    patch: |-
+      - op: replace
+        path: /spec/type
+        value: NodePort
+      - op: remove
+        path: /spec/clusterIP
+      - op: replace
+        path: /spec/ports
+        value:
+          - name: hasura
+            protocol: TCP
+            port: 8080
+          - name: proxy
+            protocol: TCP
+            port: 8081
+
+  # Deployment: додати nginx-sidecar контейнер та volume
+  - target:
+      kind: Deployment
+      name: СЕРВІС
+    patch: |-
+      - op: add
+        path: /spec/template/spec/containers/-
+        value:
+          name: СЕРВІС-p
+          image: nginx:1.27-alpine
+          ports:
+            - containerPort: 8081
+              protocol: TCP
+          volumeMounts:
+            - name: nginx-conf
+              mountPath: /etc/nginx/nginx.conf
+              subPath: nginx.conf
+          resources: {}
+      - op: add
+        path: /spec/template/spec/volumes
+        value:
+          - name: nginx-conf
+            configMap:
+              name: СЕРВІС-nginx
+
+  # HTTPRoute: прибрати URLRewrite-фільтри з PathPrefix-правила,
+  # направити трафік на nginx:8081, видалити мертве WebSocket-правило
+  - target:
+      kind: HTTPRoute
+      name: СЕРВІС
+    patch: |-
+      - op: remove
+        path: /spec/rules/INDEX_PATHPREFIX/filters
+      - op: replace
+        path: /spec/rules/INDEX_PATHPREFIX/backendRefs/0/port
+        value: 8081
+      - op: remove
+        path: /spec/rules/INDEX_WEBSOCKET
+```
+
+> `INDEX_PATHPREFIX` і `INDEX_WEBSOCKET` — індекси правил у `base/hr.yaml`. Після видалення filters ALB більше не додає `prefix_rewrite`, тому nginx-sidecar отримує оригінальний шлях і сам виконує rewrite.
+
+**Примітка щодо Service:** якщо в base у `-hl` Service два порти задаються вперше, `spec.ports[*].name` є обов'язковим — без нього `kubectl apply` поверне помилку `Required value`.
+
 ## k8s: overlay **ru** і **Service** (у т. ч. headless → NodePort)
 
 Для кожного **Service** в YAML під **`…/k8s/…`**, де шлях файлу **не** містить **`k8s/ua/`** чи **`k8s/ru/`** (маніфести base / спільного шару; у т. ч. **headless** з **`spec.clusterIP: None`** і **`-hl`**), якщо ще не **`spec.type: NodePort`** / **`LoadBalancer`** / **`ExternalName`**, у **`k8s/ru/kustomization.yaml`** того ж пакета (overlay **ru**) додай **inline** **JSON6902** у **`patches`**: **`target.kind: Service`**, **`target.name`** як у маніфеста, **`path: /spec/type`**, **`value: NodePort`**. Якщо в base було **`spec.clusterIP: None`**, у тому ж **patch** додай **`op: remove`** для **`/spec/clusterIP`**. Якщо в base **явно** задано **`spec.clusterIPs`** (зокрема **`['None']`**), додай **`op: remove`** і для **`/spec/clusterIPs`** — інакше **API** може відхилити **NodePort** (*`spec.clusterIPs[0]: Invalid value: "None"`*). **Не** додавай **`remove`** на **`/spec/clusterIPs`**, якщо ключа **немає** в base: **`kubectl kustomize`** тоді падає (*Unable to remove nonexistent key*). Якщо в base лише **`clusterIP: None`**, а помилка лишається після **`kubectl apply -k`** (злиття з уже існуючим **Service** у кластері), тимчасово **видали** **`Service`** у **`ru`** і застосуй знову, або додай у base поле **`clusterIPs`**, щоб **`remove`** у patch був валідний для **kustomize**. Деталі — **`check-abie.mjs`**.

package/package.json

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

package/schemas/n-cursor.json

@@ -43,6 +43,14 @@
         "minLength": 1
       }
     },
+    "ignore": {
+      "type": "array",
+      "description": "Директорії, у яких заборонено будь-які модифікації файлів (AI не редагує, не видаляє, не створює файли). Шляхи відносно кореня репозиторію. Наприклад: [\"packages/vendor\", \"packages/generated\"].",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
     "version": {
       "type": "string",
       "description": "Застаріле поле, ігнорується CLI. Правила завжди копіюються з каталогу mdc/ установленого пакету (node_modules або кеш npx); змініть версію через оновлення залежності."

package/scripts/check-abie.mjs

@@ -29,7 +29,7 @@
  * — тоді в **`ua`/`ru` kustomization** потрібен patch на **`kind: HTTPRoute`**, **непорожній `target.name`**: **`/spec/hostnames`**
  * (домени abie.mdc), **`/spec/parentRefs/0/namespace`** (**ua** / **ru**); для **ru** — **`gwin.yandex.cloud/rules.http.upgradeTypes: websocket`**,
  * якщо в тому ж **`kustomization.yaml`** згадується **`HASURA_GRAPHQL_JWT_SECRET`** (Hasura + JWT).
- * **Спільні бекенди (`auth-run-hl`, `filelint-hl`):** у **HTTPRoute** під **`k8s`** поза overlay **ua** та **ru** (шлях не містить **`k8s/ua/`** чи **`k8s/ru/`**) кожен такий **`backendRefs`** має **`namespace: dev`** і порт **8080**;
+ * **Спільні бекенди (`auth-run-hl`, `file-link-hl`):** у **HTTPRoute** під **`k8s`** поза overlay **ua** та **ru** (шлях не містить **`k8s/ua/`** чи **`k8s/ru/`**) кожен такий **`backendRefs`** має **`namespace: dev`** і порт **8080**;
  * у patch overlay **ua** та **ru** — по одному **JSON6902** на **`/spec/rules/…/backendRefs/…/namespace`** з **`value`**: **ua** або **ru** (кількість patch-ів = кількість таких **`backendRefs`** у пакеті).
  * Вибір **`op`** — **k8s.mdc**.
  *
@@ -56,7 +56,7 @@ const HASURA_JWT_SECRET_IN_KUSTOMIZATION = 'HASURA_GRAPHQL_JWT_SECRET'
  * Спільні **Service** (**`-hl`**) у **dev**: у base-**HTTPRoute** обов'язково **`namespace: dev`**, у overlay — patch **`…/backendRefs/…/namespace`** (abie.mdc).
  * Експорт для споживачів / тестів.
  */
-export const ABIE_SHARED_CROSS_NS_BACKEND_NAMES = Object.freeze(['auth-run-hl', 'filelint-hl'])
+export const ABIE_SHARED_CROSS_NS_BACKEND_NAMES = Object.freeze(['auth-run-hl', 'file-link-hl'])
 
 const ABIE_SHARED_CROSS_NS_BACKEND_SET = new Set(ABIE_SHARED_CROSS_NS_BACKEND_NAMES)
 
@@ -985,7 +985,7 @@ function checkSharedBackendRef(br, rel, errors) {
 }
 
 /**
- * З HTTPRoute-документа рахує **`backendRefs`** до **`auth-run-hl`** / **`filelint-hl`** і порушення **`namespace: dev`**.
+ * З HTTPRoute-документа рахує **`backendRefs`** до **`auth-run-hl`** / **`file-link-hl`** і порушення **`namespace: dev`**.
  * @param {unknown} obj корінь YAML
  * @param {string} rel відносний шлях (повідомлення)
  * @returns {{ refCount: number, errors: string[] }} кількість посилань і список порушень
@@ -1015,7 +1015,7 @@ function httpRouteDocSharedCrossNsBackendStats(obj, rel) {
 }
 
 /**
- * З YAML під **k8s** пакета (без overlay **ua** та **ru**) збирає кількість **`backendRefs`** до **`auth-run-hl`** і **`filelint-hl`** і порушення **`namespace: dev`**.
+ * З YAML під **k8s** пакета (без overlay **ua** та **ru**) збирає кількість **`backendRefs`** до **`auth-run-hl`** і **`file-link-hl`** і порушення **`namespace: dev`**.
  * @param {string} root корінь репозиторію
  * @param {string} pkgAbs абсолютний шлях до каталогу пакета
  * @param {string[]} yamlFilesAbs усі **yaml** під **k8s** (як **findK8sYamlFiles**)
@@ -1135,7 +1135,7 @@ export function getCombinedNginxRunPatchTextFromKustomization(raw) {
  * @param {string} combined текст одного або кількох inline **patch**, розділених символом нового рядка
  * @param {'ua' | 'ru'} mode **ua** або **ru**
  * @param {string} [fullKustomizationRaw] повний текст **kustomization.yaml** — для **ru** визначає, чи потрібна анотація **gwin…websocket** (лише якщо є **`HASURA_GRAPHQL_JWT_SECRET`**)
- * @param {number} [sharedCrossNsBackendRefCount] скільки **`backendRefs`** до **`auth-run-hl`** і **`filelint-hl`** у base **HTTPRoute** пакета — стільки ж patch-ів **`…/backendRefs/…/namespace`** з **`value`** overlay
+ * @param {number} [sharedCrossNsBackendRefCount] скільки **`backendRefs`** до **`auth-run-hl`** і **`file-link-hl`** у base **HTTPRoute** пакета — стільки ж patch-ів **`…/backendRefs/…/namespace`** з **`value`** overlay
  * @returns {string | null} повідомлення про помилку або **null**
  */
 export function validateAbieNginxRunHttpRoutePatches(
@@ -1173,7 +1173,7 @@ export function validateAbieNginxRunHttpRoutePatches(
   if (sharedCount > 0) {
     const patchHits = countAbieHttpRouteBackendRefNamespacePatchesInCombined(combined, mode)
     if (patchHits < sharedCount) {
-      return `HTTPRoute: для backendRefs до спільних сервісів auth-run-hl, filelint-hl очікується ${sharedCount} JSON6902 patch(ів) з path /spec/rules/…/backendRefs/…/namespace та value ${mode} (зараз ${patchHits}) — abie.mdc`
+      return `HTTPRoute: для backendRefs до спільних сервісів auth-run-hl, file-link-hl очікується ${sharedCount} JSON6902 patch(ів) з path /spec/rules/…/backendRefs/…/namespace та value ${mode} (зараз ${patchHits}) — abie.mdc`
     }
   }
   return null

package/scripts/check-bun.mjs

@@ -21,8 +21,9 @@ import { readFile } from 'node:fs/promises'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 
 const OXFMT_END_RE = /&&[ \t]+oxfmt[ \t]+\.[ \t]*$/
-const HOISTED_LINKER_RE = /^\s*linker\s*=\s*"hoisted"\s*$/m
-const INSTALL_SECTION_RE = /^\s*\[install\]\s*$/m
+/** Пробіли/таби без `\s` (уникаємо super-linear backtracking у sonarjs/slow-regex). */
+const HOISTED_LINKER_RE = /^[ \t]*linker[ \t]*=[ \t]*"hoisted"[ \t]*$/m
+const INSTALL_SECTION_RE = /^[ \t]*\[install\][ \t]*$/m
 
 /**
  * Перевіряє `bunfig.toml` на секцію `[install]` з `linker = "hoisted"`.

package/scripts/check-js-lint.mjs

@@ -183,6 +183,42 @@ function checkPackageJsonTypeModule(label, pkg, passFn, failFn) {
   }
 }
 
+/**
+ * `"type": "module"` у кожного workspace з package.json.
+ * @param {unknown[]} workspaces поле workspaces з package.json
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+async function checkWorkspacePackagesTypeModule(workspaces, passFn, failFn) {
+  for (const ws of workspaces) {
+    const wsPkgPath = `${ws}/package.json`
+    if (existsSync(wsPkgPath)) {
+      const wsPkg = JSON.parse(await readFile(wsPkgPath, 'utf8'))
+      checkPackageJsonTypeModule(wsPkgPath, wsPkg, passFn, failFn)
+    }
+  }
+}
+
+/**
+ * engines.node >= 24.
+ * @param {{ engines?: { node?: string } }} pkg розпарсений package.json
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+function checkEnginesNode(pkg, passFn, failFn) {
+  const nodeEngine = pkg.engines?.node
+  if (nodeEngine) {
+    const firstNumeric = String(nodeEngine).split(NON_DIGITS_RE).find(Boolean)
+    if (firstNumeric && Number(firstNumeric) >= 24) {
+      passFn(`engines.node: "${nodeEngine}"`)
+    } else {
+      failFn(`engines.node: "${nodeEngine}" — має бути >=24`)
+    }
+  } else {
+    failFn('package.json не містить engines.node — додай: "engines": { "node": ">=24" }')
+  }
+}
+
 /**
  * Перевіряє package.json на lint-js, prettier, eslint-config, engines.node.
  * @param {(msg: string) => void} passFn callback при успішній перевірці
@@ -195,13 +231,7 @@ async function checkPackageJsonJsLint(passFn, failFn) {
   checkPackageJsonTypeModule('package.json', pkg, passFn, failFn)
 
   const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : []
-  for (const ws of workspaces) {
-    const wsPkgPath = `${ws}/package.json`
-    if (existsSync(wsPkgPath)) {
-      const wsPkg = JSON.parse(await readFile(wsPkgPath, 'utf8'))
-      checkPackageJsonTypeModule(wsPkgPath, wsPkg, passFn, failFn)
-    }
-  }
+  await checkWorkspacePackagesTypeModule(workspaces, passFn, failFn)
 
   const lintJs = pkg.scripts?.['lint-js']
   if (lintJs) {
@@ -218,18 +248,7 @@ async function checkPackageJsonJsLint(passFn, failFn) {
   }
 
   checkPackageJsonLintDeps(pkg, passFn, failFn)
-
-  const nodeEngine = pkg.engines?.node
-  if (nodeEngine) {
-    const firstNumeric = String(nodeEngine).split(NON_DIGITS_RE).find(Boolean)
-    if (firstNumeric && Number(firstNumeric) >= 24) {
-      passFn(`engines.node: "${nodeEngine}"`)
-    } else {
-      failFn(`engines.node: "${nodeEngine}" — має бути >=24`)
-    }
-  } else {
-    failFn('package.json не містить engines.node — додай: "engines": { "node": ">=24" }')
-  }
+  checkEnginesNode(pkg, passFn, failFn)
 }
 
 /**

package/scripts/check-k8s.mjs

@@ -2336,20 +2336,15 @@ function hasuraRuleIsWebsocket(rule, qlPath) {
  * @returns {{ prefix: string, startIndex: number } | null} виявлений префікс і позиція правила 1 або null
  */
 function findHasuraCanonStart(rules) {
-  for (let i = 0; i < rules.length; i++) {
-    const r = asPlainRecord(rules[i])
+  for (const [i, rule] of rules.entries()) {
+    const r = asPlainRecord(rule)
     const matches = r === null ? null : r.matches
     if (!Array.isArray(matches) || matches.length !== 1) {
       // наступне правило
     } else {
       const m = asPlainRecord(matches[0])
       const p = m === null || m.headers !== undefined ? null : asPlainRecord(m.path)
-      if (
-        p !== null &&
-        p.type === 'Exact' &&
-        typeof p.value === 'string' &&
-        p.value.endsWith('/ql')
-      ) {
+      if (p !== null && p.type === 'Exact' && typeof p.value === 'string' && p.value.endsWith('/ql')) {
         return { prefix: p.value.slice(0, -'/ql'.length), startIndex: i }
       }
     }
@@ -2641,7 +2636,7 @@ async function indexOneK8sYamlForHasuraCanon(abs, hasuraByDir, httpRoutes) {
  * Якщо документ — Hasura-Deployment із непорожнім `metadata.name`, додає ім'я до індексу за каталогом.
  * @param {Record<string, unknown>} rec корінь YAML-документа
  * @param {string} dir абсолютний шлях до каталогу файлу
- * @param {Map<string, Set<string>>} hasuraByDir індекс Hasura Deployment-ів за каталогом (мутується)
+ * @param {Map<string, Set<string>>} hasuraByDir індекс Hasura Deployment-ів за каталогом (під час обходу в нього додаються імена)
  * @returns {void}
  */
 function recordHasuraDeploymentName(rec, dir, hasuraByDir) {
@@ -2677,7 +2672,9 @@ async function validateHasuraHttpRouteCanon(root, yamlFiles, fail) {
       const v = httpRouteHasuraCanonViolation(hr.obj)
       if (v !== null) {
         const rel = (relative(root, hr.abs) || hr.abs).replaceAll('\\', '/')
-        fail(`${rel}: HTTPRoute «${name}» (документ ${hr.docIndex}; прив'язано до Hasura-Deployment у тому ж каталозі): ${v}`)
+        fail(
+          `${rel}: HTTPRoute «${name}» (документ ${hr.docIndex}; прив'язано до Hasura-Deployment у тому ж каталозі): ${v}`
+        )
       }
     }
   }

package/scripts/utils/bunyan-imports.mjs

@@ -4,7 +4,7 @@
  *
  * Семантика береться з **oxc-parser** (`module.staticImports`) — без regex по тілу файлу.
  * Додатково по AST програми ловимо `require('@nitra/bunyan')` і динамічний `import('@nitra/bunyan')`,
- * щоб правило працювало й у CommonJS/інлайн-завантаженні.
+ * щоб правило працювало й у CommonJS і при динамічному import у межах одного файлу.
  *
  * Сканер не вимагає, щоб файл компілювався: при синтаксичних помилках повертається порожній
  * результат — спочатку треба полагодити синтаксис, потім перезапустити перевірку.
@@ -61,7 +61,7 @@ function normalizeSnippet(s) {
 
 /**
  * Перевіряє, чи це виклик `require('<module>')` з рядковим аргументом.
- * @param {any} node вузол AST
+ * @param {Record<string, unknown> | null | undefined} node вузол AST
  * @returns {string | null} ім'я модуля з аргументу, інакше `null`
  */
 function requireCallModule(node) {
@@ -75,7 +75,7 @@ function requireCallModule(node) {
 
 /**
  * Перевіряє, чи це динамічний `import('<module>')` з рядковим аргументом.
- * @param {any} node вузол AST
+ * @param {Record<string, unknown> | null | undefined} node вузол AST
  * @returns {string | null} ім'я модуля, інакше `null`
  */
 function dynamicImportModule(node) {
@@ -87,8 +87,8 @@ function dynamicImportModule(node) {
 
 /**
  * Простий рекурсивний обхід AST: заходимо в усі об'єкти/масиви, щоб знайти require/import-вузли.
- * @param {any} node корінь або під-вузол AST
- * @param {(n: any) => void} visit виклик для кожного об'єкта-вузла
+ * @param {unknown} node корінь або під-вузол AST
+ * @param {(n: unknown) => void} visit виклик для кожного об'єкта-вузла
  * @returns {void}
  */
 function walkAst(node, visit) {
@@ -101,9 +101,10 @@ function walkAst(node, visit) {
     visit(node)
   }
   for (const key of Object.keys(node)) {
-    if (key === 'parent') continue
-    const v = node[key]
-    if (v && typeof v === 'object') walkAst(v, visit)
+    if (key !== 'parent') {
+      const v = node[key]
+      if (v && typeof v === 'object') walkAst(v, visit)
+    }
   }
 }