@nitra/cursor 1.13.41 → 1.13.42

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.42] - 2026-05-18
+
+### 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-create-env` skill: повʼязано з правилом `efes` через `skills/efes-create-env/auto.md` (`[efes]`) — активується автоматично, коли репозиторій відповідає efes-маркеру. Тести в `auto-skills.test.mjs` фіксують позитивний і негативний випадки.
+
 ## [1.13.41] - 2026-05-18
 
 ### Fixed

package/package.json

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

package/rules/efes/auto.md

@@ -0,0 +1 @@
+якщо в кореневому package.json в секції "repository" присутній текст "<https://github.com/efes-cloud/**/>"

package/rules/efes/efes.mdc

@@ -0,0 +1,7 @@
+---
+description: Правила для проєктів Efes (репозиторії під github.com/efes-cloud)
+alwaysApply: true
+version: '1.0'
+---
+
+Правило **efes** для споживачів **@nitra/cursor** у репозиторіях під **`github.com/efes-cloud/*`**. Поки що зміст правила порожній — додавайте сюди вимоги, специфічні для efes-проєктів, у міру їх появи.

package/scripts/auto-rules.mjs

@@ -32,6 +32,7 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'capacitor',
   'changelog',
   'docker',
+  'efes',
   'ga',
   'graphql',
   'hasura',
@@ -106,6 +107,7 @@ export const AUTO_RULE_DEPENDENCIES = Object.freeze(
 )
 
 const ABIE_REPOSITORY_URL_MARKER = 'https://github.com/abinbevefes/'
+const EFES_REPOSITORY_URL_MARKER = 'https://github.com/efes-cloud/'
 const HASURA_CONFIG_MARKER = 'metadata_directory: metadata'
 const JS_LIKE_RE = /\.(?:mjs|cjs|js|jsx|ts|tsx)$/iu
 const REGO_RE = /\.rego$/iu
