@nitra/cursor 1.8.212 → 1.8.213

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 Формат — [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
@@ -54,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`-рядки, без зміни існуючих перевірок.
@@ -105,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-скан коду
@@ -220,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

@@ -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

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.212",
+  "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

@@ -2,9 +2,9 @@
  * Автовизначення правил для `.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)
- * та повертає ідентифікатори правил, які потрібно автододати.
+ * залежності `mssql` / `pg` / `pg-format` / `mysql2` / `ioredis` / `node-redis` у `package.json`,
+ * імпорт `sql`/`SQL` з `bun`, кореневий `package.json`, `config.yaml` з рядком
+ * `metadata_directory: metadata` для hasura) та повертає ідентифікатори правил, які потрібно автододати.
  *
  * Враховує винятки `disable-rules`: елементи зі списку не додаються автоматично.
  *
@@ -39,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',
@@ -602,10 +603,18 @@ export async function detectAutoRules({
       : 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[]} */
@@ -634,6 +643,7 @@ export async function detectAutoRules({
     { 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' },

package/scripts/auto-skills.mjs

@@ -12,13 +12,7 @@
  */
 
 /** Порядок автододавання skills відповідно до `auto-skills.md`. */
-export const AUTO_SKILL_ORDER = Object.freeze([
-  'abie-kustomize',
-  'fix',
-  'lint',
-  'publish-telegram',
-  'taze'
-])
+export const AUTO_SKILL_ORDER = Object.freeze(['abie-kustomize', 'fix', 'lint', 'publish-telegram', 'taze'])
 
 /**
  * Залежність скілів від правил (`auto-skills.md` синтаксис `skill - [rules]`).

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

@@ -13,7 +13,7 @@ description: >-
 
 ## Передумови
 
-- Чисте робоче дерево (`git status` без незакоммічених змін у `package.json` / `bun.lock` / `node_modules`) — інакше різницю не відрізнити від оновлення.
+- Чисте робоче дерево (`git status` без незакомічених змін у `package.json` / `bun.lock` / `node_modules`) — інакше різницю не відрізнити від оновлення.
 - Встановлений `bun` і доступний `bunx`.
 - Запуск з кореня проекту (де лежить `package.json` / `bun.lock`).
 
@@ -66,6 +66,7 @@ rg -n "<імпорт|функція|опція>" --type ts --type js --type vue
 ```
 
 Класифікувати:
+
 - **сумісно** — проект не використовує зачеплене API → нічого не робити.
 - **несумісно** — використання знайдено → перейти до п. 6.