@nitra/cursor 1.8.81 → 1.8.84

package/README.md

@@ -6,7 +6,7 @@
 
 Репозиторій `@nitra/cursor` містить cursor-правила у директорії `mdc/`. CLI копіює обрані правила з **каталогу `mdc/` того пакету, з якого виконується `bin/n-cursor.js`**: після `npm i` / `bun add` це зазвичай `node_modules/@nitra/cursor/mdc`; при **`npx @nitra/cursor`** пакет потрапляє в **кеш npx/npm**, і правила читаються з тієї розпакованої копії (у корені проєкту залежність не обов’язкова). Жодних окремих HTTP-запитів до CDN для файлів правил немає — лише те, що вже є в tarball пакету.
 
-Наприклад, правило `mdc/js-format.mdc` буде збережено як `.cursor/rules/n-js-format.mdc`.
+Наприклад, правило `mdc/text.mdc` буде збережено як `.cursor/rules/n-text.mdc`.
 
 ## Підготовка
 
@@ -15,19 +15,18 @@
 ```json
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/n-cursor.json",
-  "rules": ["js-format", "npm-module", "text"],
+  "rules": ["npm-module", "text"],
   "skills": ["fix"]
 }
 ```
 
 Доступні правила:
 
-| Назва        | Опис                                              |
-| ------------ | ------------------------------------------------- |
-| `js-format`  | Правила форматування JavaScript ecosystem (oxfmt) |
-| `npm-module` | Структура репозиторію для npm-модуля (bun mono)   |
-| `text`       | Текстові файли: cspell, CI                        |
-| `k8s`        | Kubernetes YAML, Kustomize, kubeconform           |
+| Назва        | Опис                                            |
+| ------------ | ----------------------------------------------- |
+| `npm-module` | Структура репозиторію для npm-модуля (bun mono) |
+| `text`       | Текст, oxfmt, cspell, markdownlint, v8r, CI     |
+| `k8s`        | Kubernetes YAML, Kustomize, kubeconform         |
 
 Щоб використовувати конкретну версію правил, оновіть залежність `@nitra/cursor` у проєкті (`bun add -d @nitra/cursor@<версія>` тощо). Поле `version` у `.n-cursor.json`, якщо воно лишилось у старих конфігах, **ігнорується**.
 
