@nitra/cursor 1.13.43 → 1.13.44

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.13.44] - 2026-05-18
+
+### Added
+
+- `abie` rule: новий policy-концерн `abie.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-docs` (presence-only, версію не фіксуємо). Реалізація: `npm/rules/abie/policy/package_json_docs/` (target.json + .rego + _test.rego). Bump `abie.mdc` `1.20` → `1.21`.
+- `efes` rule: перший policy-концерн `efes.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/efes-docs` (узгоджено з `graphql.mdc`, де схема береться з `node_modules/@nitra/efes-docs/schema/maya.graphql`). Реалізація: `npm/rules/efes/policy/package_json_docs/`. Bump `efes.mdc` `1.0` → `1.1`.
+
 ## [1.13.43] - 2026-05-18
 
 ### Removed
@@ -14,7 +21,7 @@
 
 ### Added
 
-- `efes` rule: новий (поки що порожній) пакет правил для проєктів **github.com/efes-cloud/***. Автодетект у `auto-rules.mjs` через `EFES_REPOSITORY_URL_MARKER` (`https://github.com/efes-cloud/`) — аналогічно до `abie`. Додано `npm/rules/efes/efes.mdc` + `auto.md`, прописано порядок в `AUTO_RULE_ORDER` і покрито тестами в `auto-rules.test.mjs`.
+- `efes` rule: новий (поки що порожній) пакет правил для проєктів **github.com/efes-cloud/\***. Автодетект у `auto-rules.mjs` через `EFES_REPOSITORY_URL_MARKER` (`https://github.com/efes-cloud/`) — аналогічно до `abie`. Додано `npm/rules/efes/efes.mdc` + `auto.md`, прописано порядок в `AUTO_RULE_ORDER` і покрито тестами в `auto-rules.test.mjs`.
 - `efes-create-env` skill: повʼязано з правилом `efes` через `skills/efes-create-env/auto.md` (`[efes]`) — активується автоматично, коли репозиторій відповідає efes-маркеру. Тести в `auto-skills.test.mjs` фіксують позитивний і негативний випадки.
 
 ## [1.13.41] - 2026-05-18

package/package.json

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

package/rules/abie/abie.mdc

@@ -1,7 +1,7 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.20'
+version: '1.21'
 ---
 
 Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua**)), гілки **dev**, **ua** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
@@ -140,6 +140,14 @@ KVCMS_URL=http://kvcms-hl.ua-apruv.svc.abie-ua.internal:8080
 
 Загальне правило про **внутрішній** URL (не публічний домен) для `HASURA_GRAPHQL_ENDPOINT` лишається у **`hasura.mdc`** (для nitra і abie) — `check-hasura.mjs` приймає кластерний DNS-формат `<cluster>.internal`.
 
+## `@nitra/abie-docs` у `devDependencies`
+
+У кореневому **`package.json`** abie-проєкту в **`devDependencies`** має бути **`@nitra/abie-docs`** — пакет з канонічними контрактами/схемами abie-сервісів (наприклад, шляхи `node_modules/@nitra/abie-docs/...` для імпорту схем). Версію правило не фіксує — лише presence. Додати:
+
+```bash
+bun add -d @nitra/abie-docs
+```
+
 ## Firebase Hosting
 
 У **кожному** підкаталозі, що лежить **безпосередньо** в корені репозиторію, не тримати конфіг і кеш **Firebase Hosting**: у таких каталогах не повинно бути **`.firebaserc`**, **`firebase.json`** та каталогу **`.firebase/`** (у **самому** корені репозиторію ці імена перевіркою abie **не** розглядаються; `node_modules` / `.git` зі скану вилучаються).
@@ -160,5 +168,6 @@ KVCMS_URL=http://kvcms-hl.ua-apruv.svc.abie-ua.internal:8080
 - **`health_check_policy/`** → `abie.health_check_policy` — структура HealthCheckPolicy: `apiVersion: networking.gke.io/v1`, `metadata.name`, `spec.default.config.type: HTTP`, `httpHealthCheck.requestPath` починається з `/`, `port: 8080`, `targetRef.kind: Service`, `targetRef.name` має суфікс `-hl`. **Цільові файли:** `…/k8s/.../hc.yaml`.
 - **`base_deployment_preem/`** → `abie.base_deployment_preem` — Deployment у base/ має `spec.template.spec.nodeSelector.preem` зі значенням `true` (boolean або рядок). **Цільові файли:** ресурсні YAML під `…/k8s/.../base/...`.
 - **`clean_merged_ignore_branches/`** → `abie.clean_merged_ignore_branches` — у workflow `.github/workflows/clean-merged-branch.yml` крок з `uses: phpdocker-io/github-actions-delete-abandoned-branches` має `with.ignore_branches`, що містить токени `dev,ua` (case-insensitive). **Цільові файли:** `.github/workflows/clean-merged-branch.yml`.
+- **`package_json_docs/`** → `abie.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-docs` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
 
 Cross-file логіка (парність HCP↔Deployment у каталозі, обчислений `<deployment.name>-hl` для `targetRef.name`, валідація ua-overlay JSON6902 patches на HTTPRoute, env→cluster DNS, аналіз cross-namespace backendRefs у пакетах) лишається у **`check-abie.mjs`** — Rego не читає файлову систему й не робить cross-document резолюцію.

package/rules/abie/policy/package_json_docs/package_json_docs.rego

@@ -0,0 +1,16 @@
+# Перевірка кореневого `package.json` abie-проєкту: у `devDependencies` має бути
+# `@nitra/abie-docs` (контракти/схеми abie-сервісів — наприклад
+# `node_modules/@nitra/abie-docs/...`). Версію не фіксуємо — лише presence.
+#
+# Inverse-presence перевірка — лишається inline у rego (як `@nitra/cspell-dict`
+# у `text.package_json`), бо у template/ зберігаємо позитивні snippet/deny канони,
+# а не одиничний required-ключ.
+package abie.package_json_docs
+
+import rego.v1
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	not "@nitra/abie-docs" in object.keys(dev)
+	msg := "package.json: devDependencies має містити @nitra/abie-docs — bun add -d @nitra/abie-docs (abie.mdc)"
+}

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

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/abie-docs'] (abie.mdc)"
+}

package/rules/efes/efes.mdc

@@ -1,7 +1,23 @@
 ---
 description: Правила для проєктів Efes (репозиторії під github.com/efes-cloud)
 alwaysApply: true
-version: '1.0'
+version: '1.1'
 ---
 
-Правило **efes** для споживачів **@nitra/cursor** у репозиторіях під **`github.com/efes-cloud/*`**. Поки що зміст правила порожній — додавайте сюди вимоги, специфічні для efes-проєктів, у міру їх появи.
+Правило **efes** для споживачів **@nitra/cursor** у репозиторіях під **`github.com/efes-cloud/*`**.
+
+## `@nitra/efes-docs` у `devDependencies`
+
+У кореневому **`package.json`** efes-проєкту в **`devDependencies`** має бути **`@nitra/efes-docs`** — пакет з канонічними контрактами/схемами efes-сервісів (зокрема використовується у `graphql.mdc` як `node_modules/@nitra/efes-docs/schema/maya.graphql`). Версію правило не фіксує — лише presence. Додати:
+
+```bash
+bun add -d @nitra/efes-docs
+```
+
+## Швидкий gate через conftest (Rego)
+
+Пер-документні перевірки efes — rego-полісі у **`npm/rules/efes/policy/`** (запускається через **`npx @nitra/cursor check efes`**; синтаксичний lint — через **`bun run lint-rego`**). Деталі шаблону — у **conftest.mdc** / **n-rego.mdc**.
+
+Пакети (директорія в **`npm/rules/efes/policy/`** → namespace → що перевіряє):
+
+- **`package_json_docs/`** → `efes.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/efes-docs` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.

package/rules/efes/policy/package_json_docs/package_json_docs.rego

@@ -0,0 +1,16 @@
+# Перевірка кореневого `package.json` efes-проєкту: у `devDependencies` має бути
+# `@nitra/efes-docs` (контракти/схеми efes-сервісів — використовується, зокрема,
+# у `graphql.mdc` як `node_modules/@nitra/efes-docs/schema/maya.graphql`). Версію
+# не фіксуємо — лише presence.
+#
+# Inverse-presence перевірка лишається inline у rego (як `@nitra/cspell-dict`
+# у `text.package_json`).
+package efes.package_json_docs
+
+import rego.v1
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	not "@nitra/efes-docs" in object.keys(dev)
+	msg := "package.json: devDependencies має містити @nitra/efes-docs — bun add -d @nitra/efes-docs (efes.mdc)"
+}

package/rules/efes/policy/package_json_docs/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/efes-docs'] (efes.mdc)"
+}

package/rules/ga/lint/lint.mjs

@@ -81,10 +81,7 @@ const CONFTEST_PREFLIGHT = {
     'Без нього не запускається пер-документна валідація через rego-полісі (npm/rules/*/policy/)',
     'у кроці check-ga — `runConftestBatch` завершується hard-fail.'
   ].join('\n   '),
