@nitra/cursor 1.8.108 → 1.8.110

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
 ```

package/mdc/bun.mdc

@@ -1,7 +1,7 @@
 ---
 description: Bun як єдиний package manager у монорепо
 alwaysApply: true
-version: '1.6'
+version: '1.7'
 ---
 
 Проект використовує тільки Bun для керування залежностями та запуску скриптів.
@@ -44,6 +44,13 @@ Lockfile у репозиторії: `bun.lock`.
 Не створювати `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`.
 Видалити якщо вони є. Видалити .yarn та .yarnrc.yml якщо вони є.
 
+У корені репозиторію має бути **`bunfig.toml`** з **hoisted** лінкером (пласке `node_modules`, сумісне з інструментами, які не розуміють ізольований layout Bun):
+
+```toml title="bunfig.toml"
+[install]
+linker = "hoisted"
+```
+
 Для Bun monorepo:
 
 - Встановлювати залежності у відповідному пакеті, а не в корені без потреби.

package/mdc/js-lint.mdc

@@ -1,7 +1,7 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.13'
+version: '1.14'
 ---
 
 **oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config` мінімум `^3.5.0`** (з ним транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd не додавай без потреби монорепо.
@@ -16,8 +16,11 @@ version: '1.13'
 }
 ```
 
+У кожному **`package.json`** проєкту (корінь і всі workspace-пакети) має бути **`"type": "module"`** — весь код у ESM.
+
 ```json title="package.json"
 {
+  "type": "module",
   "scripts": {
     "lint-js": "bunx oxlint --fix && bunx eslint --fix . && bunx jscpd ."
   },

package/package.json

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

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

@@ -1,8 +1,9 @@
 /**
  * Перевіряє відповідність репозиторію правилам Bun (bun.mdc).
  *
- * Очікує наявність `bun.lock`, забороняє lockfile та артефакти yarn/pnpm, директорію `.yarn`
- * і поле `packageManager` у кореневому `package.json`.
+ * Очікує наявність `bun.lock`, `bunfig.toml` з `linker = "hoisted"` у секції `[install]`,
+ * забороняє lockfile та артефакти yarn/pnpm, директорію `.yarn` і поле `packageManager`
+ * у кореневому `package.json`.
  *
  * У кореневому `package.json` не має бути поля **`dependencies`**; у **`devDependencies`** дозволені лише
  * пакети **`@nitra/*`** (наприклад **`@nitra/cspell-dict`**, **`@nitra/eslint-config`**).
@@ -20,6 +21,31 @@ import { readFile } from 'node:fs/promises'
 import { createCheckReporter } from './utils/check-reporter.mjs'
 
 const OXFMT_END_RE = /&&[ \t]+oxfmt[ \t]+\.[ \t]*$/
+/** Пробіли/таби без `\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"`.
+ * @param {{ pass: (msg: string) => void, fail: (msg: string) => void }} reporter репортер
+ */
+async function checkBunfigHoisted(reporter) {
+  const { pass, fail } = reporter
+  if (!existsSync('bunfig.toml')) {
+    fail('Відсутній bunfig.toml — створи з [install] linker = "hoisted" (bun.mdc)')
+    return
+  }
+  const content = await readFile('bunfig.toml', 'utf8')
+  if (!INSTALL_SECTION_RE.test(content)) {
+    fail('bunfig.toml: відсутня секція [install] (bun.mdc)')
+    return
+  }
+  if (HOISTED_LINKER_RE.test(content)) {
+    pass('bunfig.toml: [install] linker = "hoisted"')
+  } else {
+    fail('bunfig.toml: у секції [install] має бути linker = "hoisted" (bun.mdc)')
+  }
+}
 
 /**
  * Чи ім'я пакета дозволене в кореневих `devDependencies` за bun.mdc (лише **`@nitra/*`**).
@@ -162,6 +188,8 @@ export async function check() {
     fail('Відсутній bun.lock — запусти bun i')
   }
 
+  await checkBunfigHoisted(reporter)
+
   const cursorRules = await loadNCursorRules()
 
   if (!existsSync('package.json')) {

package/scripts/check-js-lint.mjs

@@ -5,7 +5,8 @@
  * `.oxlintrc.json` з `jsPlugins` (`@e18e/eslint-plugin`) і правилом `e18e/prefer-includes: error`,
  * `@nitra/eslint-config` у devDependencies мінімум **3.5.0** (транзитивний `@e18e/eslint-plugin` для oxlint), `.jscpd.json`
  * (gitignore, exitCode, reporters, minLines), workflow `lint-js.yml` (checkout@v6, setup-bun-deps,
- * bunx без --fix), без prettier, `engines.node` >= 24. Дубль перевірки JS у `lint.yml` — заборонено.
+ * bunx без --fix), без prettier, `engines.node` >= 24, `"type": "module"` у кореневому
+ * і всіх workspace `package.json`. Дубль перевірки JS у `lint.yml` — заборонено.
  */
 import { existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
@@ -167,6 +168,57 @@ function checkPackageJsonLintDeps(pkg, passFn, failFn) {
   }
 }
 
+/**
+ * Перевіряє, що package.json має `"type": "module"`.
+ * @param {string} label шлях або назва пакета для повідомлень
+ * @param {{ type?: string }} pkg parsed package.json
+ * @param {(msg: string) => void} passFn callback при успішній перевірці
+ * @param {(msg: string) => void} failFn callback при помилці
+ */
+function checkPackageJsonTypeModule(label, pkg, passFn, failFn) {
+  if (pkg.type === 'module') {
+    passFn(`${label}: "type": "module"`)
+  } else {
+    failFn(`${label}: має містити "type": "module" (js-lint.mdc)`)
+  }
+}
+
+/**
+ * `"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 при успішній перевірці
@@ -176,6 +228,11 @@ async function checkPackageJsonJsLint(passFn, failFn) {
   if (!existsSync('package.json')) return
   const pkg = JSON.parse(await readFile('package.json', 'utf8'))
 
+  checkPackageJsonTypeModule('package.json', pkg, passFn, failFn)
+
+  const workspaces = Array.isArray(pkg.workspaces) ? pkg.workspaces : []
+  await checkWorkspacePackagesTypeModule(workspaces, passFn, failFn)
+
   const lintJs = pkg.scripts?.['lint-js']
   if (lintJs) {
     passFn('package.json містить скрипт lint-js')
@@ -191,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,8 +2336,8 @@ 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) {
       // наступне правило

package/scripts/utils/bunyan-imports.mjs

@@ -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)
+    }
   }
 }