@nitra/cursor 1.8.210 → 1.8.213

package/CHANGELOG.md

@@ -4,6 +4,66 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.8.213] - 2026-05-09
+
+### Added
+
+- Нове правило `js-bun-redis` (`npm/mdc/js-bun-redis.mdc`): заміна `ioredis` /
+  `node-redis` (включно з кореневим `redis` v4 і підпакетами `@redis/*`) на
+  Bun native Redis (`import { redis } from 'bun'`,
+  <https://bun.com/docs/runtime/redis>).
+- AST-сканер `npm/scripts/utils/redis-imports.mjs` (`oxc-parser`) ловить
+  `import` / `require` / динамічний `import()` пакетів `ioredis`, `node-redis`,
+  `redis`, підшляхів `ioredis/...` / `redis/...` і `@redis/*`. Не зачіпає
+  сторонні `redis-*` (наприклад, `redis-mock`).
+- `npm/scripts/check-js-bun-redis.mjs` запускає AST-скан по JS/TS-джерелах і
+  доступний як `npx @nitra/cursor check js-bun-redis`.
+- Rego-полісі `npm/policy/js_bun_redis/package_json/` — заборона
+  `ioredis` / `node-redis` / `redis` / `@redis/*` у `dependencies` будь-якого
+  `package.json` у дереві; зареєстрована таргетом у
+  `npm/scripts/lint-conftest.mjs` (`bun run lint-conftest`).
+- Авто-увімкнення правила в `.n-cursor.json`: `npm/scripts/auto-rules.mjs`
+  додає `js-bun-redis`, якщо в `dependencies` хоч одного `package.json` є
+  `ioredis` або `node-redis` (умова — у `npm/bin/auto-rules.md`).
+- Тести: `npm/tests/redis-imports.test.mjs` (AST-сканер) і нові кейси у
+  `npm/tests/auto-rules.test.mjs` (детект `ioredis` / `node-redis`).
+
+## [1.8.212] - 2026-05-08
+
+### Changed
+
+- `npm/skills/taze/SKILL.md`: повний workflow замість шаблону-заглушки. Тепер
+  скіл бекапить `package.json`/`bun.lock`, виконує `bunx taze -w -r latest` +
+  `bun install`, виявляє major-стрибки порівнянням з бекапом, тягне breaking
+  changes з CHANGELOG модуля або git-діфу `node_modules` (з фолбеком на
+  встановлення старої версії в `/tmp`), шукає використання зачепленого API в
+  коді через `rg`, рефакторить несумісні місця (нетривіальні міграції — TODO),
+  прибирає тимчасові файли і віддає структурований звіт користувачу.
+
+## [1.8.211] - 2026-05-08
+
+### Added
+
+- Окремий шлях автодетекту для скілів — `npm/bin/auto-skills.md` +
+  `npm/scripts/auto-skills.mjs` (`detectAutoSkills`). Скіли отримують свій
+  словник умов (`skill - [rules]`), залежний від уже виявлених правил, тож не
+  дублюють файлові ознаки з `auto-rules.md`.
+- Нові авто-скіли: `publish-telegram` (завжди) і `taze` (за правилом `bun`).
+- `npm/tests/auto-skills.test.mjs` — окремі тести `detectAutoSkills`
+  (завжди-додавані, залежності від rule-id, `disable-skills`, фільтр за
+  `availableSkills`).
+
+### Changed
+
+- `npm/scripts/auto-rules.mjs`: `detectAutoRulesAndSkills` → `detectAutoRules`
+  (повертає лише `{ rules }`); прибрано `AUTO_SKILL_ORDER` і скіл-логіку.
+  `mergeConfigWithAutoDetected` лишається спільним і приймає вже виявлені
+  rules+skills, тож публічний контракт `.n-cursor.json` не змінився.
+- `npm/bin/n-cursor.js` тепер послідовно викликає `detectAutoRules` і
+  `detectAutoSkills` (скіли отримують `detectedRules` як вхід).
+- `npm/bin/auto-rules.md` залишає тільки правила; секція скілів винесена в
+  `auto-skills.md` з посиланням з `auto-rules.md`.
+
 ## [1.8.210] - 2026-05-08
 
 ### Added
@@ -18,7 +78,7 @@
     `sqlFormat` / `pgFmt` з `%L`/`%I`/`%s` у тілі, плюс `quoteLiteral` /
     `quoteIdent` / `escapeLiteral` / `escapeIdent` без додаткової перевірки)
     та `findPgFormatLikeQueryWrapperInText` (`{ query(text, params) { ...
-    <obj>.unsafe(...) ... } }`). Скан запускається лише у файлах з
+<obj>.unsafe(...) ... } }`). Скан запускається лише у файлах з
     `import { sql|SQL } from 'bun'`.
   - `npm/scripts/check-js-bun-db.mjs` рапортує `pgFormatShim` / `queryWrapper` —
     окремі лічильники й `pass`-рядки, без зміни існуючих перевірок.
@@ -69,10 +129,10 @@
     (prettier-залежність, `@nitra/eslint-config ≥ 3.9.2`),
     `checkPackageJsonTypeModule` для root, `checkEnginesNode/Bun` для root,
     канонічний `lint-js`-скрипт, валідація `lint-js.yml` (`verifyLintJsWorkflowStructure`
-    + fallback). Лишилися — `.oxlintrc.json` canonical-snapshot, VSCode-розширення,
-    workspace-ітерація для `type: "module"` і engines, дубль JS-кроків у `lint.yml`,
-    `.jscpd.json`. Прибрано непотрібні імпорти `parseWorkflowYaml`,
-    `verifyLintJsWorkflowStructure` і `OXLINT_FIX_RE`.
+    - fallback). Лишилися — `.oxlintrc.json` canonical-snapshot, VSCode-розширення,
+      workspace-ітерація для `type: "module"` і engines, дубль JS-кроків у `lint.yml`,
+      `.jscpd.json`. Прибрано непотрібні імпорти `parseWorkflowYaml`,
+      `verifyLintJsWorkflowStructure` і `OXLINT_FIX_RE`.
   - `npm/scripts/check-js-run.mjs` — без перевірок `bunyan` / `@nitra/bunyan` у
     залежностях, canonical `jsconfig.json` через `deepEqualJson`,
     `OTEL_RESOURCE_ATTRIBUTES` у `configmap.yaml`. Лишилися AST-скан коду
@@ -184,7 +244,7 @@
 - `check-k8s.mjs` (автоконверт `image-replace` patches → `images:`): тепер працює і для `patches[i].patch` із **кількома** ops, а не лише з одинокою image-replace op. Сканує всі ops у патчі, конвертує **кожну** `op: replace` на `/spec/template/spec/containers/<N>/image` (target `kind: Deployment`) у запис `images:`; якщо всі ops патча конвертовано — `patches[i]` видаляється повністю; інакше inline `patch:` переписується через `parseDocument` без конвертованих ops зі збереженням block-literal scalar (`|-`) і вихідного порядку решти ops. Реалізовано через нові функції `tryParseJson6902Array` (≥ 1 op, замість `tryParseSingleJson6902Array`) і `rewriteInlinePatchWithoutOps`; `imageReplaceDeploymentPatchInfo` повертає `{ deployName, totalOps, ops: [{ containerIndex, newImage, opIndex }] }` (раніше — одиничний `{ deployName, containerIndex, newImage }` лише за `length === 1`); `applyConversionsToDoc` групує конвертації по індексу патча й вирізає ops або сам патч за потреби. Сортування решти ops після видалення лишається поза цією зміною — за нього відповідає окрема перевірка `kustomizationInlinePatchOpsSortedViolation`.
 - `mdc/k8s.mdc` (v1.26 → v1.27): уточнено крок 1 авто-перевірки в розділі «Зміна image — через `images:`, не через `patches[]`» — тепер описує і випадок, коли в `patches[i].patch` лишаються не-image ops (їх зберігає, у вихідному порядку, без коментарів).
 - `check-js-lint.mjs` + `mdc/js-lint.mdc` (v1.16 → v1.17): мінімум `@nitra/eslint-config` піднято з `^3.8.0` до `^3.9.2`. Обґрунтування: з 3.9.2 у `getConfig` вбудовано ignore для `**/adr/**`, тож ADR-документи не валідуються ESLint, і консьюмерам не треба додавати цей glob у `eslint.config.js` локально. `nitraEslintConfigMeetsMinVersion` тепер повертає `false` для діапазонів `^3.8.x`–`^3.9.1`; `workspace:*` лишається ok без змін. Pass/fail-повідомлення `checkPackageJsonLintDeps` оновлено під новий мінімум; `for...in`-бан з 3.8.0 згадується як накопичена відмінність. Тести `nitraEslintConfigMeetsMinVersion` розширено: `^3.9.2`/`^3.9.10`/`^3.10.0`/`^4.0.0` — ok; `^3.9.1`/`^3.8.0`/`^3.6.12`/`^3.4.3` — ні.
-- `bin/n-cursor.js` (`reexecIfPackageVersionChanged` + `spawnSync`-виклик): `process.env.NITRA_CURSOR_REEXEC` і `...process.env` замінено на `env.NITRA_CURSOR_REEXEC` і `...env` з `node:process` (`import { cwd, env } from 'node:process'`). Підстава: правило `js-run.mdc` забороняє прямий `process.env.*` у Node-коді; `NITRA_CURSOR_REEXEC` — опційна змінна (виставляється лише при re-exec), тож імпорт `env` з `node:process` (а не з `@nitra/check-env`) — канонічна форма для опційних. Поведінка не змінена; раніше `npm/scripts/check-js-run.mjs` помилявся на `bin/n-cursor.js:1136` (правило `process-env`), тепер intergation-test `check-* на реальному репозиторії` проходить.
+- `bin/n-cursor.js` (`reexecIfPackageVersionChanged` + `spawnSync`-виклик): `process.env.NITRA_CURSOR_REEXEC` і `...process.env` замінено на `env.NITRA_CURSOR_REEXEC` і `...env` з `node:process` (`import { cwd, env } from 'node:process'`). Підстава: правило `js-run.mdc` забороняє прямий `process.env.*` у Node-коді; `NITRA_CURSOR_REEXEC` — опційна змінна (виставляється лише при re-exec), тож імпорт `env` з `node:process` (а не з `@nitra/check-env`) — канонічна форма для опційних. Поведінка не змінена; раніше `npm/scripts/check-js-run.mjs` помилявся на `bin/n-cursor.js:1136` (правило `process-env`), тепер integration-test `check-* на реальному репозиторії` проходить.
 
 ### Added
 

package/bin/auto-rules.md

@@ -1,6 +1,6 @@
-# Авто вмикання правил та скілів
+# Авто вмикання правил
 
-В цьому файлі описані умови, по яким повинні скіли та правила автододаватись в конфіг
+В цьому файлі описані умови, по яким повинні правила автододаватись в конфіг. Умови автододавання скілів — у `auto-skills.md` (виносить логіку зі словника правил у пару «правило → скіл»).
 
 ## Правила, які автоматично додається до .n-cursor.json
 
@@ -34,6 +34,8 @@ js-mssql - якщо в хоч одному package.json в секції dependen
 
 js-bun-db - якщо в хоч одному package.json в секції dependencies присутній пакет pg, pg-format або mysql2 або є імпорт sql/SQL з Bun (приклад: import { sql } from "bun")
 
+js-bun-redis - якщо в хоч одному package.json в секції dependencies присутній пакет ioredis або node-redis
+
 k8s - якщо присутня хоч одна директорія k8s
 
 nginx-default-tpl - якщо присутній хоч один файл з переліку - default.conf.template, default.conf, nginx.conf
@@ -50,16 +52,6 @@ text - завжди
 
 vue - якщо присутній хоч один vue файл
 
-## Скіли, які автоматично додається до .n-cursor.json
-
-abie-kustomize - якщо в кореневому package.json в секції "repository" присутній текст "<https://github.com/abinbevefes/**/>"
-
-fix - завжди
-
-lint - завжди
-
 ## Виключення
 
 Якщо в .n-cursor.json задано в секції disable-rules правило, то воно автоматично додаватись не повинно.