@@ -605,6 +607,7 @@ export async function detectAutoRules({
       : null
   )
   const isAbie = typeof repositoryUrl === 'string' && repositoryUrl.toLowerCase().includes(ABIE_REPOSITORY_URL_MARKER)
+  const isEfes = typeof repositoryUrl === 'string' && repositoryUrl.toLowerCase().includes(EFES_REPOSITORY_URL_MARKER)
   const depHits = await collectDependencyKeysPresentInPackageJsonTree(root, [
     'mssql',
     'pg',
@@ -639,6 +642,7 @@ export async function detectAutoRules({
     { enabled: packageJsonExists, id: 'bun' },
     { enabled: facts.hasCapacitorConfig, id: 'capacitor' },
     { enabled: facts.hasDockerfile, id: 'docker' },
+    { enabled: isEfes, id: 'efes' },
     { enabled: facts.hasGaWorkflowsDir, id: 'ga' },
     { enabled: facts.hasGqlTaggedTemplates, id: 'graphql' },
     { enabled: facts.hasHasuraConfig, id: 'hasura' },

package/scripts/sync-claude-config.mjs

@@ -1,5 +1,5 @@
 /**
- * Синхронізує конфігурацію Claude Code (`.claude/settings.json`, `npm/CLAUDE.md`,
+ * Синхронізує конфігурацію Claude Code (`.claude/settings.json`,
  * slash-команди для checks, ADR Stop-hook) і Cursor hooks (`.cursor/hooks.json`)
  * у поточний проєкт із темплейтів пакету
  * `npm/.claude-template/`.
@@ -8,8 +8,6 @@
  * - `settings.json` — **merge**: користувацькі поля зберігаються; наші hooks
  *   ідентифікуються командою-маркером (`MANAGED_HOOK_COMMAND_MARKERS`) і
  *   перезаписуються; permissions.allow зливається через union (із дедублікацією).
- * - `npm/CLAUDE.md` — **fully owned**: завжди перезаписується; пропускається,
- *   якщо в проєкті немає каталогу `npm/`.
  * - `.claude/commands/n-check.md` — fully owned slash-команда.
  * - `.claude/hooks/capture-decisions.sh` — fully owned bash-скрипт ADR capture Stop-hook;
  *   копіюється з `.claude-template/hooks/`, лише коли в `.n-cursor.json` `rules`
@@ -52,7 +50,6 @@ const CURSOR_DIR = '.cursor'
 const CURSOR_HOOKS_FILE = `${CURSOR_DIR}/hooks.json`
 const ADR_HOOK_SCRIPT_NAME = 'capture-decisions.sh'
 const ADR_NORMALIZE_HOOK_SCRIPT_NAME = 'normalize-decisions.sh'
-const NPM_CLAUDE_MD_FILE = 'npm/CLAUDE.md'
 const TEMPLATE_DIR_NAME = '.claude-template'
 
 /** Канонічна група hooks для ADR capture Stop-hook'а — додається в settings, коли `adr` у `rules`. */
@@ -390,25 +387,6 @@ export function syncAdrNormalizeHookScript(projectRoot, templateDir) {
   return syncHookScript(projectRoot, templateDir, ADR_NORMALIZE_HOOK_SCRIPT_NAME)
 }
 
-/**
- * Копіює `npm/CLAUDE.md` з темплейту, якщо в проєкті є каталог `npm/`.
- * @param {string} projectRoot корінь проєкту, куди писати
- * @param {string} templateDir каталог `.claude-template/` усередині пакету `@nitra/cursor`
- * @returns {Promise<{ written: boolean, path: string }>} результат: чи писали файл, та його відносний шлях
- */
-export async function syncNpmClaudeMd(projectRoot, templateDir) {
-  if (!existsSync(join(projectRoot, 'npm'))) {
-    return { written: false, path: '' }
-  }
-  const templatePath = join(templateDir, 'npm-CLAUDE.md')
-  if (!existsSync(templatePath)) {
-    return { written: false, path: '' }
-  }
-  const content = await readFile(templatePath, 'utf8')
-  await writeFile(join(projectRoot, NPM_CLAUDE_MD_FILE), content, 'utf8')
-  return { written: true, path: NPM_CLAUDE_MD_FILE }
-}
-
 /**
  * Копіює всі slash-команди з `templateDir/commands/` у `.claude/commands/`.
  * Команди ідентифікуються тим, що вони лежать у темплейті — не перетинаються
@@ -444,14 +422,13 @@ export async function syncClaudeCommands(projectRoot, templateDir) {
  * @param {string} options.bundledPackageRoot корінь установленого `@nitra/cursor`
  * @param {boolean} options.enabled чи увімкнено sync (з `.n-cursor.json` `claude-config`)
  * @param {string[]} [options.rules] список увімкнених правил із `.n-cursor.json` — впливає на ADR Stop-hook (`adr`)
- * @returns {Promise<{ settings: boolean, cursorHooks: boolean, npmClaudeMd: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean }>} прапорці записів settings/CLAUDE.md/Cursor hooks/ADR-hook(s) та список записаних slash-команд
+ * @returns {Promise<{ settings: boolean, cursorHooks: boolean, commands: string[], adrHook: boolean, adrNormalizeHook: boolean }>} прапорці записів settings/Cursor hooks/ADR-hook(s) та список записаних slash-команд
  */
 export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enabled, rules = [] }) {
   if (!enabled) {
     return {
       settings: false,
       cursorHooks: false,
-      npmClaudeMd: false,
       commands: [],
       adrHook: false,
       adrNormalizeHook: false
@@ -462,7 +439,6 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
     return {
       settings: false,
       cursorHooks: false,
-      npmClaudeMd: false,
       commands: [],
       adrHook: false,
       adrNormalizeHook: false
@@ -475,12 +451,10 @@ export async function syncClaudeConfig({ projectRoot, bundledPackageRoot, enable
     : { written: false, path: '' }
   const settings = await syncClaudeSettings(projectRoot, templateDir, { includeAdrHook })
   const cursorHooks = await syncCursorHooksConfig(projectRoot, { includeAdrHook })
-  const npmClaudeMd = await syncNpmClaudeMd(projectRoot, templateDir)
   const commands = await syncClaudeCommands(projectRoot, templateDir)
   return {
     settings: settings.written,
     cursorHooks: cursorHooks.written,
-    npmClaudeMd: npmClaudeMd.written,
     commands,
     adrHook: adrHook.written,
     adrNormalizeHook: adrNormalizeHook.written

package/skills/efes-create-env/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: n-efes-create-env
+description: >-
+  Створення нового середовища (env) в репозиторії efes/manager — приймає назву
+  середовища як аргумент (наприклад `kz`, `kz-qa`, `tr-stage`, `ua-dev`).
+  Генерує .env.prod-<env>, .env.remote-<env>, оверлей site/k8s/<env>/,
+  додає скрипт start-remote-<env> у site/package.json і реєструє <env> у
+  списках branches GitHub Actions та Azure Pipelines. Якщо назва закінчується
+  на dev або -qa — non-production (база: md-qa); інакше — production (база: md).
+  Тригери: «створи середовище», «новий env», «add environment», «n-efes-create-env».
+---
+
+# n-efes-create-env — створення нового середовища
+
+Скіл генерує всі конфіги для нового середовища `manager`, спираючись на існуюче як шаблон. Запуск: `/n-efes-create-env <env>` або «створи середовище `<env>`».
+
+## Існуючі середовища (станом на створення скіла)
+
+`dev` · `md` · `md-qa` · `tr` · `tr-qa`
+
+## Аргумент
+
+Назва середовища — `$ARGUMENTS` (kebab-case, без пробілів). Якщо аргументу немає — спитай користувача.
+
+## Класифікація та джерело
+
+| Закінчення      | Тип            | Базове середовище | Базовий домен               |
+| --------------- | -------------- | ----------------- | --------------------------- |
+| `dev` або `-qa` | non-production | `md-qa`           | `mayamd-qa.anadoluefes.com` |
+| інше            | production     | `md`              | `mayamd.anadoluefes.com`    |
+
+Перед роботою зафіксуй у себе:
+
+- `ENV` — `$ARGUMENTS`
+- `BASE` — `md-qa` або `md` згідно з таблицею вище
+- `BASE_DOMAIN` — домен бази
+- `DOMAIN` — `maya${ENV}.anadoluefes.com` (шаблон: префікс `maya` + env). Якщо ENV вже містить країну з дефісом (наприклад `kz-qa`) — домен буде `mayakz-qa.anadoluefes.com`. Якщо користувач хоче інший домен — підтверди.
+- `COUNTRY` — країна без суфіксу `-qa`/`-dev`/`-stage` (наприклад `kz-qa` → `kz`). Потрібно для ACR-шляхів.
+
+## Кроки
+
+### 0. Перевірити, що середовище ще не існує
+
+```bash
+test ! -f site/.env.prod-$ENV \
+  && test ! -f site/.env.remote-$ENV \
+  && test ! -d site/k8s/$ENV \
+  || { echo "Середовище $ENV вже існує — припини"; exit 1; }
+```
+
+### 1. Інтерактивне опитування — зібрати country-specific дані
+
+**ОБОВ'ЯЗКОВО** перед будь-якими `cp`/`sed` запитай користувача через `AskUserQuestion` (у Cursor — звичайним повідомленням з варіантами). Не виконуй кроки 2–5, поки не отримав усі відповіді.
+
+Запитай **одним викликом** `AskUserQuestion` із кількома запитаннями:
+
+1. **Тип середовища** — заголовок «Тип env»:
+   - «Нова країна» — env вводить нову країну (новий VITE_COUNTRY, своя SAP-tenant, свій бакет)
+   - «Новий етап існуючої країни» — env є додатковим етапом md/tr (інший суфікс, але та сама країна та tenant)
+
+2. **Домен** — заголовок «Domain»:
+   - `maya${ENV}.anadoluefes.com` (default, рекомендований)
+   - «Інший» — користувач введе власний
+
+3. **SAP-credentials** — заголовок «SAP auth»:
+   - «Залишити як у бази (`$BASE`)» — для нових етапів існуючої країни
+   - «Заглушки `TODO_SAP_*`» — для нової країни, реальні значення додасть devops/security окремим commit
+   - «Введу зараз» — користувач передасть значення в `Other` (формат: `ENDPOINT=…; CLIENT_ID=…; CLIENT_SECRET=…`)
+
+4. **Storage account (`VITE_BUCKET`)** — заголовок «Bucket»:
+   - «Залишити як у бази» — той самий storage account (`stmdmayasfaprod001`/`stmdmayasfadev001`)
+   - «Власний для нової країни» — користувач введе ім'я storage account в `Other` (наприклад `stkzmayasfaprod001`)
+
+Якщо «Нова країна» — окремо (у тому ж або наступному виклику) запитай:
+
+5. **VITE_COUNTRY** — заголовок «Country»: `md`, `tr`, інше (через `Other`)
+6. **VITE_TFM_DEFAULT** — заголовок «TFM default»: `ru`, `en`, `tr`, `ro`, інше
+7. **VITE_TFM_LIST** — заголовок «TFM list»: набір популярних варіантів (`ru,en,ro,tr`, `en,tr`, `ru,en`) + `Other`
+
+Збережи відповіді у змінні `DOMAIN`, `COUNTRY`, `TFM_DEFAULT`, `TFM_LIST`, `BUCKET_ACCOUNT`, `SAP_MODE` (`keep`/`stub`/`custom`), `SAP_VALUES` (якщо `custom`).
+
+### 2. Створити `.env.prod-$ENV` та `.env.remote-$ENV`
+
+Скопіюй файли бази:
+
+```bash
+cp site/.env.prod-$BASE   site/.env.prod-$ENV
+cp site/.env.remote-$BASE site/.env.remote-$ENV
+
+# домен
+sed -i '' "s|$BASE_DOMAIN|$DOMAIN|g" site/.env.prod-$ENV site/.env.remote-$ENV
+
+# bucket path (maya-files-<base> → maya-files-$ENV)
+sed -i '' "s|maya-files-$BASE|maya-files-$ENV|g" site/.env.prod-$ENV site/.env.remote-$ENV
+```
+
+Далі **застосуй відповіді з кроку 1** (через `Edit`):
+
+- Якщо `BUCKET_ACCOUNT` != base — заміни storage account host у `VITE_BUCKET`.
+- Якщо тип = «Нова країна»:
+  - `VITE_COUNTRY=$COUNTRY`
+  - `VITE_TFM_DEFAULT=$TFM_DEFAULT`
+  - `VITE_TFM_LIST=$TFM_LIST`
+- Якщо `SAP_MODE=stub` — заміни значення на:
+  - `VITE_SAP_AUTH_ENDPOINT=TODO_SAP_ENDPOINT`
+  - `VITE_SAP_AUTH_CLIENT_ID='TODO_SAP_CLIENT_ID'`
+  - `VITE_SAP_AUTH_CLIENT_SECRET=TODO_SAP_CLIENT_SECRET`
+- Якщо `SAP_MODE=custom` — підстав `SAP_VALUES`.
+
+Інваріанти, які мають лишитися після всіх правок:
+
+- У `.env.remote-$ENV` — `VITE_DOMAIN=localhost`, `VITE_UPLOADER=/file-link/`, `VITE_EXPORT_EXCEL=/export-table/`.
+- У `.env.prod-$ENV` — `VITE_DOMAIN=$DOMAIN`, `VITE_UPLOADER=https://$DOMAIN/file-link/`, `VITE_EXPORT_EXCEL=https://$DOMAIN/export-table/`.
+
+### 2. Створити `site/k8s/$ENV/kustomization.yaml`
+
+```bash
+mkdir -p site/k8s/$ENV
+cp site/k8s/$BASE/kustomization.yaml site/k8s/$ENV/kustomization.yaml
+```
+
+Відредагуй новий файл:
+
+- `namespace: $ENV`
+- `images[].newName`:
+  - **production** → `aefes.azurecr.io/mayasfa-$ENV/$ENV/manager-site`
+  - **non-production** → `aefes.azurecr.io/mayasfa-$COUNTRY-dev/$ENV/manager-site`
+- `HTTPRoute` патч → `hostnames: ["$DOMAIN"]`
+- Для **production** залиш блок `components: [../components]` (HPA/PDB).
+- Для **non-production** видали `components` блок і HPA/PDB-патчі (як у `md-qa`).
+
+Перевір: запусти `kubectl kustomize site/k8s/$ENV --output /dev/null` (якщо `kubectl` доступний) — має пройти без помилок.
+
+### 3. Додати `start-remote-$ENV` у `site/package.json`
+
+У секцію `"scripts"` додай рядок (зберігай порядок поряд із сусідніми `start-remote-*`):
+
+```json
+"start-remote-$ENV": "vite dev --mode remote-$ENV",
+```
+
+### 4. Зареєструвати `$ENV` у CI/CD branch-списках
+
+Додай `$ENV` у такі місця (зберігай існуючий порядок: dev → md-qa → md → tr → tr-qa → нові):
+
+| Файл                                        | Поле                           |
+| ------------------------------------------- | ------------------------------ |
+| `.github/workflows/sync-to-azure.yml`       | `on.push.branches`             |
+| `.github/workflows/clean-merged-branch.yml` | `ignore_branches` (через кому) |
+| `.azurepipelines/apply-k8s.yml`             | `trigger.branches.include`     |
+| `.azurepipelines/site.yml`                  | `trigger.branches.include`     |
+
+Якщо існують інші `**/k8s/`-проекти у репозиторії — переконайся, що `$ENV` потрібен і там (на момент створення скіла є тільки `site/k8s/`).
+
+### 5. Попередження користувачу про зовнішні залежності
+
+Скіл **не** створює ці артефакти — повідом про них користувача:
+
+- У repo `MayaSFA/k8s` має існувати шаблон `.azurepipelines/azure-pipeline-templates/$ENV.yml` (його використовує `apply-k8s.yml` і `site.yml`).
+- Гілка `$ENV` має бути створена в обох remote (GitHub + Azure DevOps).
+- DNS-запис для `$DOMAIN` та health-check у gateway мають бути налаштовані відповідною командою.
+- Якщо ENV — нова країна: ACR-репозиторій `mayasfa-$ENV` (для prod) або `mayasfa-$COUNTRY-dev` (для non-prod) має бути створений.
+
+### 6. Перевірка результату
+
+```bash
+ls site/.env.prod-$ENV site/.env.remote-$ENV site/k8s/$ENV/kustomization.yaml
+grep -n "$ENV" \
+  .github/workflows/sync-to-azure.yml \
+  .github/workflows/clean-merged-branch.yml \
+  .azurepipelines/apply-k8s.yml \
+  .azurepipelines/site.yml \
+  site/package.json
+git status
+```
+
+Виведи користувачу короткий звіт: що створено, що змінено, які зовнішні дії потрібні (з кроку 5). **Не комітити автоматично** — користувач сам перегляне через `git diff` і закомітить.
+
+## Нюанси та пастки
+
+- **Доменний шаблон `maya${ENV}.anadoluefes.com`** працює для існуючих країн (md/tr). Якщо нова країна має інший публічний URL — підтверди в користувача _до_ запуску `sed`.
+- **ACR-шлях суворо за шаблоном**: prod → `mayasfa-$ENV/$ENV/manager-site`, non-prod → `mayasfa-$COUNTRY-dev/$ENV/manager-site`. Жодних додаткових сегментів між ACR-namespace та `$ENV` бути не повинно.
+- **`ENV=dev`**: гілка `dev` — спеціальний випадок (вживає `base/`, без оверлею). Скіл не призначений для перестворення `dev`.
+- **`.env.development`** — лише для локального запуску без бекенду; скіл його не чіпає.
+- **Не запускай `bun run lint` / `lint-ga`** в один потік з іншими — дивись CLAUDE.md «Лінт і ESLint». Перевір лише потрібний файл (`bunx eslint <path>` або точково).

package/skills/efes-create-env/auto.md

@@ -0,0 +1 @@
+[efes]