-  install: [
-    'macOS:     brew install conftest',
-    'Universal: https://www.conftest.dev/install/'
-  ],
+  install: ['macOS:     brew install conftest', 'Universal: https://www.conftest.dev/install/'],
   successMsg: '✅ conftest знайдено в PATH — check-ga виконає rego-полісі через runConftestBatch'
 }
 

package/rules/text/lint/lint.mjs

@@ -51,13 +51,10 @@ const SHELLCHECK_PREFLIGHT = {
 /** @type {PreflightDep} */
 const PATCH_PREFLIGHT = {
   bin: 'patch',
-  explanation: [
-    'Без `patch` не застосуються авто-виправлення shellcheck (`shellcheck -f diff` + `patch -p1`).'
-  ].join('\n   '),
-  install: [
-    'macOS:         зазвичай уже є в системі',
-    'Debian/Ubuntu: sudo apt-get install -y patch'
-  ],
+  explanation: ['Без `patch` не застосуються авто-виправлення shellcheck (`shellcheck -f diff` + `patch -p1`).'].join(
+    '\n   '
+  ),
+  install: ['macOS:         зазвичай уже є в системі', 'Debian/Ubuntu: sudo apt-get install -y patch'],
   successMsg: '✅ patch знайдено в PATH — shellcheck auto-fix працюватиме'
 }