-
-Якщо в .n-cursor.json задано в секції disable-skills скіл, то він автоматично додаватись не повинен.

package/bin/auto-skills.md

@@ -0,0 +1,21 @@
+# Авто вмикання скілів
+
+В цьому файлі описані умови, по яким повинні скіли автододаватись в конфіг.
+
+## Скіли, які автоматично додається до .n-cursor.json
+
+Синтаксис `skill - [rules]` означає: скіл `skill` варто автододати лише якщо всі правила у списку `[rules]` уже додані до конфігу автодетектом (з `auto-rules.md`). Так залежність не дублює вихідну умову правила.
+
+abie-kustomize - [abie]
+
+fix - завжди
+
+lint - завжди
+
+publish-telegram - завжди
+
+taze - [bun]
+
+## Виключення
+
+Якщо в .n-cursor.json задано в секції disable-skills скіл, то він автоматично додаватись не повинен.

package/bin/n-cursor.js

@@ -58,12 +58,13 @@ import { fileURLToPath } from 'node:url'
 
 import { buildAgentsCommandBulletItems } from '../scripts/build-agents-commands.mjs'
 import {
-  detectAutoRulesAndSkills,
+  detectAutoRules,
   detectLegacyRuleIds,
   mergeConfigWithAutoDetected,
   normalizeIdList,
   RULE_MIGRATIONS
 } from '../scripts/auto-rules.mjs'