@@ -71,13 +70,12 @@ CLI автоматично (команда завантаження правил
 ```
 🔧 @nitra/cursor — завантаження cursor-правил
 
-📋 Правил до завантаження: 3
-  ⬇  js-format → .cursor/rules/n-js-format.mdc ... ✅
+📋 Правил до завантаження: 2
   ⬇  npm-module → .cursor/rules/n-npm-module.mdc ... ✅
   ⬇  text → .cursor/rules/n-text.mdc ... ✅
 📝 Оновлено AGENTS.md з AGENTS.template.md
 
-✨ Готово: 3 завантажено, 0 з помилками
+✨ Готово: 2 завантажено, 0 з помилками
 ```
 
 ## Структура пакету
@@ -86,7 +84,6 @@ CLI автоматично (команда завантаження правил
 npm/
 ├── AGENTS.template.md   # шаблон AGENTS.md для цільових репозиторіїв (потрапляє в npm-архів)
 ├── mdc/                 # cursor-правила (без префікса n-; після синку — .cursor/rules/n-<id>.mdc)
-│   ├── js-format.mdc
 │   ├── npm-module.mdc
 │   └── text.mdc
 ├── skills/              # skills (каталоги <id>/; після синку — .cursor/skills/n-<id>/)

package/bin/n-cursor.js

@@ -32,6 +32,10 @@
  *
  * Якщо в корені є package.json і в ньому ще немає \@nitra/cursor у devDependencies (і не оголошено
  * в dependencies), CLI дописує devDependencies з діапазоном ^<version> поточного пакету — зручно після npx.
+ *
+ * Перед копіюванням правил (режим без підкоманди): оновлення \@nitra/cursor у package.json до
+ * останньої версії з npm (крім workspace:/file:/link: тощо), `bun i`, далі файли беруться з
+ * `node_modules/@nitra/cursor`, якщо пакет з’явився після встановлення.
  */
 
 import { existsSync } from 'node:fs'
@@ -40,10 +44,8 @@ import { basename, dirname, join } from 'node:path'
 import { cwd } from 'node:process'
 import { fileURLToPath } from 'node:url'
 
-import {
-  ensureNitraCursorInRootDevDependencies,
-  readBundledPackageVersion
-} from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
+import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
+import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
 import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
 
@@ -68,17 +70,18 @@ const BUNDLED_PACKAGE_ROOT = join(binDir, '..')
 
 /**
  * Імена правил (без .mdc) з каталогу mdc поточної інсталяції пакету
+ * @param {string} [bundledMdcDir] каталог `mdc/` у корені пакету (за замовчуванням — з поточного процесу)
  * @returns {Promise<string[]>} відсортовані імена файлів правил без суфікса .mdc
  */
-async function discoverBundledRuleNames() {
-  if (!existsSync(BUNDLED_MDC_DIR)) {
+async function discoverBundledRuleNames(bundledMdcDir = BUNDLED_MDC_DIR) {
+  if (!existsSync(bundledMdcDir)) {
     throw new Error(
       `Не знайдено каталог правил пакету.\n` +
-        `Очікуваний шлях: ${BUNDLED_MDC_DIR}\n` +
+        `Очікуваний шлях: ${bundledMdcDir}\n` +
         `Перевстановіть ${PACKAGE_NAME} або створіть ${CONFIG_FILE} вручну.`
     )
   }
-  const names = await readdir(BUNDLED_MDC_DIR)
+  const names = await readdir(bundledMdcDir)
   const rules = names
     .filter(n => n.endsWith('.mdc'))
     .map(n => n.slice(0, -'.mdc'.length))
@@ -91,13 +94,14 @@ async function discoverBundledRuleNames() {
 
 /**
  * Імена skills (id без префікса n-) з каталогу skills пакету — лише підкаталоги `<id>/` без префікса n-
+ * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету
  * @returns {Promise<string[]>} відсортовані id
  */
-async function discoverBundledSkillNames() {
-  if (!existsSync(BUNDLED_SKILLS_DIR)) {
+async function discoverBundledSkillNames(bundledSkillsDir = BUNDLED_SKILLS_DIR) {
+  if (!existsSync(bundledSkillsDir)) {
     return []
   }
-  const entries = await readdir(BUNDLED_SKILLS_DIR, { withFileTypes: true })
+  const entries = await readdir(bundledSkillsDir, { withFileTypes: true })
   return entries
     .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith(RULE_PREFIX))
     .map(e => e.name)
@@ -152,14 +156,17 @@ async function migrateLegacyConfigIfNeeded() {
 
 /**
  * Зчитує конфіг .n-cursor.json з поточної директорії
+ * @param {{ bundledMdcDir?: string, bundledSkillsDir?: string }} [paths] каталоги з пакету-джерела (після `bun i` — зазвичай `node_modules/@nitra/cursor`)
  * @returns {Promise<{ $schema: string, rules: string[], skills: string[], version?: string } & Record<string, unknown>>} rules, skills (id без префікса n-); поле version у файлі за наявності ігнорується при синхронізації правил
  */
-async function readConfig() {
+async function readConfig(paths = {}) {
+  const bundledMdcDir = paths.bundledMdcDir ?? BUNDLED_MDC_DIR
+  const bundledSkillsDir = paths.bundledSkillsDir ?? BUNDLED_SKILLS_DIR
   await migrateLegacyConfigIfNeeded()
   const configPath = join(cwd(), CONFIG_FILE)
   if (!existsSync(configPath)) {
-    const rules = await discoverBundledRuleNames()
-    const skills = await discoverBundledSkillNames()
+    const rules = await discoverBundledRuleNames(bundledMdcDir)
+    const skills = await discoverBundledSkillNames(bundledSkillsDir)
     const defaultConfig = { $schema: CONFIG_SCHEMA_URL, rules, skills }
     await writeFile(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, 'utf8')
     console.log(
@@ -181,7 +188,7 @@ async function readConfig() {
     if ('skills' in config) {
       throw new Error(`У ${CONFIG_FILE} поле "skills" має бути масивом рядків`)
     }
-    config.skills = await discoverBundledSkillNames()
+    config.skills = await discoverBundledSkillNames(bundledSkillsDir)
   }
 
   if (config.$schema !== CONFIG_SCHEMA_URL) {
@@ -197,8 +204,8 @@ async function readConfig() {
 
 /**
  * Витягує чисте ім'я файлу правила (без шляху, але зберігає .mdc)
- * "npm/mdc/js-format.mdc" → "js-format.mdc"
- * "js-format"              → "js-format.mdc"
+ * "npm/mdc/text.mdc" → "text.mdc"
+ * "text"             → "text.mdc"
  * @param {string} ruleName шлях або базове ім'я, з суфіксом .mdc або без
  * @returns {string} лише ім'я файлу з суфіксом .mdc
  */
@@ -210,14 +217,15 @@ function normalizeRuleName(ruleName) {
 /**
  * Читає вміст правила з каталогу `mdc/` установленого пакету (наприклад `node_modules/@nitra/cursor/mdc` або кеш npx).
  * @param {string} rule елемент масиву rules з `.n-cursor.json`
+ * @param {string} [bundledMdcDir] каталог `mdc/` у корені пакету-джерела
  * @returns {Promise<string>} текст правила для запису в `.cursor/rules/n-*.mdc`
  */
-function readBundledRuleContent(rule) {
+function readBundledRuleContent(rule, bundledMdcDir = BUNDLED_MDC_DIR) {
   const bundledName = normalizeRuleName(rule)
-  const bundledPath = join(BUNDLED_MDC_DIR, bundledName)
+  const bundledPath = join(bundledMdcDir, bundledName)
   if (!existsSync(bundledPath)) {
     throw new Error(
-      `Немає файлу ${bundledName} у ${BUNDLED_MDC_DIR}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
+      `Немає файлу ${bundledName} у ${bundledMdcDir}. Оновіть ${PACKAGE_NAME} або приберіть "${rule}" з rules у ${CONFIG_FILE}.`
     )
   }
   return readFile(bundledPath, 'utf8')
@@ -457,17 +465,18 @@ async function syncClaudeMd(configRules, configSkills) {
 /**
  * Повністю перезаписує AGENTS.md у корені cwd з npm/AGENTS.template.md
  * @param {string[]} configSkills id skills з конфігу
+ * @param {string} [agentsTemplatePath] шлях до AGENTS.template.md у корені пакету-джерела
  * @returns {Promise<void>} завершення запису файлу
  */
-async function syncAgentsMd(configSkills) {
-  if (!existsSync(BUNDLED_AGENTS_TEMPLATE_PATH)) {
+async function syncAgentsMd(configSkills, agentsTemplatePath = BUNDLED_AGENTS_TEMPLATE_PATH) {
+  if (!existsSync(agentsTemplatePath)) {
     throw new Error(
       `Не знайдено шаблон ${AGENTS_TEMPLATE_FILE} у пакеті.\n` +
-        `Очікуваний шлях: ${BUNDLED_AGENTS_TEMPLATE_PATH}\n` +
+        `Очікуваний шлях: ${agentsTemplatePath}\n` +
         `Перевстановіть ${PACKAGE_NAME}.`
     )
   }
-  const templateText = await readFile(BUNDLED_AGENTS_TEMPLATE_PATH, 'utf8')
+  const templateText = await readFile(agentsTemplatePath, 'utf8')
   const mdcFiles = await listProjectRulesMdcFiles()
   const skillItems = await buildSkillBulletItems(configSkills)
   const body = renderAgentsTemplate(templateText, mdcFiles, skillItems)
@@ -485,10 +494,11 @@ async function syncAgentsMd(configSkills) {
 /**
  * Копіює лише skills зі списку configSkills (джерело: skills/<id>/ у пакеті)
  * @param {string[]} configSkills id без префікса n-
+ * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих копіювань
  */
-async function syncSkills(configSkills) {
-  if (configSkills.length === 0 || !existsSync(BUNDLED_SKILLS_DIR)) {
+async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
+  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
     return { success: 0, fail: 0 }
   }
 
@@ -500,7 +510,7 @@ async function syncSkills(configSkills) {
 
   for (const skillId of configSkills) {
     const id = normalizeSkillId(skillId)
-    const srcDir = join(BUNDLED_SKILLS_DIR, id)
+    const srcDir = join(bundledSkillsDir, id)
     const destDirName = managedSkillDirName(skillId)
     const destDir = join(skillsRoot, destDirName)
 
@@ -534,10 +544,11 @@ async function syncSkills(configSkills) {
  * Синхронізує .claude/commands/n-<id>.md зі skills пакету.
  * Кожен файл містить посилання на відповідний cursor skill, а не копію інструкцій.
  * @param {string[]} configSkills id без префікса n-
+ * @param {string} [bundledSkillsDir] каталог `skills/` у корені пакету-джерела
  * @returns {Promise<{ success: number, fail: number }>} лічильники успішних і невдалих записів
  */
-async function syncCommands(configSkills) {
-  if (configSkills.length === 0 || !existsSync(BUNDLED_SKILLS_DIR)) {
+async function syncCommands(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
+  if (configSkills.length === 0 || !existsSync(bundledSkillsDir)) {
     return { success: 0, fail: 0 }
   }
 
@@ -549,7 +560,7 @@ async function syncCommands(configSkills) {
 
   for (const skillId of configSkills) {
     const id = normalizeSkillId(skillId)
-    const srcSkillMd = join(BUNDLED_SKILLS_DIR, id, 'SKILL.md')
+    const srcSkillMd = join(bundledSkillsDir, id, 'SKILL.md')
     const destDirName = managedSkillDirName(skillId)
     const destFile = join(commandsDir, `${RULE_PREFIX}${id}.md`)
 
@@ -730,6 +741,24 @@ async function runChecks(requestedRules) {
   }
 }
 
+/**
+ * Читає поле `version` з `package.json` пакету за абсолютним шляхом до його кореня.
+ * @param {string} packageRoot корінь пакету (тека з `package.json`)
+ * @returns {Promise<string | null>} semver рядком або null, якщо файлу/поля немає або JSON некоректний
+ */
+async function readBundledVersionAt(packageRoot) {
+  const p = join(packageRoot, 'package.json')
+  if (!existsSync(p)) {
+    return null
+  }
+  try {
+    const pkg = JSON.parse(await readFile(p, 'utf8'))
+    return typeof pkg.version === 'string' ? pkg.version : null
+  } catch {
+    return null
+  }
+}
+
 /**
  * Копіює правила з каталогу `mdc/` установленого пакету та синхронізує `.cursor/rules`
  * @returns {Promise<void>}
@@ -737,18 +766,36 @@ async function runChecks(requestedRules) {
 async function runSync() {
   console.log(`\n🔧 ${PACKAGE_NAME} — завантаження cursor-правил\n`)
 
+  const projectRoot = cwd()
+  let effectivePackageRoot
+  try {
+    effectivePackageRoot = await upgradeNitraCursorToLatestAndBunInstall(projectRoot, BUNDLED_PACKAGE_ROOT)
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error)
+    console.error(`❌ Не вдалося оновити ${PACKAGE_NAME} або виконати bun i: ${msg}`)
+    throw error
+  }
+
+  const bundledMdcDir = join(effectivePackageRoot, 'mdc')
+  const bundledSkillsDir = join(effectivePackageRoot, 'skills')
+  const bundledAgentsTemplatePath = join(effectivePackageRoot, AGENTS_TEMPLATE_FILE)
+
   let config
   try {
-    config = await readConfig()
+    config = await readConfig({ bundledMdcDir, bundledSkillsDir })
   } catch (error) {
     console.error(`❌ ${error.message}`)
     throw error
   }
 
   const { rules, skills, version } = config
-  const bundledVer = await readBundledPackageVersion()
+  const bundledVer = await readBundledVersionAt(effectivePackageRoot)
   if (bundledVer) {
-    console.log(`📦 Джерело правил: ${PACKAGE_NAME}@${bundledVer}`)
+    const line =
+      effectivePackageRoot === BUNDLED_PACKAGE_ROOT
+        ? `📦 Джерело правил: ${PACKAGE_NAME}@${bundledVer}`
+        : `📦 Джерело правил: ${PACKAGE_NAME}@${bundledVer} (шлях: ${effectivePackageRoot})`
+    console.log(`${line}\n`)
   }
   if (version) {
     console.log(`⚠️  Поле "version" у ${CONFIG_FILE} ігнорується; правила беруться з установленого пакету.\n`)
@@ -757,7 +804,7 @@ async function runSync() {
   console.log(`📋 Skills до синхронізації: ${skills.length}`)
 
   try {
-    const { destPath } = await syncSetupBunDepsAction(cwd(), BUNDLED_PACKAGE_ROOT)
+    const { destPath } = await syncSetupBunDepsAction(cwd(), effectivePackageRoot)
     console.log(`📝 Оновлено ${destPath} (composite setup-bun-deps з пакету)\n`)
   } catch (error) {
     console.error(`❌ Не вдалося записати setup-bun-deps action: ${error.message}`)
@@ -776,7 +823,7 @@ async function runSync() {
 
     try {
       process.stdout.write(`  ⬇  ${rule} → ${RULES_DIR}/${fileName} ... `)
-      const content = await readBundledRuleContent(rule)
+      const content = await readBundledRuleContent(rule, bundledMdcDir)
       await writeFile(destPath, content, 'utf8')
       console.log(`✅`)
       successCount++
@@ -801,7 +848,7 @@ async function runSync() {
   }
 
   try {
-    const { success: skillOk, fail: skillFail } = await syncSkills(skills)
+    const { success: skillOk, fail: skillFail } = await syncSkills(skills, bundledSkillsDir)
     if (skills.length > 0) {
       console.log(`\n🧩 Skills: ${skillOk} скопійовано, ${skillFail} з помилками`)
     }
@@ -821,7 +868,7 @@ async function runSync() {
   }
 
   try {
-    const { success: cmdOk, fail: cmdFail } = await syncCommands(skills)
+    const { success: cmdOk, fail: cmdFail } = await syncCommands(skills, bundledSkillsDir)
     if (skills.length > 0) {
       console.log(`\n⌨️  Commands: ${cmdOk} скопійовано, ${cmdFail} з помилками`)
     }
@@ -841,7 +888,7 @@ async function runSync() {
   }
 
   try {
-    await syncAgentsMd(skills)
+    await syncAgentsMd(skills, bundledAgentsTemplatePath)
   } catch (error) {
     console.error(`❌ Не вдалося оновити ${AGENTS_FILE}: ${error.message}`)
     throw error

package/mdc/abie.mdc

@@ -1,10 +1,10 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.8'
+version: '1.9'
 ---
 
-Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**), видалення **HealthCheckPolicy** у **ru**), а також гілки **dev**, **ua**, **ru** у **clean-merged-branch**.
+Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** / **ru** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**), видалення **HealthCheckPolicy** у **ru**), гілки **dev**, **ua**, **ru** у **clean-merged-branch**, а також заборона артефактів **Firebase Hosting** у корені репозиторію.
 
 **`npx @nitra/cursor check abie`** виконується лише якщо в **`.n-cursor.json`** у **`rules`** є **`abie`** — інакше вихід **0** без зауважень.
 
@@ -135,6 +135,10 @@ spec:
         preem: 'true' # буде замінено через kustomize
 ```
 
+## Firebase Hosting
+
+У корені репозиторію не тримати конфіг і кеш **Firebase Hosting**: видали **`.firebaserc`**, **`firebase.json`** та каталог **`.firebase/`**, якщо вони є.
+
 ## Git branches
 
 У **`.github/workflows/clean-merged-branch.yml`** у кроці **`phpdocker-io/github-actions-delete-abandoned-branches`** значення **`with.ignore_branches`** має містити **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно):

package/mdc/k8s.mdc

@@ -106,6 +106,88 @@ resources: {}
 
 Образ **`hasura/graphql-engine`**: дозволений лише канонічний тег із константи **`HASURA_GRAPHQL_ENGINE_IMAGE`** у **`check-k8s.mjs`** (допускається префікс **`docker.io/`**); решта — помилка **check k8s**.
 
+### 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.
+
+**`parentRefs`**, **`hostnames`**, **`metadata.namespace`** / **`name`** підлаштуй під середовище. У **`backendRefs.name`** вказуй **headless** **Service** з суфіксом **`-hl`** (див. розділ **«Service: `svc.yaml` і `svc-hl.yaml`»**); у прикладі **`db-h-hl`** заміни на фактичне ім’я.
+
+```yaml
+# yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/gateway.networking.k8s.io/httproute_v1beta1.json
+apiVersion: gateway.networking.k8s.io/v1beta1
+kind: HTTPRoute
+metadata:
+  name: db-h
+  namespace: dev
+spec:
+  parentRefs:
+    - name: gw
+      namespace: dev
+      sectionName: https
+  hostnames:
+    - abie.cloud
+  rules:
+    - matches:
+        - path:
+            type: Exact
+            value: /ql
+      filters:
+        - type: RequestRedirect
+          requestRedirect:
+            path:
+              type: ReplaceFullPath
+              replaceFullPath: /ql/console
+            statusCode: 302
+    - matches:
+        - path:
+            type: Exact
+            value: /ql/
+      filters:
+        - type: RequestRedirect
+          requestRedirect:
+            path:
+              type: ReplaceFullPath
+              replaceFullPath: /ql/console
+            statusCode: 302
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /ql
+      filters:
+        - type: URLRewrite
+          urlRewrite:
+            path:
+              type: ReplacePrefixMatch
+              replacePrefixMatch: /
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+    # У WebSocket авторизація йде всередині messages
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /
+          headers:
+            - type: Exact
+              name: Upgrade
+              value: websocket
+      filters:
+        - type: RequestHeaderModifier
+          requestHeaderModifier:
+            remove:
+              - Authorization
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+    - matches:
+        - path:
+            type: PathPrefix
+            value: /
+      backendRefs:
+        - name: db-h-hl
+          port: 8080
+```
+
 ## Service: заборонені анотації GKE
 
 У **`kind: Service`** не додавай у **`metadata.annotations`** **`cloud.google.com/neg`** і **`cloud.google.com/backend-config`** (legacy під Ingress / старе балансування GKE). **check k8s** падає, якщо ключ є.
@@ -224,7 +306,7 @@ patches:
 
 **`npx @nitra/cursor check k8s`** — програмні критерії в **JSDoc на початку** **`npm/scripts/check-k8s.mjs`**. Якщо під **`k8s`** немає **`*.yaml`** — крок пропущено. Канон **`$schema`** для редактора — розділ **«Визначення схеми YAML`** нижче.
 
-**Не входить у check k8s:** наприклад **ReferenceGrant** і доступ між **namespace** (лише рекомендації тут), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
+**Не входить у check k8s:** наприклад **ReferenceGrant** і доступ між **namespace** (лише рекомендації тут), повна структура **`HTTPRoute`** для **Hasura** (канон — у розділі про **`hasura/graphql-engine`**), **kubeconform** / **kubescape** — це **`bun run lint-k8s`**.
 
 ## Коли застосовувати (агентам)
 

package/mdc/style-lint.mdc

@@ -7,7 +7,7 @@ version: '1.2'
 ## Генерація та редагування стилів (Cursor і інші агенти)
 
 - **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
-- **Форматування** узгоджуй з **`n-js-format.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
+- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
 - **Запуск stylelint:** лише **`npx stylelint`**. Локально — через скрипт **`lint-style`** (`bun run lint-style`); у **GitHub Actions** у кроці **`run`** викликай `npx stylelint '**/*.{css,scss,vue}' --fix` напряму (не через **`bun run lint-style`**). Не використовуй **`bunx stylelint`**. Після змін запускай **`bun run lint-style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний набір `lint-*` (навичка **`n-fix`**).
 - **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
 

package/mdc/text.mdc

@@ -1,10 +1,10 @@
 ---
-description: Обробка та перевірка текстових файлів (cspell, markdownlint-cli2, v8r, CI)
+description: Обробка та перевірка текстових файлів, oxfmt, cspell, markdownlint-cli2, v8r, CI
 alwaysApply: true
-version: '1.24'
+version: '1.25'
 ---
 
-**cspell**, **markdownlint-cli2**, **[v8r](https://chris48s.github.io/v8r/)** ([Schema Store](https://www.schemastore.org/)), розширення **DavidAnson.vscode-markdownlint**, workflow **`lint-text`**.
+**oxfmt** (`.oxfmtrc.json`, редактор), **cspell**, **markdownlint-cli2**, **[v8r](https://chris48s.github.io/v8r/)** ([Schema Store](https://www.schemastore.org/)), розширення **DavidAnson.vscode-markdownlint**, workflow **`lint-text`**.
 
 ```json title=".vscode/extensions.json"
 {
@@ -24,10 +24,92 @@ version: '1.24'
   "files.associations": {
     "*.env.*": "env",
     "*.env": "env"
-  }
+  },
+  "editor.formatOnSave": true,
+  "[css]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[graphql]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[handlebars]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[html]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[json5]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[less]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[mdx]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[scss]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[toml]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "oxc.path.oxfmt": "/opt/homebrew/bin/oxfmt"
 }
 ```
 
+У корені проєкту має бути файл з правилами форматування для **oxfmt**:
+
+```json title=".oxfmtrc.json"
+{
+  "ignorePatterns": ["**/hasura/metadata/**", "**/schema.graphql"],
+  "arrowParens": "avoid",
+  "printWidth": 120,
+  "bracketSpacing": true,
+  "bracketSameLine": true,
+  "embeddedLanguageFormatting": "auto",
+  "endOfLine": "lf",
+  "htmlWhitespaceSensitivity": "css",
+  "insertPragma": false,
+  "jsxSingleQuote": true,
+  "proseWrap": "preserve",
+  "quoteProps": "as-needed",
+  "requirePragma": false,
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "none",
+  "useTabs": false,
+  "vueIndentScriptAndStyle": false
+}
+```
+
+Поле **`ignorePatterns`** додавай за потреби (наприклад згенеровані каталоги); якщо виключень немає — ключ можна опустити.
+
+Також потрібно прибрати, якщо є в проєкті, модуль **`@nitra/prettier-config`**, **prettier** та всі виклики prettier і налаштування для нього.
+
+Завжди пиши **JSDoc** до функцій та методів.
+
 **`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**. Для української додай **`@cspell/dict-uk-ua`**. **`markdownlint-cli2`** викликай у `lint-text` лише через **`bunx markdownlint-cli2`**, не додавай пакет до devDependencies. **`v8r`** лише через **`bunx v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
 
 У v8r **немає** прапорця тихого режиму; рекомендовано скрипт **`run-v8r.mjs`** з репозиторію пакета `@nitra/cursor` (`npm/scripts/run-v8r.mjs`): один виклик у `lint-text` — під капотом послідовні **`bunx v8r`** для кожного типу (**json**, **json5**, **yml**, **yaml**, **toml**), бо один процес v8r з кількома глобами падає з **98**, якщо хоч один glob порожній, і тоді інші розширення не перевіряються. Вивід при кодах **0** і **98** не показується. Каталог схем **`schemas/v8r-catalog.json`** пакета `@nitra/cursor` скрипт підставляє в v8r сам. За бажання можна передати власні glob-и аргументами скрипта. Шлях до скрипта: `./npm/scripts/…`, `./scripts/…` після копіювання, або `node_modules/@nitra/cursor/scripts/…`.
@@ -215,4 +297,4 @@ jobs:
 
 ## Перевірка
 
-`npx @nitra/cursor check text`
+`npx @nitra/cursor check text` (охоплює oxfmt, cspell, markdownlint, v8r, CI для `lint-text`)

package/mdc/vue.mdc

@@ -108,7 +108,7 @@ const additionalInstructions = `
 
 ### Інструменти (узгоджено з Vite і цим правилом)
 
-- Якість коду: **ESLint** + **eslint-plugin-vue**; форматування — **oxfmt**, див. `js-format.mdc`.
+- Якість коду: **ESLint** + **eslint-plugin-vue**; форматування — **oxfmt**, див. `text.mdc`.
 - Збірка та dev-сервер — **Vite**
 - **Vue Devtools** для дебагу; продакшен-збірка — **`vite build`**, оптимізація асетів і кешування на рівні деплою / CDN.
 

package/package.json

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

package/scripts/check-abie.mjs

@@ -8,6 +8,8 @@
  * **`phpdocker-io/github-actions-delete-abandoned-branches`** у **`with.ignore_branches`** мають бути
  * **dev**, **ua** та **ru** (разом з іншими гілками, якщо потрібно).
  *
+ * **Firebase Hosting:** у корені репозиторію не має бути **`.firebaserc`**, **`firebase.json`** та каталогу **`.firebase/`**.
+ *
  * **k8s:** якщо під деревом із сегментом **`k8s`** є YAML з **`kind: Deployment`**, у тій самій директорії
  * має існувати **`hc.yaml`** із **`HealthCheckPolicy`** (**`networking.gke.io/v1`**), modeline **`$schema`**
  * як у abie.mdc, **`/healthz`**, порт **8080**, **`targetRef`** на **Service** з тим самим **`metadata.name`**.
@@ -968,6 +970,30 @@ async function ensureUaRuAbieHttpRoutePatches(root, yamlFilesAbs, fail, passFn)
   }
 }
 
+/**
+ * Перевіряє відсутність артефактів Firebase Hosting у корені репозиторію (abie.mdc).
+ * @param {string} root корінь репозиторію
+ * @param {(msg: string) => void} passFn успішне повідомлення
+ * @param {(msg: string) => void} failFn повідомлення про порушення
+ * @returns {void}
+ */
+function ensureNoFirebaseHostingArtifacts(root, passFn, failFn) {
+  for (const name of ['.firebaserc', 'firebase.json']) {
+    const abs = join(root, name)
+    if (existsSync(abs)) {
+      failFn(`Знайдено заборонений файл Firebase Hosting: ${name} — видали його (abie.mdc)`)
+    } else {
+      passFn(`Немає ${name}`)
+    }
+  }
+  const firebaseDir = join(root, '.firebase')
+  if (existsSync(firebaseDir)) {
+    failFn('Знайдено директорію .firebase — видали її (abie.mdc)')
+  } else {
+    passFn('Немає .firebase/')
+  }
+}
+
 /**
  * Перевіряє відповідність проєкту правилам abie.mdc.
  * @returns {Promise<number>} 0 — OK, 1 — є порушення
@@ -984,6 +1010,7 @@ export async function check() {
   }
 
   pass('Правило abie увімкнено — виконуємо перевірки')
+  ensureNoFirebaseHostingArtifacts(root, pass, fail)
 
   const cleanMergedPath = join(root, '.github/workflows/clean-merged-branch.yml')
   if (existsSync(cleanMergedPath)) {

package/scripts/check-k8s.mjs

@@ -47,6 +47,8 @@
  * **`apiVersion`, `kind`, `type`** (для CRD без поля `type` у маніфесті — зірочка **`*`** як третій
  * компонент). Спочатку шукається збіг за фактичним `type`, потім за **`*`**.
  * Dockerfile — правило docker.mdc, скрипт check-docker.mjs.
+ *
+ * Структура **`HTTPRoute`** для **Deployment** з образом **`hasura/graphql-engine`** (редиректи **`/ql`**, **WebSocket**, **`URLRewrite`**) — лише в **k8s.mdc**, автоматично не звіряється.
  */
 import { existsSync } from 'node:fs'
 import { readFile, stat, unlink } from 'node:fs/promises'

package/scripts/check-text.mjs

@@ -1,10 +1,13 @@
 /**
- * Перевіряє текстовий стек за правилом text.mdc.
+ * Перевіряє текстовий стек і форматування за правилом text.mdc.
+ *
+ * oxfmt: `.oxfmtrc.json` з обовʼязковими ключами, VSCode (formatOnSave, defaultFormatter для js/ts/json/vue/css/html),
+ * відсутність Prettier у конфігах і залежностях.
  *
  * cspell, markdownlint через `bunx markdownlint-cli2` у `lint-text` (без оголошення пакета в package.json), заборона
  * `markdownlint-cli2` у dependencies/devDependencies, v8r (`run-v8r.mjs` або чотири `bunx v8r`),
  * `.v8rignore` (vscode JSON),
- * workflow `lint-text.yml`, розширення VSCode для markdownlint.
+ * workflow `lint-text.yml`, розширення VSCode (markdownlint, oxc).
  *
  * Якщо є `.cursor/rules/n-text.mdc` і/або `npm/mdc/text.mdc` — перевіряє наявність абзацу про український
  * апостроф (U+0027 vs U+2019) і приклад з символом U+2019 у тексті.
@@ -43,7 +46,7 @@ function verifyUkApostropheRuleParagraph(filePath, body, failFn, passFn) {
 }
 
 /**
- * Перевіряє відповідність проєкту правилам text.mdc (cspell, markdownlint через bunx, v8r)
+ * Перевіряє відповідність проєкту правилам text.mdc (oxfmt, cspell, markdownlint через bunx, v8r)
  * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
  */
 export async function check() {
@@ -79,6 +82,11 @@ export async function check() {
       } else {
         fail('extensions.json: додай "DavidAnson.vscode-markdownlint" у recommendations (див. n-text.mdc)')
       }
+      if (Array.isArray(rec) && rec.includes('oxc.oxc-vscode')) {
+        pass('extensions.json містить oxc.oxc-vscode')
+      } else {
+        fail('extensions.json: додай "oxc.oxc-vscode" у recommendations (див. n-text.mdc)')
+      }
     } catch {
       fail('.vscode/extensions.json — невалідний JSON')
     }
@@ -86,6 +94,63 @@ export async function check() {
     fail('.vscode/extensions.json не існує — створи з recommendations згідно n-text.mdc')
   }
 
+  if (existsSync('.vscode/settings.json')) {
+    try {
+      const settings = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
+      if (settings['editor.formatOnSave'] === true) {
+        pass('settings.json: editor.formatOnSave увімкнено')
+      } else {
+        fail('settings.json: editor.formatOnSave має бути true')
+      }
+      const fmtTypes = ['javascript', 'typescript', 'json', 'vue', 'css', 'html']
+      for (const t of fmtTypes) {
+        const key = `[${t}]`
+        if (settings[key]?.['editor.defaultFormatter'] === 'oxc.oxc-vscode') {
+          pass(`settings.json: ${key} використовує oxc.oxc-vscode`)
+        } else {
+          fail(`settings.json: ${key} має використовувати oxc.oxc-vscode як defaultFormatter`)
+        }
+      }
+    } catch {
+      fail('.vscode/settings.json — невалідний JSON')
+    }
+  } else {
+    fail('.vscode/settings.json не існує — створи згідно n-text.mdc')
+  }
+
+  const expectedOxfmtKeys = [
+    'arrowParens',
+    'printWidth',
+    'bracketSpacing',
+    'bracketSameLine',
+    'semi',
+    'singleQuote',
+    'tabWidth',
+    'trailingComma',
+    'useTabs'
+  ]
+  if (existsSync('.oxfmtrc.json')) {
+    const cfg = JSON.parse(await readFile('.oxfmtrc.json', 'utf8'))
+    const missing = expectedOxfmtKeys.filter(k => !(k in cfg))
+    if (missing.length === 0) {
+      pass('.oxfmtrc.json містить всі обовʼязкові ключі')
+    } else {
+      fail(`.oxfmtrc.json відсутні ключі: ${missing.join(', ')}`)
+    }
+    if (cfg.semi !== false) fail('.oxfmtrc.json: semi має бути false')
+    if (cfg.singleQuote !== true) fail('.oxfmtrc.json: singleQuote має бути true')
+    if (cfg.tabWidth !== 2) fail('.oxfmtrc.json: tabWidth має бути 2')
+    if (cfg.useTabs !== false) fail('.oxfmtrc.json: useTabs має бути false')
+    if (cfg.printWidth !== 120) fail('.oxfmtrc.json: printWidth має бути 120')
+  } else {
+    fail('.oxfmtrc.json не існує — створи його')
+  }
+
+  const prettierFiles = ['.prettierrc', '.prettierrc.json', '.prettierrc.js', 'prettier.config.js', '.prettierrc.yml']
+  for (const f of prettierFiles) {
+    if (existsSync(f)) fail(`Знайдено конфіг prettier: ${f} — видали його`)
+  }
+
   if (existsSync('.markdownlint-cli2.jsonc')) {
     try {
       const ml = JSON.parse(await readFile('.markdownlint-cli2.jsonc', 'utf8'))
@@ -145,6 +210,12 @@ export async function check() {
 
   if (existsSync('package.json')) {
     const pkg = JSON.parse(await readFile('package.json', 'utf8'))
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
+    for (const dep of ['prettier', '@nitra/prettier-config']) {
+      if (allDeps[dep]) fail(`package.json містить залежність ${dep} — видали її`)
+    }
+    if (pkg.prettier) fail('package.json містить поле "prettier" — видали його')
+
     const devDeps = pkg.devDependencies || {}
 
     if (devDeps['@nitra/cspell-dict']) {

package/scripts/upgrade-nitra-cursor-and-install.mjs

@@ -0,0 +1,201 @@
+/**
+ * Перед синхронізацією правил CLI підтягує останню опубліковану версію `@nitra/cursor` з npm registry
+ * у кореневий `package.json` і запускає `bun i` у корені проєкту.
+ *
+ * Якщо залежність уже задана через `workspace:`, `file:`, `link:` тощо, запис у registry не
+ * змінюється і `bun i` не викликається — так зберігається робота монорепо та сценаріїв з `workspace:`, `file:` чи `link:`.
+ *
+ * Після встановлення повертається шлях до `node_modules/@nitra/cursor`, якщо каталог з
+ * `package.json` існує; інакше — fallback (корінь пакету поточного процесу CLI, наприклад кеш npx).
+ */
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { existsSync } from 'node:fs'
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+const PACKAGE_NAME = '@nitra/cursor'
+const NPM_LATEST_URL = 'https://registry.npmjs.org/@nitra/cursor/latest'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * Чи не можна безпечно підставити semver з npm замість поточного специфікатора залежності.
+ * @param {string} specifier значення з package.json
+ * @returns {boolean} true — залишити як є (монорепо, git, tarball тощо)
+ */
+export function shouldSkipNpmVersionUpgrade(specifier) {
+  const s = String(specifier).trim()
+  if (!s) {
+    return true
+  }
+  if (/^workspace:/i.test(s)) {
+    return true
+  }
+  if (/^file:/i.test(s)) {
+    return true
+  }
+  if (/^link:/i.test(s)) {
+    return true
+  }
+  if (/^portal:/i.test(s)) {
+    return true
+  }
+  if (/^git(\+|:\/\/)/i.test(s)) {
+    return true
+  }
+  if (/^npm:/i.test(s)) {
+    return true
+  }
+  if (/^https?:\/\//i.test(s)) {
+    return true
+  }
+  if (s.startsWith('./') || s.startsWith('../')) {
+    return true
+  }
+  return false
+}
+
+/**
+ * Остання версія пакета з npm (поле `version` у JSON dist-tag `latest`).
+ * @returns {Promise<string>} semver без префікса `^`
+ */
+export async function fetchLatestNitraCursorVersionFromNpm() {
+  const res = await fetch(NPM_LATEST_URL, {
+    headers: { accept: 'application/json' }
+  })
+  if (!res.ok) {
+    throw new Error(`npm registry: ${res.status} ${res.statusText} для ${PACKAGE_NAME}`)
+  }
+  const data = await res.json()
+  if (!data || typeof data.version !== 'string' || !data.version.trim()) {
+    throw new Error(`npm registry: у відповіді для ${PACKAGE_NAME} немає поля version`)
+  }
+  return data.version.trim()
+}
+
+/**
+ * Шлях до встановленого пакета в `node_modules` або fallback.
+ * @param {string} projectRoot корінь репозиторію
+ * @param {string} fallbackPackageRoot корінь пакету з поточного процесу
+ * @returns {string} абсолютний шлях до каталогу з `mdc/`, `scripts/` тощо
+ */
+export function resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot) {
+  const installed = join(projectRoot, 'node_modules', PACKAGE_NAME)
+  if (existsSync(join(installed, 'package.json'))) {
+    return installed
+  }
+  return fallbackPackageRoot
+}
+
+/**
+ * Запускає `bun i` у вказаному каталозі з виводом у поточний stdio.
+ * @param {string} projectRoot cwd для процесу
+ * @returns {Promise<void>} завершується після успішного `bun i`
+ */
+async function runBunInstall(projectRoot) {
+  try {
+    await execFileAsync('bun', ['i'], { cwd: projectRoot, stdio: 'inherit' })
+  } catch (error) {
+    const exitCode = typeof error?.code === 'number' ? error.code : null
+    if (exitCode !== null && exitCode !== 0) {
+      throw new Error(`bun i завершився з кодом ${exitCode}`)
+    }
+    throw error
+  }
+}
+
+/**
+ * Де зараз оголошено `@nitra/cursor` у package.json.
+ * @param {Record<string, unknown>} pkg вміст package.json як об'єкт після читання JSON
+ * @returns {{ section: 'devDependencies' | 'dependencies', value: string } | null} секція та специфікатор або null, якщо залежності немає
+ */
+function findNitraCursorDependency(pkg) {
+  const dev = pkg.devDependencies
+  if (dev && typeof dev === 'object' && !Array.isArray(dev) && PACKAGE_NAME in dev) {
+    const value = dev[PACKAGE_NAME]
+    if (typeof value === 'string') {
+      return { section: 'devDependencies', value }
+    }
+  }
+  const deps = pkg.dependencies
+  if (deps && typeof deps === 'object' && !Array.isArray(deps) && PACKAGE_NAME in deps) {
+    const value = deps[PACKAGE_NAME]
+    if (typeof value === 'string') {
+      return { section: 'dependencies', value }
+    }
+  }
+  return null
+}
+
+/**
+ * Оновлює `@nitra/cursor` до `^<latest>` з npm (якщо дозволено специфікатором), виконує `bun i`,
+ * повертає корінь пакету для читання `mdc/` та інших файлів синхронізації.
+ * @param {string} projectRoot корінь цільового репозиторію (`cwd()`)
+ * @param {string} fallbackPackageRoot корінь пакету з `import.meta.url` (кеш npx або workspace)
+ * @returns {Promise<string>} абсолютний шлях до кореня `@nitra/cursor` для копіювання файлів
+ */
+export async function upgradeNitraCursorToLatestAndBunInstall(projectRoot, fallbackPackageRoot) {
+  const pkgPath = join(projectRoot, 'package.json')
+  if (!existsSync(pkgPath)) {
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  let raw
+  try {
+    raw = await readFile(pkgPath, 'utf8')
+  } catch {
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  let pkg
+  try {
+    pkg = JSON.parse(raw)
+  } catch {
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  if (pkg === null || typeof pkg !== 'object' || Array.isArray(pkg)) {
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  const found = findNitraCursorDependency(pkg)
+
+  if (found && shouldSkipNpmVersionUpgrade(found.value)) {
+    console.log(`⏭️  ${PACKAGE_NAME}: специфікатор «${found.value}» — без оновлення з npm та без bun i\n`)
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  const latest = await fetchLatestNitraCursorVersionFromNpm()
+  const desired = `^${latest}`
+
+  if (!found) {
+    if (!pkg.devDependencies || typeof pkg.devDependencies !== 'object' || Array.isArray(pkg.devDependencies)) {
+      pkg.devDependencies = {}
+    }
+    pkg.devDependencies[PACKAGE_NAME] = desired
+    await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8')
+    console.log(`📝 Додано ${PACKAGE_NAME}@${desired} у devDependencies (остання з npm)\n`)
+    await runBunInstall(projectRoot)
+    console.log(`📦 Виконано bun i у корені проєкту\n`)
+    return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+  }
+
+  if (found.value === desired) {
+    console.log(`📌 ${PACKAGE_NAME} уже ${desired} у package.json — виконуємо bun i\n`)
+  } else {
+    if (found.section === 'devDependencies') {
+      pkg.devDependencies[PACKAGE_NAME] = desired
+    } else {
+      pkg.dependencies[PACKAGE_NAME] = desired
+    }
+    await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8')
+    console.log(`📝 Оновлено ${PACKAGE_NAME} → ${desired} у package.json\n`)
+  }
+
+  await runBunInstall(projectRoot)
+  console.log(`📦 Виконано bun i у корені проєкту\n`)
+
+  return resolveInstalledPackageRoot(projectRoot, fallbackPackageRoot)
+}

package/mdc/js-format.mdc

@@ -1,103 +0,0 @@
----
-description: Правила форматів JavaScript ecosystem
-alwaysApply: true
-version: '1.3'
----
-
-В корені проекту є файл з правилами форматування для oxfmt:
-
-```json title=".oxfmtrc.json"
-{
-  "arrowParens": "avoid",
-  "printWidth": 120,
-  "bracketSpacing": true,
-  "bracketSameLine": true,
-  "embeddedLanguageFormatting": "auto",
-  "endOfLine": "lf",
-  "htmlWhitespaceSensitivity": "css",
-  "insertPragma": false,
-  "jsxSingleQuote": true,
-  "proseWrap": "preserve",
-  "quoteProps": "as-needed",
-  "requirePragma": false,
-  "semi": false,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "none",
-  "useTabs": false,
-  "vueIndentScriptAndStyle": false
-}
-```
-
-в файлі .vscode/extensions.json є налаштування для oxfmt:
-
-```json title=".vscode/extensions.json"
-{
-  "recommendations": ["oxc.oxc-vscode"]
-}
-```
-
-в файлі .vscode/settings.json є налаштування для oxfmt:
-
-```json title=".vscode/settings.json"
-{
-  "editor.formatOnSave": true,
-  "[css]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[graphql]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[handlebars]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[html]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[json5]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[less]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[markdown]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[mdx]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[scss]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[toml]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[vue]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "[yaml]": {
-    "editor.defaultFormatter": "oxc.oxc-vscode"
-  },
-  "oxc.path.oxfmt": "/opt/homebrew/bin/oxfmt"
-}
-```
-
-Також потрібно прибрати якщо є в проекті модул @nitra/prettier-config та prettier та всі виклики prettier і налаштування для нього.
-
-Завжди пиши JSDoc до функцій та методів.
-
-## Перевірка
-
-`npx @nitra/cursor check js-format`

package/scripts/check-js-format.mjs

@@ -1,96 +0,0 @@
-/**
- * Перевіряє форматування коду за правилом js-format.mdc.
- *
- * `.oxfmtrc.json` з потрібними ключами, VSCode і oxfmt, відсутність Prettier у конфігах і залежностях.
- */
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-
-import { createCheckReporter } from './utils/check-reporter.mjs'
-
-/**
- * Перевіряє відповідність проєкту правилам js-format.mdc
- * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
- */
-export async function check() {
-  const reporter = createCheckReporter()
-  const { pass, fail } = reporter
-
-  const expectedKeys = [
-    'arrowParens',
-    'printWidth',
-    'bracketSpacing',
-    'bracketSameLine',
-    'semi',
-    'singleQuote',
-    'tabWidth',
-    'trailingComma',
-    'useTabs'
-  ]
-
-  if (existsSync('.oxfmtrc.json')) {
-    const cfg = JSON.parse(await readFile('.oxfmtrc.json', 'utf8'))
-    const missing = expectedKeys.filter(k => !(k in cfg))
-    if (missing.length === 0) {
-      pass('.oxfmtrc.json містить всі обовʼязкові ключі')
-    } else {
-      fail(`.oxfmtrc.json відсутні ключі: ${missing.join(', ')}`)
-    }
-
-    if (cfg.semi !== false) fail('.oxfmtrc.json: semi має бути false')
-    if (cfg.singleQuote !== true) fail('.oxfmtrc.json: singleQuote має бути true')
-    if (cfg.tabWidth !== 2) fail('.oxfmtrc.json: tabWidth має бути 2')
-    if (cfg.useTabs !== false) fail('.oxfmtrc.json: useTabs має бути false')
-    if (cfg.printWidth !== 120) fail('.oxfmtrc.json: printWidth має бути 120')
-  } else {
-    fail('.oxfmtrc.json не існує — створи його')
-  }
-
-  if (existsSync('.vscode/extensions.json')) {
-    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
-    if (ext.recommendations?.includes('oxc.oxc-vscode')) {
-      pass('extensions.json містить oxc.oxc-vscode')
-    } else {
-      fail('extensions.json не містить oxc.oxc-vscode')
-    }
-  } else {
-    fail('.vscode/extensions.json не існує')
-  }
-
-  if (existsSync('.vscode/settings.json')) {
-    const settings = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
-    if (settings['editor.formatOnSave'] === true) {
-      pass('settings.json: editor.formatOnSave увімкнено')
-    } else {
-      fail('settings.json: editor.formatOnSave має бути true')
-    }
-
-    const fmtTypes = ['javascript', 'typescript', 'json', 'vue', 'css', 'html']
-    for (const t of fmtTypes) {
-      const key = `[${t}]`
-      if (settings[key]?.['editor.defaultFormatter'] === 'oxc.oxc-vscode') {
-        pass(`settings.json: ${key} використовує oxc.oxc-vscode`)
-      } else {
-        fail(`settings.json: ${key} має використовувати oxc.oxc-vscode як defaultFormatter`)
-      }
-    }
-  } else {
-    fail('.vscode/settings.json не існує')
-  }
-
-  const prettierFiles = ['.prettierrc', '.prettierrc.json', '.prettierrc.js', 'prettier.config.js', '.prettierrc.yml']
-  for (const f of prettierFiles) {
-    if (existsSync(f)) fail(`Знайдено конфіг prettier: ${f} — видали його`)
-  }
-
-  if (existsSync('package.json')) {
-    const pkg = JSON.parse(await readFile('package.json', 'utf8'))
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies }
-    for (const dep of ['prettier', '@nitra/prettier-config']) {
-      if (allDeps[dep]) fail(`package.json містить залежність ${dep} — видали її`)
-    }
-    if (pkg.prettier) fail('package.json містить поле "prettier" — видали його')
-  }
-
-  return reporter.getExitCode()
-}