@nitra/cursor 1.7.1 → 1.8.1

package/bin/n-cursor.js

@@ -20,10 +20,16 @@
  * Після завантаження: у .cursor/rules видаляються файли *.mdc з префіксом «n-» (керовані
  * пакетом), яких немає у списку rules у .n-cursor.json. Інші .mdc у цій директорії залишаються.
  *
+ * Composite GitHub Action `.github/actions/setup-bun-deps/action.yml` копіюється з каталогу
+ * `github-actions/` пакету при кожному успішному синку (workflows з правил ga / js-lint / text).
+ *
  * Skills копіюються з npm/skills пакету лише для id з масиву «skills» у .n-cursor.json
  * (у JSON — без префікса, каталоги в проєкті — n-<id>, як і для правил). Якщо ключа skills
  * немає, за замовчуванням підтягуються всі bundled skills з префіксом n- у пакеті.
  * Зайві каталоги n-* у .cursor/skills, яких немає у списку, видаляються.
+ *
+ * Якщо в корені є package.json і в ньому ще немає \@nitra/cursor у devDependencies (і не оголошено
+ * в dependencies), CLI дописує devDependencies з діапазоном ^<version> поточного пакету — зручно після npx.
  */
 
 import { existsSync } from 'node:fs'
@@ -32,6 +38,12 @@ 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 { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
+
 const PACKAGE_NAME = '@nitra/cursor'
 const CONFIG_FILE = '.n-cursor.json'
 /** Публічний URL JSON Schema для поля `$schema` у `.n-cursor.json` (IDE); вміст правил CLI читає лише з диска пакету */
@@ -47,6 +59,8 @@ const BUNDLED_MDC_DIR = join(binDir, '..', 'mdc')
 const BUNDLED_SCRIPTS_DIR = join(binDir, '..', 'scripts')
 const BUNDLED_SKILLS_DIR = join(binDir, '..', 'skills')
 const BUNDLED_AGENTS_TEMPLATE_PATH = join(binDir, '..', AGENTS_TEMPLATE_FILE)
+/** Корінь установленого пакету (каталог з `mdc/`, `github-actions/`, …) */
+const BUNDLED_PACKAGE_ROOT = join(binDir, '..')
 
 /**
  * Імена правил (без .mdc) з каталогу mdc поточної інсталяції пакету
@@ -205,24 +219,6 @@ function readBundledRuleContent(rule) {
   return readFile(bundledPath, 'utf8')
 }
 
-/**
- * Версія з `package.json` установленого пакету (каталог поруч із `bin/`).
- * @returns {Promise<string | null>} поле `version` рядком або `null`, якщо файлу немає / помилка парсингу
- */
-async function readBundledPackageVersion() {
-  const pkgPath = join(binDir, '..', 'package.json')
-  if (!existsSync(pkgPath)) {
-    return null
-  }
-  try {
-    const raw = await readFile(pkgPath, 'utf8')
-    const pkg = JSON.parse(raw)
-    return typeof pkg.version === 'string' ? pkg.version : null
-  } catch {
-    return null
-  }
-}
-
 /**
  * Нормалізує id skill з конфігу до форми без префікса n- (як «fix»)
  * @param {string} skillName елемент масиву skills або ім'я каталогу
@@ -651,6 +647,14 @@ async function runSync() {
   console.log(`📋 Правил до завантаження: ${rules.length}`)
   console.log(`📋 Skills до синхронізації: ${skills.length}`)
 
+  try {
+    const { destPath } = await syncSetupBunDepsAction(cwd(), BUNDLED_PACKAGE_ROOT)
+    console.log(`📝 Оновлено ${destPath} (composite setup-bun-deps з пакету)\n`)
+  } catch (error) {
+    console.error(`❌ Не вдалося записати setup-bun-deps action: ${error.message}`)
+    throw error
+  }
+
   const rulesDir = join(cwd(), RULES_DIR)
   await mkdir(rulesDir, { recursive: true })
 
@@ -724,6 +728,7 @@ async function runSync() {
 const [command, ...args] = process.argv.slice(2)
 
 try {
+  await ensureNitraCursorInRootDevDependencies(cwd())
   if (command === 'check') {
     await runChecks(args)
   } else {

package/github-actions/setup-bun-deps/action.yml

@@ -0,0 +1,29 @@
+name: Setup Bun dependencies
+description: Checkout, Node 24, Bun, cache та bun install --frozen-lockfile
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/checkout@v6
+      with:
+        persist-credentials: false
+
+    - uses: actions/setup-node@v6
+      with:
+        node-version: '24'
+
+    - uses: oven-sh/setup-bun@v2
+
+    - name: Cache Bun dependencies
+      uses: actions/cache@v5
+      with:
+        path: |
+          ~/.bun/install/cache
+          node_modules
+        key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-bun-
+
+    - name: Install dependencies
+      run: bun install --frozen-lockfile
+      shell: bash

package/mdc/bun.mdc

@@ -62,10 +62,14 @@ FROM oven/bun:alpine AS build-env
 В Github actions bun повинен налаштований так:
 
 ```yaml
+- uses: actions/setup-node@v6
+  with:
+    node-version: '24'
+
 - uses: oven-sh/setup-bun@v2
 
 - name: Cache Bun dependencies
-  uses: actions/cache@v4
+  uses: actions/cache@v5
   with:
     path: |
       ~/.bun/install/cache

package/mdc/docker.mdc

@@ -45,12 +45,6 @@ on:
       - '**/Dockerfile'
       - '**/*.Dockerfile'
       - '**/*.dockerfile'
-      - '.hadolint.yaml'
-      - 'npm/scripts/run-docker.mjs'
-      - 'npm/scripts/utils/docker-hadolint.mjs'
-      - 'npm/scripts/check-docker.mjs'
-      - 'npm/mdc/docker.mdc'
-      - 'package.json'
 
   pull_request:
     branches:
@@ -66,7 +60,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
@@ -76,10 +70,14 @@ jobs:
           chmod +x /tmp/hadolint
           sudo mv /tmp/hadolint /usr/local/bin/hadolint
 
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+
       - uses: oven-sh/setup-bun@v2
 
       - name: Cache Bun dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.bun/install/cache

package/mdc/ga.mdc

@@ -26,7 +26,7 @@ jobs:
       contents: read
     steps:
       - name: Delete workflow runs
-        uses: dmvict/clean-workflow-runs@v1.0.0
+        uses: dmvict/clean-workflow-runs@v1
         with:
           token: ${{ github.token }}
           save_period: 31
@@ -55,7 +55,7 @@ jobs:
     steps:
       - id: delete_stuff
         name: Delete those pesky dead branches
-        uses: phpdocker-io/github-actions-delete-abandoned-branches@v2
+        uses: phpdocker-io/github-actions-delete-abandoned-branches@v2.0.3
         with:
           github_token: ${{ github.token }}
           last_commit_age_days: 90
@@ -80,11 +80,8 @@ on:
     branches:
       - dev
     paths:
+      - '.github/actions/**'
       - '.github/workflows/**'
-      - '.github/zizmor.yml'
-      - 'package.json'
-      - 'bun.lock'
-
   pull_request:
     branches:
       - dev
@@ -99,31 +96,16 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
+      - uses: ./.github/actions/setup-bun-deps
 
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
-        with:
-          path: |
-            ~/.bun/install/cache
-            node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - uses: astral-sh/setup-uv@v6
+      - uses: astral-sh/setup-uv@v8.0.0
 
       - name: Lint GA
         run: bun run lint-ga
 ```
 
+Composite **`.github/actions/setup-bun-deps/action.yml`**: **`actions/checkout@v6`** (`persist-credentials: false`), **`actions/setup-node@v6`** (**Node 24**), **Bun**, **`actions/cache@v5`** і **`bun install --frozen-lockfile`**. У job достатньо **`- uses: ./.github/actions/setup-bun-deps`**.
+
 ```json title=".vscode/extensions.json"
 {
   "recommendations": ["github.vscode-github-actions"]

package/mdc/js-lint.mdc

@@ -71,7 +71,6 @@ on:
       - '**/*.tsx'
       - '**/*.vue'
       - '**/eslint.config.*'
-      - '.jscpd.json'
 
   pull_request:
     branches:
@@ -87,24 +86,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
-        with:
-          path: |
-            ~/.bun/install/cache
-            node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
+      - uses: ./.github/actions/setup-bun-deps
 
       - name: Eslint
         run: |
@@ -113,6 +95,8 @@ jobs:
           bunx jscpd .
 ```
 
+Composite **`.github/actions/setup-bun-deps/action.yml`** — checkout, Node 24, Bun, кеш і `bun install --frozen-lockfile` (див. **ga.mdc**).
+
 Один workflow на лінт JS; зайвий `lint.yml` з тими самими кроками — прибери.
 
 ```javascript title="eslint.config.js"

package/mdc/k8s.mdc

@@ -1,6 +1,6 @@
 ---
 description: K8s YAML — $schema (yaml-language-server); lint-k8s (kubeconform, kubescape); check-k8s
-version: '1.8'
+version: '1.10'
 globs: "**/k8s/**/*.{yaml,yml}"
 alwaysApply: false
 ---
@@ -72,7 +72,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
@@ -86,10 +86,14 @@ jobs:
           curl -s https://raw.githubusercontent.com/kubescape/kubescape/master/install.sh | /bin/bash
           echo "$HOME/.kubescape/bin" >> $GITHUB_PATH
 
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+
       - uses: oven-sh/setup-bun@v2
 
       - name: Cache Bun dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.bun/install/cache
@@ -117,10 +121,10 @@ jobs:
 
 ## Що закодовано в `check-k8s.mjs`
 
-При зміні правил синхронно оновлюй **`YANNH_PIN`**, **`YANNH_REF`** (якщо зміниться гілка за замовчуванням у репо yannh), **`YANNH_GROUPS`**, а в **`run-k8s.mjs`** — константу **`KUBERNETES_VERSION`** (число з PIN, наприклад `v1.33.9-standalone-strict` → **`1.33.9`**).
+При зміні правил синхронно оновлюй **`YANNH_PIN`**, **`YANNH_REF`** (якщо зміниться гілка за замовчуванням у репо yannh), **`YANNH_GROUPS`**, **`DATREE_CRD_BASE`** (GitHub Pages каталогу CRD), а в **`run-k8s.mjs`** — константу **`KUBERNETES_VERSION`** і **`DATREE_CRD_SCHEMA_LOCATION`** (узгоджено з базою datree у цьому правилі).
 
 - Обхід з пропуском `node_modules`, `.git`, `dist`, `coverage`, `.turbo`, `.next`.
-- **`file:`** у `$schema` — URL до apiVersion/kind не звіряється; **`https:`** — kustomization за іменем файлу → Schema Store; `v1` → yannh; група з `YANNH_GROUPS` → yannh; інакше → datree.
+- **`file:`** у `$schema` — URL до apiVersion/kind не звіряється; **`https:`** — kustomization за іменем файлу → Schema Store; `v1` → yannh; група з `YANNH_GROUPS` → yannh; інакше → datree (GitHub Pages).
 
 ## Коли застосовувати (агентам)
 
@@ -138,8 +142,22 @@ jobs:
 3. **`apiVersion: group/version`** і **group** у **`YANNH_GROUPS`** у скрипті → yannh:
    `https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/<PIN>/<kind>-<group-з-крапками-як-дефіси>-<version>.json`
    Приклади: `apps/v1` + `Deployment` → `deployment-apps-v1.json`; `networking.k8s.io/v1` + `Ingress` → `ingress-networking-k8s-io-v1.json`.
-4. **Інакше** (CRD тощо) → [datreeio/CRDs-catalog](https://github.com/datreeio/CRDs-catalog):
-   `https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/CRDs/<group>/<kind>_<version>.json`
+4. **Інакше** (CRD тощо) → [datreeio/CRDs-catalog](https://github.com/datreeio/CRDs-catalog) через **GitHub Pages** (канон для `$schema` у редакторі):
+   `https://datreeio.github.io/CRDs-catalog/<group>/<kind>_<version>.json`
+   (`<kind>` — лише літери та цифри в нижньому регістрі, без роздільників між CamelCase, як для yannh.)
+
+   **Приклад (Gateway API):** `apiVersion: gateway.networking.k8s.io/v1beta1`, `kind: HTTPRoute`:
+
+   ```yaml
+   # yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/gateway.networking.k8s.io/httproute_v1beta1.json
+   ```
+
+   **Приклад (GKE):** `apiVersion: networking.gke.io/v1`, `kind: HealthCheckPolicy`:
+
+   ```yaml
+   # yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/networking.gke.io/healthcheckpolicy_v1.json
+   ```
+
 5. **Немає надійного публічного URL** — не вигадуй: залиш коректний `$schema` або `file:` за узгодженням.
 
 ## Багатодокументні YAML

package/mdc/npm-module.mdc

@@ -8,7 +8,7 @@ Bun monorepo: workspace **`npm/`**, кореневий **`package.json`**, **`.g
 
 ## npm publish
 
-**`npm-publish.yml`:** push у **`main`**, **`paths: npm/**`**, **`JS-DevTools/npm-publish@v4`**, **`with.package: npm/package.json`**, **`permissions.id-token: write`** (OIDC на npm).
+**`npm-publish.yml`:** push у **`main`**, **`on.push.paths`** з **`npm/**`**, **`JS-DevTools/npm-publish@v4.1.5`**, **`with.package: npm/package.json`**, **`permissions.id-token: write`** (OIDC на npm).
 
 ```yaml title=".github/workflows/npm-publish.yml"
 name: npm-publish
@@ -32,17 +32,17 @@ jobs:
       id-token: write # КРИТИЧНО для OIDC!
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
           node-version: '24' # includes npm@11.6.0
           registry-url: 'https://registry.npmjs.org'
 
       - name: Publish package
-        uses: JS-DevTools/npm-publish@v4
+        uses: JS-DevTools/npm-publish@v4.1.5
         with:
           package: npm/package.json
 ```

package/mdc/style-lint.mdc

@@ -76,7 +76,7 @@ jobs:
   stylelint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: StyleLint
         run: |

package/mdc/text.mdc

@@ -18,7 +18,7 @@ version: '1.22'
 }
 ```
 
-**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**, **`markdownlint-cli2`**. Для української додай **`@cspell/dict-uk-ua`**. **`v8r`** лише через **`bun x v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
+**`package.json`:** скрипт **`lint-text`** і devDependencies **`@nitra/cspell-dict`**. Для української додай **`@cspell/dict-uk-ua`**. **`v8r`** лише через **`bun x v8r`** (зазвичай **`bunx v8r`**), не в devDependencies. Окремий пакет **`markdownlint`** не потрібний.
 
 У v8r **немає** прапорця тихого режиму; рекомендовано скрипт **`run-v8r.mjs`** з репозиторію пакета `@nitra/cursor` (`npm/scripts/run-v8r.mjs`): один виклик у `lint-text` — під капотом послідовні **`bun x 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/…`.
 
@@ -72,10 +72,6 @@ on:
     branches:
       - dev
     paths:
-      - '.cspell.json'
-      - '.gitignore'
-      - '.markdownlint-cli2.jsonc'
-      - '.v8rignore'
       - '**/*.js'
       - '**/*.ts'
       - '**/*.vue'
@@ -111,29 +107,14 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
-        with:
-          path: |
-            ~/.bun/install/cache
-            node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
+      - uses: ./.github/actions/setup-bun-deps
 
       - name: Lint text
         run: bun run lint-text
 ```
 
+Composite **`.github/actions/setup-bun-deps/action.yml`** — checkout, Node 24, Bun, кеш і `bun install --frozen-lockfile` (див. **ga.mdc**).
+
 Не дублюй окремий workflow з тими самими кроками cspell/markdownlint.
 
 **`.cspell.json`**, `version: "0.2"`, **`language`**, **`import`** з `@nitra/cspell-dict`, **`ignorePaths`**, **`words`** лише для назв/термінів, коли не виправити текстом.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -25,6 +25,7 @@
   "files": [
     "mdc",
     "bin",
+    "github-actions",
     "schemas",
     "scripts",
     "skills",

package/scripts/check-ga.mjs

@@ -2,7 +2,8 @@
  * Перевіряє GitHub Actions за правилом ga.mdc.
  *
  * Workflows лише з розширенням `.yml`, наявність clean/lint workflow, конфіг zizmor з ref-pin,
- * відсутність MegaLinter, коректний скрипт `lint-ga` у `package.json` і виклик у `lint-ga.yml`.
+ * відсутність MegaLinter, коректний скрипт `lint-ga` у `package.json`, виклик у `lint-ga.yml`,
+ * наявність composite `.github/actions/setup-bun-deps/action.yml` (його записує `npx @nitra/cursor`).
  */
 import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
@@ -34,6 +35,15 @@ export async function check() {
     return exitCode
   }
 
+  const setupBunDepsAction = '.github/actions/setup-bun-deps/action.yml'
+  if (existsSync(setupBunDepsAction)) {
+    pass(`${setupBunDepsAction} існує`)
+  } else {
+    fail(
+      `Відсутній ${setupBunDepsAction} — запустіть npx @nitra/cursor або скопіюйте з пакету (ga.mdc: composite setup-bun-deps)`
+    )
+  }
+
   const files = await readdir(wfDir)
 
   const yamlFiles = files.filter(f => f.endsWith('.yaml'))

package/scripts/check-k8s.mjs

@@ -2,7 +2,8 @@
  * Перевіряє Kubernetes YAML у шляхах з сегментом `k8s` (див. k8s.mdc).
  *
  * Перший рядок `# yaml-language-server: $schema=…`, без дублікатів, розширення `.yaml`
- * (окрім `kustomization.yml`); URL схеми за першим документом — kustomization / yannh / datree.
+ * (окрім `kustomization.yml`); URL схеми за першим документом — kustomization / yannh / datree
+ * (datree: `https://datreeio.github.io/CRDs-catalog/<group>/<kind>_<version>.json`).
  * Dockerfile — правило docker.mdc, скрипт check-docker.mjs.
  */
 import { readFile } from 'node:fs/promises'
@@ -21,7 +22,8 @@ const KUSTOMIZATION_SCHEMA = 'https://json.schemastore.org/kustomization.json'
 
 const YANNH_BASE = `https://raw.githubusercontent.com/yannh/kubernetes-json-schema/${YANNH_REF}/${YANNH_PIN}/`
 
-const DATREE_CRD_BASE = 'https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/CRDs/'
+/** Публікація [CRDs-catalog](https://github.com/datreeio/CRDs-catalog) на GitHub Pages (те саме дерево, що й raw на `main`). */
+const DATREE_CRD_BASE = 'https://datreeio.github.io/CRDs-catalog/'
 
 /**
  * Групи API Kubernetes, для яких у перевірці очікується схема yannh (не datree CRD catalog).

package/scripts/check-npm-module.mjs

@@ -1,7 +1,7 @@
 /**
  * Перевіряє структуру npm-модуля в монорепо за правилом npm-module.mdc.
  *
- * Workspace `npm/`, `npm/package.json`, workflow `npm-publish.yml` з OIDC і шляхом до пакета.
+ * Workspace `npm/`, `npm/package.json`, workflow `npm-publish.yml` з OIDC, `on.push.paths` з glob для каталогу npm (див. npm-module.mdc).
  */
 import { existsSync } from 'node:fs'
 import { readFile, stat } from 'node:fs/promises'

package/scripts/ensure-nitra-cursor-dev-dependencies.mjs

@@ -0,0 +1,99 @@
+/**
+ * Дописує `\@nitra/cursor` у `devDependencies` кореневого `package.json` проєкту, якщо пакет ще не
+ * оголошено ні в `devDependencies`, ні в `dependencies`.
+ *
+ * Використовується CLI `n-cursor` при кожному запуску (`npx \@nitra/cursor`, зокрема `check`), щоб
+ * команда `check` і скрипти з `node_modules/\@nitra/cursor/scripts/` були відтворювані після
+ * `bun install` / `npm install`, а не лише з кешу npx.
+ *
+ * Версія діапазону: `^<version>` з поля `version` установленого пакету `\@nitra/cursor`.
+ */
+
+import { existsSync } from 'node:fs'
+import { readFile, writeFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const PACKAGE_NAME = '@nitra/cursor'
+
+const scriptDir = dirname(fileURLToPath(import.meta.url))
+const bundledPkgPath = join(scriptDir, '..', 'package.json')
+
+/**
+ * Версія з `package.json` пакету `\@nitra/cursor` (каталог на рівень вище за `scripts/`).
+ * @returns {Promise<string | null>} поле `version` рядком або `null`, якщо файлу немає / помилка парсингу
+ */
+export async function readBundledPackageVersion() {
+  if (!existsSync(bundledPkgPath)) {
+    return null
+  }
+  try {
+    const raw = await readFile(bundledPkgPath, 'utf8')
+    const pkg = JSON.parse(raw)
+    return typeof pkg.version === 'string' ? pkg.version : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Якщо в `root/package.json` немає `\@nitra/cursor` у `devDependencies` і `dependencies`, дописує
+ * `devDependencies["\@nitra/cursor"]` зі значенням `^<bundledVersion>`.
+ * @param {string} root абсолютний шлях кореня проєкту (зазвичай `process.cwd()`)
+ * @param {{ bundledVersion?: string | null, silent?: boolean }} [options] `bundledVersion` — для тестів;
+ *   `silent` — не писати в консоль при успішному оновленні
+ * @returns {Promise<boolean>} `true`, якщо `package.json` змінено на диску
+ */
+export async function ensureNitraCursorInRootDevDependencies(root, options = {}) {
+  const pkgPath = join(root, 'package.json')
+  if (!existsSync(pkgPath)) {
+    return false
+  }
+
+  let raw
+  try {
+    raw = await readFile(pkgPath, 'utf8')
+  } catch {
+    return false
+  }
+
+  let pkg
+  try {
+    pkg = JSON.parse(raw)
+  } catch {
+    return false
+  }
+
+  if (pkg === null || typeof pkg !== 'object' || Array.isArray(pkg)) {
+    return false
+  }
+
+  const devDeps = pkg.devDependencies
+  const deps = pkg.dependencies
+  if (devDeps && typeof devDeps === 'object' && PACKAGE_NAME in devDeps) {
+    return false
+  }
+  if (deps && typeof deps === 'object' && PACKAGE_NAME in deps) {
+    return false
+  }
+
+  const ver = options.bundledVersion ?? (await readBundledPackageVersion())
+  if (!ver) {
+    return false
+  }
+
+  if (!pkg.devDependencies || typeof pkg.devDependencies !== 'object' || Array.isArray(pkg.devDependencies)) {
+    pkg.devDependencies = {}
+  }
+
+  pkg.devDependencies[PACKAGE_NAME] = `^${ver}`
+
+  const out = `${JSON.stringify(pkg, null, 2)}\n`
+  await writeFile(pkgPath, out, 'utf8')
+
+  if (!options.silent) {
+    console.log(`📝 Додано ${PACKAGE_NAME}@^${ver} у devDependencies у package.json\n`)
+  }
+
+  return true
+}

package/scripts/run-k8s.mjs

@@ -23,7 +23,7 @@ const KUBERNETES_VERSION = '1.33.9'
 
 /** Додатковий реєстр схем для CRD (як у README kubeconform). */
 const DATREE_CRD_SCHEMA_LOCATION =
-  'https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json'
+  'https://datreeio.github.io/CRDs-catalog/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json'
 
 /**
  * Чи містить шлях сегмент директорії `k8s`.

package/scripts/sync-setup-bun-deps-action.mjs

@@ -0,0 +1,36 @@
+/**
+ * Копіює composite GitHub Action `setup-bun-deps` з установленого пакету `@nitra/cursor`
+ * у цільовий репозиторій (`.github/actions/setup-bun-deps/action.yml`).
+ *
+ * Використовується CLI `npx \@nitra/cursor`, щоб workflows з правил `ga` / `js-lint` / `text`
+ * могли одразу викликати `uses: ./.github/actions/setup-bun-deps` без ручного копіювання.
+ *
+ * Джерело: каталог `github-actions/setup-bun-deps/` у корені tarball пакету (поруч із `mdc/`, `bin/`).
+ */
+import { existsSync } from 'node:fs'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** Відносний шлях до `action.yml` всередині кореня пакету */
+const RELATIVE_BUNDLED_ACTION = join('github-actions', 'setup-bun-deps', 'action.yml')
+
+/** Відносний шлях призначення у проєкті-клієнті */
+const RELATIVE_DEST_ACTION = join('.github', 'actions', 'setup-bun-deps', 'action.yml')
+
+/**
+ * Записує у `projectRoot` composite action з `bundledPackageRoot` (корінь установленого `@nitra/cursor`).
+ * @param {string} projectRoot абсолютний шлях до кореня цільового репозиторію
+ * @param {string} bundledPackageRoot абсолютний шлях до кореня пакету (теки з `mdc/`, `github-actions/`)
+ * @returns {Promise<{ written: boolean, destPath: string }>} чи був запис і повний шлях файлу
+ */
+export async function syncSetupBunDepsAction(projectRoot, bundledPackageRoot) {
+  const srcPath = join(bundledPackageRoot, RELATIVE_BUNDLED_ACTION)
+  if (!existsSync(srcPath)) {
+    throw new Error(`Не знайдено шаблон composite action.\nОчікуваний шлях: ${srcPath}\nПеревстановіть @nitra/cursor.`)
+  }
+  const destPath = join(projectRoot, RELATIVE_DEST_ACTION)
+  await mkdir(join(projectRoot, '.github', 'actions', 'setup-bun-deps'), { recursive: true })
+  const content = await readFile(srcPath, 'utf8')
+  await writeFile(destPath, content.endsWith('\n') ? content : `${content}\n`, 'utf8')
+  return { written: true, destPath }
+}