+import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { runStopHookCli } from '../scripts/claude-stop-hook.mjs'
 import { ensureNitraCursorInRootDevDependencies } from '../scripts/ensure-nitra-cursor-dev-dependencies.mjs'
 import { runLintGaCli } from '../scripts/lint-ga.mjs'
@@ -250,19 +251,22 @@ async function readConfig(paths = {}) {
     const rootPkg = await readRootPackageJsonSafe()
     const disableRules = normalizeIdList(parsedConfig['disable-rules'])
     const disableSkills = normalizeIdList(parsedConfig['disable-skills'])
-    const autoDetected = await detectAutoRulesAndSkills({
+    const autoDetectedRules = await detectAutoRules({
       root: cwd(),
       availableRules,
-      availableSkills,
       packageJsonParsed: rootPkg,
-      disableRules,
+      disableRules
+    })
+    const autoDetectedSkills = detectAutoSkills({
+      availableSkills,
+      detectedRules: autoDetectedRules.rules,
       disableSkills
     })
 
     const merged = mergeConfigWithAutoDetected({
       config: parsedConfig,
-      detectedRules: autoDetected.rules,
-      detectedSkills: autoDetected.skills
+      detectedRules: autoDetectedRules.rules,
+      detectedSkills: autoDetectedSkills.skills
     })
 
     const rest = Object.fromEntries(Object.entries(parsedConfig).filter(([k]) => k !== '$schema'))
@@ -283,16 +287,19 @@ async function readConfig(paths = {}) {
 
   if (!existsSync(configPath)) {
     const rootPkg = await readRootPackageJsonSafe()
-    const autoDetected = await detectAutoRulesAndSkills({
+    const autoDetectedRules = await detectAutoRules({
       root: cwd(),
       availableRules,
-      availableSkills,
       packageJsonParsed: rootPkg
     })
+    const autoDetectedSkills = detectAutoSkills({
+      availableSkills,
+      detectedRules: autoDetectedRules.rules
+    })
     const defaultConfig = sortConfigIdArrays({
       $schema: CONFIG_SCHEMA_URL,
-      rules: autoDetected.rules,
-      skills: autoDetected.skills
+      rules: autoDetectedRules.rules,
+      skills: autoDetectedSkills.skills
     })
     await writeFile(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, 'utf8')
     console.log(
@@ -1127,7 +1134,7 @@ async function readBundledVersionAt(packageRoot) {
  * Якщо `upgradeNitraCursorToLatestAndBunInstall` встановив у `node_modules/@nitra/cursor` версію,
  * відмінну від тієї, з якої стартував поточний процес (наприклад, з npx-кешу), запускає бінар нової
  * версії через `spawnSync` і завершує поточний процес із успадкованим exit-кодом. Re-exec потрібен,
- * бо ES-модулі вже завантажені у V8 (RULE_MIGRATIONS, detectAutoRulesAndSkills тощо) і нова логіка
+ * бо ES-модулі вже завантажені у V8 (RULE_MIGRATIONS, detectAutoRules тощо) і нова логіка
  * без повної заміни процесу не підхопиться. Захист від нескінченного циклу — env `NITRA_CURSOR_REEXEC=1`.
  * @param {string} effectivePackageRoot шлях, повернутий `upgradeNitraCursorToLatestAndBunInstall`
  * @returns {Promise<void>} повертається лише якщо re-exec не потрібен (інакше викликає `process.exit`)

package/mdc/js-bun-db.mdc

@@ -26,7 +26,7 @@ PostgreSQL 18+, MariaDB 10.6+ (сумісний з MySQL-протоколом,
 - допоміжні `quoteLiteral`, `quoteIdent`, `escapeLiteral`, `escapeIdent` як публічні експорти модуля;
 - обгортки `pgRead.query(text, params)` / `pgWrite.query(text, params)` / `db.query(text, params)`, які складають SQL-рядок (з або без `format`) і викликають `sql.unsafe(text, params)` — це повертає injection-поверхню, від якої ми йдемо, тільки під «зручним» іменем.
 
-Замість цього всі точки використання потрібно перевести на tagged template `sql\`...\${value}...\``. Кожне `${value}` стає окремим параметром bind, без рядкового екранування.
+Замість цього всі точки використання потрібно перевести на tagged template `sql\`...\${value}...\``. Кожне`${value}` стає окремим параметром bind, без рядкового екранування.
 
 ### Типові ідіоми `pg-format` → Bun SQL
 

package/mdc/js-bun-redis.mdc

@@ -0,0 +1,21 @@
+---
+description: Використання Redis/Valkey з Bun
+alwaysApply: true
+version: '1.0'
+---
+
+## Підтримувані версії redis
+
+Redis 7.2+
+
+## Заміна на Bun native Redis
+
+Якщо в проєкті використовуються бібліотеки `ioredis`, `node-redis`, їх потрібно замінити на Bun native Redis: <https://bun.com/docs/runtime/redis>.
+
+- Видалити з `dependencies`: `ioredis`, `node-redis`.
+- Видалити з коду: усі `import` / `require` цих пакетів та власні обгортки над ними.
+- Замінити на `import { redis } from 'bun'`
+
+## Перевірка
+
+`npx @nitra/cursor check js-bun-redis`.

package/package.json

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

package/policy/js_bun_redis/package_json/package_json.rego

@@ -0,0 +1,37 @@
+# Перевірка `dependencies` для правила `js-bun-redis.mdc` — паралель до
+# `npm/policy/js_bun_db/package_json/package_json.rego`.
+#
+# Запуск (локально, для будь-якого `package.json` у дереві):
+#   conftest test path/to/package.json -p npm/policy/js_bun_redis \
+#     --namespace js_bun_redis.package_json
+#
+# Перевіряє: у `dependencies` не повинно бути `ioredis`, `node-redis`,
+# `redis` або жодного з підпакетів `@redis/*` — заміна на Bun native Redis
+# (https://bun.com/docs/runtime/redis).
+#
+# AST-скан коду (`import` / `require` / dynamic `import()` тих самих пакетів)
+# лишається у `npm/scripts/check-js-bun-redis.mjs` (потребує `oxc-parser`).
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Конвенція проєкту — `import rego.v1` + multi-value `deny contains msg if { … }`
+# (.cursor/rules/conftest.mdc). Лінт — `bun run lint-rego` (regal).
+package js_bun_redis.package_json
+
+import rego.v1
+
+forbidden_dependencies := {
+	"ioredis",
+	"node-redis",
+	"redis",
+	"@redis/client",
+	"@redis/json",
+	"@redis/search",
+	"@redis/time-series",
+	"@redis/bloom",
+}
+
+deny contains msg if {
+	some pkg_name in forbidden_dependencies
+	pkg_name in object.keys(object.get(input, "dependencies", {}))
+	msg := sprintf("dependencies містить заборонений %q — заміни на Bun native Redis (js-bun-redis.mdc)", [pkg_name])
+}

package/scripts/auto-rules.mjs

@@ -1,13 +1,16 @@
 /**
- * Автовизначення правил і skills для `.n-cursor.json` за умовами з `npm/bin/auto-rules.md`.
+ * Автовизначення правил для `.n-cursor.json` за умовами з `npm/bin/auto-rules.md`.
  *
  * Модуль аналізує дерево проєкту (наявність файлів/директорій, `gql\`...\`` у source,
- * залежності `mssql` / `pg` / `pg-format` / `mysql2` у `package.json`, імпорт `sql`/`SQL` з `bun`, кореневий
- * `package.json`, `config.yaml` з рядком `metadata_directory: metadata` для hasura)
- * та повертає ідентифікатори правил і skills, які потрібно автододати.
+ * залежності `mssql` / `pg` / `pg-format` / `mysql2` / `ioredis` / `node-redis` у `package.json`,
+ * імпорт `sql`/`SQL` з `bun`, кореневий `package.json`, `config.yaml` з рядком
+ * `metadata_directory: metadata` для hasura) та повертає ідентифікатори правил, які потрібно автододати.
  *
- * Також враховує винятки `disable-rules` і `disable-skills`: елементи з цих списків не
- * додаються автоматично.
+ * Враховує винятки `disable-rules`: елементи зі списку не додаються автоматично.
+ *
+ * Автодетект скілів — у `./auto-skills.mjs` (умови — у `npm/bin/auto-skills.md`).
+ * `mergeConfigWithAutoDetected` нижче приймає вже виявлені rules і skills і вливає
+ * їх у конфіг із поправкою на legacy-id (`migrateRuleIds`).
  */
 import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
@@ -36,6 +39,7 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'js-lint',
   'js-mssql',
   'js-bun-db',
+  'js-bun-redis',
   'js-run',
   'k8s',
   'nginx-default-tpl',
@@ -47,9 +51,6 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'vue'
 ])
 
-/** Порядок автододавання skills відповідно до `auto-rules.md`. */
-export const AUTO_SKILL_ORDER = Object.freeze(['abie-kustomize', 'fix', 'lint'])
-
 /**
  * Карта міграції застарілих rule-id у `.n-cursor.json` на актуальні.
  * Застосовується автоматично при читанні конфігу (як для `rules`, так і для `disable-rules`).
@@ -575,29 +576,23 @@ function resolveRuleDependencies(detectedRules, addRule) {
 }
 
 /**
- * Визначає авто-правила та skills згідно з `auto-rules.md`.
+ * Визначає авто-правила згідно з `auto-rules.md`.
  * @param {object} params параметри аналізу
  * @param {string} params.root абсолютний шлях до кореня репозиторію
  * @param {string[]} params.availableRules перелік доступних правил з пакету
- * @param {string[]} params.availableSkills перелік доступних skills з пакету
  * @param {unknown} params.packageJsonParsed кореневий package.json (розпарсений) або null
  * @param {string[]} [params.disableRules] список `disable-rules` з конфігу
- * @param {string[]} [params.disableSkills] список `disable-skills` з конфігу
- * @returns {Promise<{ rules: string[], skills: string[] }>} списки id у стабільному порядку
+ * @returns {Promise<{ rules: string[] }>} список id у стабільному порядку (за `AUTO_RULE_ORDER`)
  */
-export async function detectAutoRulesAndSkills({
+export async function detectAutoRules({
   root,
   availableRules,
-  availableSkills,
   packageJsonParsed,
-  disableRules = DEFAULT_DISABLED_LIST,
-  disableSkills = DEFAULT_DISABLED_LIST
+  disableRules = DEFAULT_DISABLED_LIST
 }) {
   const facts = await collectAutoRuleFacts(root)
   const normalizedRules = new Set(availableRules.map(r => r.trim().toLowerCase()))
-  const normalizedSkills = new Set(availableSkills.map(s => s.trim().toLowerCase()))
   const disableRulesSet = new Set(disableRules)
-  const disableSkillsSet = new Set(disableSkills)
 
   const packageJsonExists = existsSync(join(root, 'package.json'))
   const npmDirExists = existsSync(join(root, 'npm'))
@@ -608,16 +603,22 @@ export async function detectAutoRulesAndSkills({
       : null
   )
   const isAbie = typeof repositoryUrl === 'string' && repositoryUrl.toLowerCase().includes(ABIE_REPOSITORY_URL_MARKER)
-  const depHits = await collectDependencyKeysPresentInPackageJsonTree(root, ['mssql', 'pg', 'pg-format', 'mysql2'])
+  const depHits = await collectDependencyKeysPresentInPackageJsonTree(root, [
+    'mssql',
+    'pg',
+    'pg-format',
+    'mysql2',
+    'ioredis',
+    'node-redis'
+  ])
   const hasMssqlDependency = depHits.has('mssql')
   const hasJsBunDbSignal =
     depHits.has('pg') || depHits.has('pg-format') || depHits.has('mysql2') || facts.hasBunSqlImport
+  const hasJsBunRedisSignal = depHits.has('ioredis') || depHits.has('node-redis')
   const hasNestedNodePackage = await hasNestedPackageJsonWithoutViteDevDependency(root)
 
   /** @type {string[]} */
   const detectedRules = []
-  /** @type {string[]} */
-  const detectedSkills = []
 
   /**
    * Додає правило до результату, якщо воно доступне і не в disable-списку.
@@ -631,18 +632,6 @@ export async function detectAutoRulesAndSkills({
     detectedRules.push(ruleId)
   }
 
-  /**
-   * Додає skill до результату, якщо він доступний і не в disable-списку.
-   * @param {string} skillId id skill
-   * @returns {void}
-   */
-  function addSkill(skillId) {
-    if (!normalizedSkills.has(skillId) || disableSkillsSet.has(skillId) || detectedSkills.includes(skillId)) {
-      return
-    }
-    detectedSkills.push(skillId)
-  }
-
   const autoRuleChecks = [
     { enabled: isAbie, id: 'abie' },
     { enabled: packageJsonExists, id: 'bun' },
@@ -654,6 +643,7 @@ export async function detectAutoRulesAndSkills({
     { enabled: facts.hasJsLikeSource, id: 'js-lint' },
     { enabled: hasMssqlDependency, id: 'js-mssql' },
     { enabled: hasJsBunDbSignal, id: 'js-bun-db' },
+    { enabled: hasJsBunRedisSignal, id: 'js-bun-redis' },
     { enabled: hasNestedNodePackage, id: 'js-run' },
     { enabled: facts.hasK8sDir, id: 'k8s' },
     { enabled: facts.hasNginxDefaultTplFile, id: 'nginx-default-tpl' },
@@ -673,20 +663,8 @@ export async function detectAutoRulesAndSkills({
   }
   resolveRuleDependencies(detectedRules, addRule)
 
-  const autoSkillChecks = [
-    { enabled: isAbie, id: 'abie-kustomize' },
-    { enabled: true, id: 'fix' },
-    { enabled: true, id: 'lint' }
-  ]
-  for (const item of autoSkillChecks) {
-    if (item.enabled) {
-      addSkill(item.id)
-    }
-  }
-
   const rules = AUTO_RULE_ORDER.filter(ruleId => detectedRules.includes(ruleId))
-  const skills = AUTO_SKILL_ORDER.filter(skillId => detectedSkills.includes(skillId))
-  return { rules, skills }
+  return { rules }
 }
 
 /**

package/scripts/auto-skills.mjs

@@ -0,0 +1,72 @@
+/**
+ * Автовизначення skills для `.n-cursor.json` за умовами з `npm/bin/auto-skills.md`.
+ *
+ * Скіли автододаються залежно від уже виявлених правил (auto-rules) — щоб не дублювати
+ * умови, які вже формалізовані для відповідного правила. Наприклад:
+ *
+ * - `abie-kustomize - [abie]` — додається разом з правилом `abie`
+ * - `taze - [bun]` — додається разом з правилом `bun`
+ *
+ * Скіли без секції `[rules]` у `auto-skills.md` (`fix`, `lint`, `publish-telegram`)
+ * додаються завжди, якщо доступні в пакеті й не у `disable-skills`.
+ */
+
+/** Порядок автододавання skills відповідно до `auto-skills.md`. */
+export const AUTO_SKILL_ORDER = Object.freeze(['abie-kustomize', 'fix', 'lint', 'publish-telegram', 'taze'])
+
+/**
+ * Залежність скілів від правил (`auto-skills.md` синтаксис `skill - [rules]`).
+ * Ключ варто автододати, коли всі правила-залежності вже додані до конфігу автодетектом.
+ */
+export const AUTO_SKILL_RULE_DEPENDENCIES = Object.freeze(
+  /** @type {Record<string, readonly string[]>} */ ({
+    'abie-kustomize': Object.freeze(['abie']),
+    taze: Object.freeze(['bun'])
+  })
+)
+
+/** Скіли без залежностей — додаються завжди (рядок «завжди» в `auto-skills.md`). */
+const ALWAYS_ON_SKILLS = Object.freeze(['fix', 'lint', 'publish-telegram'])
+
+const DEFAULT_DISABLED_LIST = Object.freeze([])
+
+/**
+ * Визначає авто-skills згідно з `auto-skills.md`.
+ * @param {object} params параметри
+ * @param {string[]} params.availableSkills перелік доступних skills із пакету (id без префікса n-)
+ * @param {string[]} params.detectedRules id правил, виявлених auto-rules (вхідні залежності)
+ * @param {string[]} [params.disableSkills] список `disable-skills` з конфігу
+ * @returns {{ skills: string[] }} список id у стабільному порядку (за `AUTO_SKILL_ORDER`)
+ */
+export function detectAutoSkills({ availableSkills, detectedRules, disableSkills = DEFAULT_DISABLED_LIST }) {
+  const normalizedSkills = new Set(availableSkills.map(s => s.trim().toLowerCase()))
+  const disableSkillsSet = new Set(disableSkills)
+  const detectedRulesSet = new Set(detectedRules)
+
+  /** @type {string[]} */
+  const detected = []
+
+  /**
+   * Додає skill до результату, якщо він доступний і не в disable-списку.
+   * @param {string} skillId id skill
+   * @returns {void}
+   */
+  function addSkill(skillId) {
+    if (!normalizedSkills.has(skillId) || disableSkillsSet.has(skillId) || detected.includes(skillId)) {
+      return
+    }
+    detected.push(skillId)
+  }
+
+  for (const skillId of ALWAYS_ON_SKILLS) {
+    addSkill(skillId)
+  }
+
+  for (const [skillId, deps] of Object.entries(AUTO_SKILL_RULE_DEPENDENCIES)) {
+    if (deps.every(d => detectedRulesSet.has(d))) {
+      addSkill(skillId)
+    }
+  }
+
+  return { skills: AUTO_SKILL_ORDER.filter(id => detected.includes(id)) }
+}

package/scripts/check-hasura.mjs

@@ -148,9 +148,8 @@ async function checkEnvFile(relPath, expected, reporter) {
   const value = m[1].trim()
   const parsed = parseInternalHasuraEndpoint(value)
   if (!parsed.ok) {
-     
     const example =
-      "https://<service>.<namespace>.svc.<cluster>.internal:<port> або http://<service>.<namespace>.svc.cluster.local:<port>"
+      'https://<service>.<namespace>.svc.<cluster>.internal:<port> або http://<service>.<namespace>.svc.cluster.local:<port>'
     fail(
       `${relPath}: HASURA_GRAPHQL_ENDPOINT="${value}" — потрібен внутрішній кластерний URL виду ${example} (hasura.mdc)`
     )

package/scripts/check-js-bun-redis.mjs

@@ -0,0 +1,98 @@
+/**
+ * Перевіряє правило `js-bun-redis.mdc`.
+ *
+ * Заборонено в JS/TS-джерелах будь-який `import` / `require` / динамічний `import()` пакетів
+ * `ioredis`, `node-redis`, `redis` (та підпакетів `@redis/*`, підшляхів `ioredis/...` /
+ * `redis/...`). Замість них треба використовувати Bun native Redis:
+ * `import { redis } from 'bun'` (<https://bun.com/docs/runtime/redis>).
+ *
+ * Перевірку `dependencies` (заборона `ioredis` / `node-redis` / `redis` / `@redis/*` у будь-якому
+ * `package.json`) винесено в Rego-полісі `npm/policy/js_bun_redis/package_json/`; її запускає
+ * `bun run lint-conftest`. Тут лишився AST-скан коду через `oxc-parser`.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+
+import { createCheckReporter } from './utils/check-reporter.mjs'
+import { loadCursorIgnorePaths } from './utils/load-cursor-config.mjs'
+import { findRedisImportsInText, isRedisScanSourceFile, shouldSkipFileForRedisScan } from './utils/redis-imports.mjs'
+import { walkDir } from './utils/walkDir.mjs'
+
+/**
+ * Збирає абсолютні шляхи JS/TS джерел у репозиторії для скану заборонених redis-імпортів.
+ * @param {string} repoRoot абсолютний шлях до кореня репозиторію
+ * @param {string[]} ignorePaths абсолютні шляхи каталогів, повністю виключених з обходу
+ * @returns {Promise<string[]>} абсолютні шляхи, відсортовані за відносним шляхом
+ */
+async function findAllSourcePathsForRedisScan(repoRoot, ignorePaths) {
+  /** @type {string[]} */
+  const paths = []
+  await walkDir(
+    repoRoot,
+    absPath => {
+      const rel = relative(repoRoot, absPath).split('\\').join('/')
+      if (isRedisScanSourceFile(rel) && !shouldSkipFileForRedisScan(rel)) {
+        paths.push(absPath)
+      }
+    },
+    ignorePaths
+  )
+  paths.sort((a, b) => relative(repoRoot, a).localeCompare(relative(repoRoot, b)))
+  return paths
+}
+
+/**
+ * Сканує JS/TS-джерела на заборонені імпорти/require пакетів `ioredis` / `node-redis` / `redis`.
+ * @param {string[]} sourcePaths абсолютні шляхи джерел
+ * @param {string} repoRoot абсолютний шлях до кореня
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<number>} кількість знайдених порушень
+ */
+async function scanSourcesForRedisImports(sourcePaths, repoRoot, fail) {
+  let violations = 0
+  for (const absPath of sourcePaths) {
+    const rel = relative(repoRoot, absPath).split('\\').join('/')
+    const content = await readFile(absPath, 'utf8')
+    for (const v of findRedisImportsInText(content, rel)) {
+      violations++
+      fail(
+        `js-bun-redis: ${rel}:${v.line} — заміни '${v.module}' на Bun native Redis ` +
+          `(import { redis } from 'bun', https://bun.com/docs/runtime/redis): ${v.snippet}`
+      )
+    }
+  }
+  return violations
+}
+
+/**
+ * Перевіряє відповідність проєкту правилу `js-bun-redis.mdc`.
+ * @returns {Promise<number>} 0 — все OK, 1 — є проблеми
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const { pass, fail } = reporter
+
+  const repoRoot = process.cwd()
+  if (!existsSync(join(repoRoot, 'package.json'))) {
+    pass('js-bun-redis: package.json у корені відсутній — перевірку пропущено')
+    return reporter.getExitCode()
+  }
+
+  const ignorePaths = await loadCursorIgnorePaths(repoRoot)
+  const sourcePaths = await findAllSourcePathsForRedisScan(repoRoot, ignorePaths)
+  if (sourcePaths.length === 0) {
+    pass('js-bun-redis: немає JS/TS файлів для скану імпортів ioredis / node-redis / redis')
+    return reporter.getExitCode()
+  }
+
+  const violations = await scanSourcesForRedisImports(sourcePaths, repoRoot, fail)
+  if (violations === 0) {
+    pass(
+      "js-bun-redis: немає імпортів 'ioredis' / 'node-redis' / 'redis' / '@redis/*' у джерелах " +
+        '(використовується Bun native Redis або redis взагалі не задіяно)'
+    )
+  }
+
+  return reporter.getExitCode()
+}

package/scripts/check-k8s.mjs

@@ -479,7 +479,7 @@ async function validateKustomizationResourcesSortedAlphabetically(root, yamlFile
 }
 
 /**
- * Лексичне порівняння двох тuplіе рядків через `localeCompare('en', { sensitivity: 'base' })`.
+ * Лексичне порівняння двох tuple рядків через `localeCompare('en', { sensitivity: 'base' })`.
  * Менший за довжиною список доповнюється порожніми рядками.
  * @param {string[]} a перший tuple
  * @param {string[]} b другий tuple
@@ -594,7 +594,7 @@ function jsonPointerPathsAreDisjoint(paths) {
 }
 
 /**
- * Парсить рядок JSON6902-патчa в плоский масив операцій `{ op, path }` (без значень).
+ * Парсить рядок JSON6902-патча в плоский масив операцій `{ op, path }` (без значень).
  * Повертає `null`, якщо це не YAML-масив об'єктів з полями `op`/`path` як рядки.
  * @param {string} raw тіло inline `patch:` (literal block scalar)
  * @returns {{ op: string, path: string }[] | null} нормалізований список ops або `null` за невідповідного формату

package/scripts/lint-conftest.mjs

@@ -183,6 +183,12 @@ const TARGETS = [
     rule: 'js-bun-db',
     walk: { match: rel => rel.endsWith('/package.json') || rel === 'package.json' }
   },
+  {
+    namespace: 'js_bun_redis.package_json',
+    policyDir: 'js_bun_redis',
+    rule: 'js-bun-redis',
+    walk: { match: rel => rel.endsWith('/package.json') || rel === 'package.json' }
+  },
   {
     namespace: 'js_run.package_json',
     policyDir: 'js_run',
@@ -257,7 +263,10 @@ function collectFiles(root, match) {
         continue
       }
       if (!e.isFile()) continue
-      const rel = abs.slice(root.length + 1).split(sep).join('/')
+      const rel = abs
+        .slice(root.length + 1)
+        .split(sep)
+        .join('/')
       if (match(rel)) out.push(rel)
     }
   }
@@ -297,11 +306,10 @@ function runConftestForTarget(conftestBin, target, files) {
     return 0
   }
   console.log(`\n▶ conftest (${target.namespace} — ${files.length} файл(ів))`)
-  const r = spawnSync(
-    conftestBin,
-    ['test', ...files, '-p', policyAbs, '--namespace', target.namespace, '--no-color'],
-    { stdio: 'inherit', env: process.env }
-  )
+  const r = spawnSync(conftestBin, ['test', ...files, '-p', policyAbs, '--namespace', target.namespace, '--no-color'], {
+    stdio: 'inherit',
+    env: process.env
+  })
   if (r.error) {
     console.error(`❌ Не вдалося запустити conftest: ${r.error.message}`)
     return 1

package/scripts/utils/bun-sql-scan.mjs

@@ -425,8 +425,7 @@ export function findPgFormatLikeQueryWrapperInText(content, virtualPath = 'scan.
     for (const prop of properties) {
       if (!prop || prop.type !== 'Property') continue
       const key = prop.key
-      const keyName =
-        key && key.type === 'Identifier' ? key.name : key && key.type === 'Literal' ? key.value : null
+      const keyName = key && key.type === 'Identifier' ? key.name : key && key.type === 'Literal' ? key.value : null
       if (keyName !== 'query') continue
       const value = prop.value
       if (!value || (value.type !== 'FunctionExpression' && value.type !== 'ArrowFunctionExpression')) continue

package/scripts/utils/conn-file-rules.mjs

@@ -100,7 +100,7 @@ function collectNamedExportNames(program) {
         (decl.type === 'FunctionDeclaration' || decl.type === 'ClassDeclaration') &&
         decl.id &&
         typeof decl.id === 'object' &&
-        typeof /** @type {Record<string, unknown>} */ (decl.id).name === 'string'
+        typeof (/** @type {Record<string, unknown>} */ (decl.id).name) === 'string'
       ) {
         out.push(/** @type {string} */ (/** @type {Record<string, unknown>} */ (decl.id).name))
       }
@@ -128,7 +128,11 @@ function hasDefaultExport(program) {
   const body = /** @type {Record<string, unknown>} */ (program).body
   if (!Array.isArray(body)) return false
   for (const node of body) {
-    if (node && typeof node === 'object' && /** @type {Record<string, unknown>} */ (node).type === 'ExportDefaultDeclaration') {
+    if (
+      node &&
+      typeof node === 'object' &&
+      /** @type {Record<string, unknown>} */ (node).type === 'ExportDefaultDeclaration'
+    ) {
       return true
     }
   }

package/scripts/utils/redis-imports.mjs

@@ -0,0 +1,172 @@
+/**
+ * Знаходить імпорти з `ioredis` та `node-redis` (та підшляхів `redis/...`) у джерелах —
+ * їх треба замінити на Bun native Redis (`import { redis } from 'bun'`) згідно з
+ * `js-bun-redis.mdc` (<https://bun.com/docs/runtime/redis>).
+ *
+ * Семантика береться з **oxc-parser** (`module.staticImports`) — без regex по тілу файлу.
+ * Додатково по AST програми ловимо `require('ioredis')` і динамічний `import('ioredis')`,
+ * щоб правило працювало і у CommonJS, і при динамічному `import` у межах одного файлу.
+ *
+ * `node-redis` публікується під рядом імен:
+ *  - кореневий пакет `redis` (саме так його імпортують у v4+);
+ *  - історичний `node-redis` (рідше);
+ *  - підпакети, які тягнуться разом: `@redis/client`, `@redis/json`, `@redis/search`,
+ *    `@redis/time-series`, `@redis/bloom` — їх теж треба прибирати разом із основним
+ *    клієнтом, щоб не лишилось «половини» інтеграції після переходу на Bun.
+ *
+ * Сканер не вимагає, щоб файл компілювався: при синтаксичних помилках повертається порожній
+ * результат — спочатку треба полагодити синтаксис, потім перезапустити перевірку.
+ */
+import { parseSync } from 'oxc-parser'
+
+import { langFromPath, normalizeSnippet, offsetToLine } from './ast-scan-utils.mjs'
+
+const SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/u
+const FORBIDDEN_MODULE_NAMES = new Set([
+  'ioredis',
+  'node-redis',
+  'redis',
+  '@redis/client',
+  '@redis/json',
+  '@redis/search',
+  '@redis/time-series',
+  '@redis/bloom'
+])
+
+/**
+ * Чи є рядок-специфікатор імпорту забороненим (`ioredis`, `node-redis`, `redis`, `redis/...`,
+ * `ioredis/...`, `@redis/<sub>`).
+ *
+ * Використовуємо префікс-збіг для `ioredis/` та `redis/` — щоб ловити підшляхи
+ * (`ioredis/built/utils`, `redis/dist/...`), але не зачепити сторонні пакети
+ * на кшталт `redis-mock`, які треба валідувати окремо.
+ * @param {string} mod рядкове значення з `import '...'` / `require('...')`
+ * @returns {boolean} true, якщо такий specifier треба викинути на користь Bun native Redis
+ */
+function isForbiddenRedisModule(mod) {
+  if (FORBIDDEN_MODULE_NAMES.has(mod)) return true
+  return mod.startsWith('ioredis/') || mod.startsWith('redis/') || mod.startsWith('@redis/')
+}
+
+/**
+ * Перевіряє, чи це виклик `require('<module>')` з рядковим аргументом.
+ * @param {Record<string, unknown> | null | undefined} node вузол AST
+ * @returns {string | null} ім'я модуля з аргументу, інакше `null`
+ */
+function requireCallModule(node) {
+  if (!node || node.type !== 'CallExpression') return null
+  const callee = node.callee
+  if (!callee || callee.type !== 'Identifier' || callee.name !== 'require') return null
+  const arg = node.arguments?.[0]
+  if (!arg || arg.type !== 'Literal' || typeof arg.value !== 'string') return null
+  return arg.value
+}
+
+/**
+ * Перевіряє, чи це динамічний `import('<module>')` з рядковим аргументом.
+ * @param {Record<string, unknown> | null | undefined} node вузол AST
+ * @returns {string | null} ім'я модуля, інакше `null`
+ */
+function dynamicImportModule(node) {
+  if (!node || node.type !== 'ImportExpression') return null
+  const src = node.source
+  if (!src || src.type !== 'Literal' || typeof src.value !== 'string') return null
+  return src.value
+}
+
+/**
+ * Простий рекурсивний обхід AST: заходимо в усі обʼєкти/масиви, щоб знайти require/import-вузли.
+ * @param {unknown} node корінь або під-вузол AST
+ * @param {(n: unknown) => void} visit виклик для кожного обʼєкта-вузла
+ * @returns {void}
+ */
+function walkAst(node, visit) {
+  if (!node || typeof node !== 'object') return
+  if (Array.isArray(node)) {
+    for (const item of node) walkAst(item, visit)
+    return
+  }
+  if (typeof node.type === 'string') {
+    visit(node)
+  }
+  for (const key of Object.keys(node)) {
+    if (key !== 'parent') {
+      const v = node[key]
+      if (v && typeof v === 'object') walkAst(v, visit)
+    }
+  }
+}
+
+/**
+ * Знаходить заборонені імпорти/require з `ioredis` / `node-redis` у тексті.
+ * @param {string} content вихідний код
+ * @param {string} [virtualPath] шлях для вибору `lang` (наприклад `pkg/src/foo.ts`)
+ * @returns {{ line: number, snippet: string, module: string }[]} список порушень
+ */
+export function findRedisImportsInText(content, virtualPath = 'scan.ts') {
+  const pathForLang = virtualPath || 'scan.ts'
+  const lang = langFromPath(pathForLang)
+  let result
+  try {
+    result = parseSync(pathForLang, content, { lang, sourceType: 'module' })
+  } catch {
+    return []
+  }
+  if (result.errors?.length) {
+    return []
+  }
+
+  /** @type {{ line: number, snippet: string, module: string }[]} */
+  const out = []
+
+  for (const imp of result.module?.staticImports ?? []) {
+    const mod = imp.moduleRequest?.value
+    if (typeof mod === 'string' && isForbiddenRedisModule(mod)) {
+      out.push({
+        line: offsetToLine(content, imp.start),
+        snippet: normalizeSnippet(content.slice(imp.start, imp.end)),
+        module: mod
+      })
+    }
+  }
+
+  walkAst(result.program, node => {
+    const reqMod = requireCallModule(node)
+    if (reqMod && isForbiddenRedisModule(reqMod)) {
+      out.push({
+        line: offsetToLine(content, node.start),
+        snippet: normalizeSnippet(content.slice(node.start, node.end)),
+        module: reqMod
+      })
+      return
+    }
+    const dynMod = dynamicImportModule(node)
+    if (dynMod && isForbiddenRedisModule(dynMod)) {
+      out.push({
+        line: offsetToLine(content, node.start),
+        snippet: normalizeSnippet(content.slice(node.start, node.end)),
+        module: dynMod
+      })
+    }
+  })
+
+  return out
+}
+
+/**
+ * Чи сканувати цей файл за розширенням (JS/TS-сімʼя).
+ * @param {string} relativePath відносний шлях до файлу
+ * @returns {boolean} `true`, якщо розширення підходить для пошуку імпорту
+ */
+export function isRedisScanSourceFile(relativePath) {
+  return SOURCE_FILE_RE.test(relativePath)
+}
+
+/**
+ * Чи слід пропустити файл під час обходу пакета (декларації типів — лише типи, не виконувані).
+ * @param {string} relativePosix шлях з posix-слешами
+ * @returns {boolean} `true`, якщо файл не сканувати
+ */
+export function shouldSkipFileForRedisScan(relativePosix) {
+  return relativePosix.endsWith('.d.ts')
+}

package/skills/taze/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: n-taze
+description: >-
+  Оновлення версій модулів проекту з аналізом major-змін і автоматичним
+  рефакторингом несумісного коду
+---
+
+# n-taze — Оновлення версій проекту
+
+## Мета
+
+Оновити всі модулі проекту до останніх версій, виявити major-оновлення, перевірити сумісність змін з кодом проекту і за потреби зрефакторити несумісні місця.
+
+## Передумови
+
+- Чисте робоче дерево (`git status` без незакомічених змін у `package.json` / `bun.lock` / `node_modules`) — інакше різницю не відрізнити від оновлення.
+- Встановлений `bun` і доступний `bunx`.
+- Запуск з кореня проекту (де лежить `package.json` / `bun.lock`).
+
+## Workflow
+
+### 1. Зафіксувати стартовий стан
+
+Перед оновленням зберегти список поточних версій, щоб потім обчислити, які модулі стрибнули через major:
+
+```bash
+cp package.json package.json.taze-bak
+cp bun.lock bun.lock.taze-bak
+```
+
+(У monorepo — також усі `*/package.json` воркспейсів. Файли тимчасові, видалити в кінці.)
+
+### 2. Запустити оновлення
+
+```bash
+bunx taze -w -r latest
+bun install
+```
+
+- `-w` — записати нові версії у `package.json`.
+- `-r` — рекурсивно по всіх воркспейсах.
+- `latest` — піднімати навіть major.
+
+### 3. Виявити major-оновлення
+
+Порівняти `package.json.taze-bak` з оновленим `package.json` (а також `bun.lock.taze-bak` ↔ `bun.lock` для транзитивних). Для кожної залежності, у якої змінилась перша значуща цифра semver (`1.x.x → 2.x.x`, `0.4.x → 0.5.x`, `0.0.x → 0.1.x`) — додати в список «потребує перевірки».
+
+Minor/patch — пропускати, їх вважаємо сумісними.
+
+### 4. Зібрати breaking changes по кожному major-оновленню
+
+Для кожного модуля зі списку зібрати фактичні відмінності одним з джерел (у порядку пріоритету):
+
+1. **CHANGELOG / Releases репозиторію модуля** — найшвидше і найточніше. Адресу репозиторію взяти з `package.json` модуля у `node_modules/<name>/package.json` (поле `repository`). Дістати релізи між старою і новою версією.
+2. **Git-різниця в `node_modules/<name>`** — якщо CHANGELOG відсутній або неінформативний, порівняти попередню версію (з кешу bun: `~/.bun/install/cache/<name>@<old-version>/`) з новою (`node_modules/<name>/`) через `diff -r` по `dist/` / `*.d.ts` / публічних entry-points з `exports`.
+3. **Якщо немає кешованої старої версії** — встановити її окремо в тимчасову теку (`mkdir -p /tmp/taze-old && cd /tmp/taze-old && bun add <name>@<old-version>`) і порівняти.
+
+Цікавлять: видалені/перейменовані експорти, змінені сигнатури функцій, змінені типи, змінена поведінка за замовчуванням, видалені CLI-прапорці.
+
+### 5. Перевірити сумісність з кодом проекту
+
+Для кожного breaking change знайти його використання в коді проекту:
+
+```bash
+rg -n "<імпорт|функція|опція>" --type ts --type js --type vue
+```
+
+Класифікувати:
+
+- **сумісно** — проект не використовує зачеплене API → нічого не робити.
+- **несумісно** — використання знайдено → перейти до п. 6.
+
+### 6. Рефакторинг несумісних місць
+
+Для кожного несумісного місця — застосувати міграцію згідно з changelog модуля (перейменувати імпорт, оновити сигнатуру виклику, замінити видалену опцію еквівалентом тощо). Після правок:
+
+```bash
+bun run lint
+bun run typecheck   # якщо є
+bun test            # якщо є
+```
+
+Якщо міграція нетривіальна або неоднозначна — **не вгадувати**, залишити TODO у коді з посиланням на CHANGELOG і винести в підсумковий звіт як ручну дію.
+
+### 7. Прибрати тимчасові файли
+
+```bash
+rm package.json.taze-bak bun.lock.taze-bak
+```
+
+(І решту бекапів воркспейсів, якщо створювались.)
+
+### 8. Звіт користувачу
+
+Коротко в одному повідомленні:
+
+- **Оновлено (minor/patch):** кількість пакетів, без деталей.
+- **Major-оновлення:** список `<name>: <old> → <new>` з посиланням на release notes.
+- **Зрефакторено автоматично:** список файлів і коротко що саме змінено.
+- **Потребує ручного втручання:** список TODO з причиною (нетривіальна міграція / неоднозначність / падіння тестів).
+- **Стан перевірок:** `lint` / `typecheck` / `test` — pass/fail з номером рядка, де впало.
+
+## Примітка
+
+- Не запускати `bun run lint` паралельно з іншими ESLint-задачами — діє правило з кореневого `CLAUDE.md`.
+- Якщо проект — `npm/` пакет цього репо, після змін у `package.json` / коді треба підняти `version` і додати запис у `CHANGELOG.md` згідно з `npm/CLAUDE.md`.
+- При великій кількості major-оновлень розбити PR по одному модулю на коміт — щоб `git bisect` залишався корисним.