@nitra/cursor 1.8.105 → 1.8.108

package/bin/auto-rules.md

@@ -4,7 +4,7 @@
 
 ## Правила, які автоматично додається до .n-cursor.json
 
-abie - якщо в кореневому package.json в секції "repository" присутній текст "https://github.com/abinbevefes/**/"
+abie - якщо в кореневому package.json в секції "repository" присутній текст "<https://github.com/abinbevefes/**/>"
 
 bun - якщо в корені проекту є package.json
 
@@ -32,7 +32,7 @@ vue - якщо присутній хоч один vue файл
 
 ## Скіли, які автоматично додається до .n-cursor.json
 
-abie-kustomize - якщо в кореневому package.json в секції "repository" присутній текст "https://github.com/abinbevefes/**/"
+abie-kustomize - якщо в кореневому package.json в секції "repository" присутній текст "<https://github.com/abinbevefes/**/>"
 
 fix - завжди
 

package/bin/n-cursor.js

@@ -75,12 +75,7 @@ const NEWLINE_RE = /\r?\n/
 const LEADING_SPACES_RE = /^\s+/
 
 /** Ключі `.n-cursor.json`, де значення — масиви id; після запуску CLI сортуються за алфавітом */
-const CONFIG_SORTED_ARRAY_KEYS = /** @type {const} */ ([
-  'rules',
-  'skills',
-  'disable-rules',
-  'disable-skills'
-])
+const CONFIG_SORTED_ARRAY_KEYS = /** @type {const} */ (['rules', 'skills', 'disable-rules', 'disable-skills'])
 
 /**
  * Сортує масиви id у конфігу за алфавітом (`localeCompare`), щоб порядок у файлі був стабільним після синку.
@@ -90,14 +85,10 @@ const CONFIG_SORTED_ARRAY_KEYS = /** @type {const} */ ([
 function sortConfigIdArrays(config) {
   const out = { ...config }
   for (const key of CONFIG_SORTED_ARRAY_KEYS) {
-    if (!(key in out)) {
-      continue
-    }
     const v = out[key]
-    if (!Array.isArray(v)) {
-      continue
+    if (key in out && Array.isArray(v)) {
+      out[key] = v.map(String).toSorted((a, b) => a.localeCompare(b))
     }
-    out[key] = v.map(x => String(x)).toSorted((a, b) => a.localeCompare(b))
   }
   return out
 }
@@ -970,9 +961,8 @@ async function runSync() {
   console.log(`\n🔧 ${PACKAGE_NAME} — завантаження cursor-правил\n`)
 
   const projectRoot = cwd()
-  const effectivePackageRoot = await runSyncStep(
-    `❌ Не вдалося оновити ${PACKAGE_NAME} або виконати bun i: `,
-    () => upgradeNitraCursorToLatestAndBunInstall(projectRoot, BUNDLED_PACKAGE_ROOT)
+  const effectivePackageRoot = await runSyncStep(`❌ Не вдалося оновити ${PACKAGE_NAME} або виконати bun i: `, () =>
+    upgradeNitraCursorToLatestAndBunInstall(projectRoot, BUNDLED_PACKAGE_ROOT)
   )
 
   const bundledMdcDir = join(effectivePackageRoot, 'mdc')

package/mdc/js-pino.mdc

@@ -1,11 +1,11 @@
 ---
 description: Використання @nitra/pino
 alwaysApply: true
-version: '1.0'
+version: '1.1'
 ---
 
 Проект використовує @nitra/pino для логування.
-Якщо в проекті присутній @nitra/bunyan, то він повинен бути замінений на @nitra/pino.
+Якщо в проекті присутній @nitra/bunyan, то він повинен бути замінений на @nitra/pino — як у `package.json`, так і в коді: усі `import` / `require` / динамічні `import()` з `@nitra/bunyan` (і застарілого `bunyan`) треба замінити на `@nitra/pino` і за потреби адаптувати виклики під його API.
 
 В **/k8s/base/configmap.yaml повинен бути заданий OTEL_RESOURCE_ATTRIBUTES: 'service.name=<project_name>,service.namespace=<project_namespace>'
 а в директоріях з kustomize повинні бути перевизначені значення OTEL_RESOURCE_ATTRIBUTES і в них service.namespace повинен відповідати namespace, в якому знаходиться дана директорія.

package/mdc/k8s.mdc

@@ -110,7 +110,16 @@ resources: {}
 
 ### HTTPRoute для Deployment з `hasura/graphql-engine`
 
-Якщо для такого **Deployment** описано **`HTTPRoute`**, **`spec.rules`** мають відповідати канону нижче: редірект **`/ql`** та **`/ql/`** на **`/ql/console`** (**`302`**), правило з **`PathPrefix` `/ql`**, **`URLRewrite`** префікса на **`/`**, окреме правило для **WebSocket** (**`Upgrade: websocket`**) з **`RequestHeaderModifier`** (прибрати **`Authorization`** — авторизація для WebSocket іде всередині messages), далі **`PathPrefix` `/`** на той самий backend.
+**Прив'язка:** **check k8s** вважає **HTTPRoute** Hasura-маршрутом, якщо в **тому самому каталозі** є **`Deployment`** з образом **`hasura/graphql-engine`**, а його **`metadata.name`** збігається з **`metadata.name`** цього **`HTTPRoute`**. Саме за цією конвенцією скрипт шукає пари для звірки канону.
+
+**Префікс параметризовано:** **`<prefix>`** — рядок перед **`/ql`** у першому Hasura-правилі (**`Exact <prefix>/ql`**). Може бути порожнім (**`<prefix>`** = **``**, шлях **`/ql`**) або непорожнім (наприклад **`<prefix>`** = **`/notify`**, шлях **`/notify/ql`**). Усі інші Hasura-правила цього **HTTPRoute** мають містити той самий **`<prefix>`**.
+
+**Канон — 4 правила у цьому порядку** (додаткові правила поверх канону дозволені — вони просто ігноруються під час зіставлення):
+
+1. **`Exact <prefix>/ql`** → **`RequestRedirect`** **`ReplaceFullPath <prefix>/ql/console`** **`statusCode: 302`**.
+2. **`Exact <prefix>/ql/`** → те саме (редирект на **`<prefix>/ql/console`** 302).
+3. **`PathPrefix <prefix>/ql`** → **`URLRewrite`** **`ReplacePrefixMatch /`**, один **`backendRef`** на headless **Service** (**`-hl`**).
+4. **WebSocket:** **`PathPrefix <prefix>/ql`** + header **`Upgrade: websocket`** → **`URLRewrite`** **`ReplacePrefixMatch /`** + **`RequestHeaderModifier`** **`remove: [Authorization]`** (авторизація для WebSocket іде всередині messages). Той самий **`backendRef`**.
 
 **`parentRefs`**, **`hostnames`**, **`metadata.namespace`** / **`name`** підлаштуй під середовище. У **`backendRefs.name`** вказуй **headless** **Service** з суфіксом **`-hl`** (див. розділ **«Service: `svc.yaml` і `svc-hl.yaml`»**); у прикладі **`db-h-hl`** заміни на фактичне ім’я.
 
@@ -123,7 +132,9 @@ metadata:
   namespace: dev
 spec:
   parentRefs:
-    - name: gw
+    - group: gateway.networking.k8s.io
+      kind: Gateway
+      name: gw
       namespace: dev
       sectionName: https
   hostnames:
@@ -164,16 +175,22 @@ spec:
       backendRefs:
         - name: db-h-hl
           port: 8080
-    # У WebSocket авторизація йде всередині messages
+    # у websocket авторизація йде всередині messages
+    # Той самий URLRewrite, що й для HTTP: інакше бекенд бачить /ql/v1/graphql замість /v1/graphql
     - matches:
         - path:
             type: PathPrefix
-            value: /
+            value: /ql
           headers:
             - type: Exact
               name: Upgrade
               value: websocket
       filters:
+        - type: URLRewrite
+          urlRewrite:
+            path:
+              type: ReplacePrefixMatch
+              replacePrefixMatch: /
         - type: RequestHeaderModifier
           requestHeaderModifier:
             remove:
@@ -181,13 +198,6 @@ spec:
       backendRefs:
         - name: db-h-hl
           port: 8080
-    - matches:
-        - path:
-            type: PathPrefix
-            value: /
-      backendRefs:
-        - name: db-h-hl
-          port: 8080
 ```
 
 ## Service: заборонені анотації GKE
@@ -277,7 +287,7 @@ patches:
 
 **`npx @nitra/cursor check k8s`** — програмні критерії в **JSDoc на початку** **`npm/scripts/check-k8s.mjs`**. Якщо під **`k8s`** немає **`*.yaml`** — крок пропущено. Канон **`$schema`** для редактора — розділ **«Визначення схеми YAML`** нижче.
 
-**Не входить у check k8s:** наприклад повна структура **`HTTPRoute`** для **Hasura** (канон — у розділі про **`hasura/graphql-engine`**), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
+**Не входить у check k8s:** **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
 
 ## Коли застосовувати (агентам)
 

package/mdc/text.mdc

@@ -120,7 +120,7 @@ version: '1.25'
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^2.0.0"
+    "@nitra/cspell-dict": "^2.1.0"
   }
 }
 ```
@@ -235,7 +235,7 @@ jobs:
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^2.0.0"
+    "@nitra/cspell-dict": "^2.1.0"
   }
 }
 ```
@@ -252,7 +252,7 @@ jobs:
     "lint-text": "npx cspell . && bunx markdownlint-cli2 --fix \"**/*.md\" \"**/*.mdc\" && bun ./npm/scripts/run-v8r.mjs"
   },
   "devDependencies": {
-    "@nitra/cspell-dict": "^2.0.0"
+    "@nitra/cspell-dict": "^2.1.0"
   }
 }
 ```

package/package.json

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