@nitra/cursor 1.38.0 → 1.39.1

package/scripts/lib/rule-meta-helpers.mjs

@@ -0,0 +1,103 @@
+/**
+ * Чисті хелпери конфігу/репо для автодетекту правил: id-міграції, нормалізація
+ * списків, repository URL, monorepo-детект.
+ *
+ * Винесені з `auto-rules.mjs`, щоб `rule-predicates.mjs` міг використати
+ * `getRepositoryUrl` без циклу імпортів. `auto-rules.mjs` пізніше ре-експортує їх звідси.
+ */
+
+/**
+ * Карта міграції застарілих rule-id у `.n-cursor.json` на актуальні.
+ * Застосовується автоматично при читанні конфігу (як для `rules`, так і для `disable-rules`).
+ * Приклад: `image` → `image-compress` + `image-avif` (правило розщеплене у 1.8.197).
+ */
+export const RULE_MIGRATIONS = Object.freeze(
+  /** @type {Record<string, readonly string[]>} */ ({
+    image: Object.freeze(['image-compress', 'image-avif'])
+  })
+)
+
+/**
+ * Розгортає застарілі rule-id у списку згідно з `RULE_MIGRATIONS`. Зберігає порядок,
+ * дедуплікує. Чистий хелпер: не мутує вхід, не логує.
+ * @param {string[]} ids нормалізований список id (як з `normalizeIdList`)
+ * @returns {string[]} список з legacy-id, заміненими на нові; решта без змін
+ */
+export function migrateRuleIds(ids) {
+  /** @type {string[]} */
+  const out = []
+  for (const id of ids) {
+    const replacement = Object.hasOwn(RULE_MIGRATIONS, id) ? RULE_MIGRATIONS[id] : [id]
+    for (const newId of replacement) {
+      if (!out.includes(newId)) out.push(newId)
+    }
+  }
+  return out
+}
+
+/**
+ * Повертає лише ті legacy rule-id зі списку, для яких є запис у `RULE_MIGRATIONS`.
+ * Використовується для людинозрозумілого логування міграції при синхронізації CLI.
+ * @param {string[]} ids нормалізований список id
+ * @returns {string[]} legacy id, які потребуватимуть заміни у `migrateRuleIds`
+ */
+export function detectLegacyRuleIds(ids) {
+  return ids.filter(id => Object.hasOwn(RULE_MIGRATIONS, id))
+}
+
+/**
+ * Нормалізує список ідентифікаторів (trim + lowercase + унікальність збереженням порядку).
+ * @param {unknown} value вихідне значення з `.n-cursor.json`
+ * @returns {string[]} масив id у нормалізованому вигляді
+ */
+export function normalizeIdList(value) {
+  if (!Array.isArray(value)) {
+    return []
+  }
+  const out = []
+  for (const item of value) {
+    const normalized = String(item).trim().toLowerCase()
+    if (normalized && !out.includes(normalized)) {
+      out.push(normalized)
+    }
+  }
+  return out
+}
+
+/**
+ * Повертає URL репозиторію з package.json (`repository` може бути рядком або обʼєктом).
+ * @param {unknown} repository значення `packageJson.repository`
+ * @returns {string | null} URL або null
+ */
+export function getRepositoryUrl(repository) {
+  if (typeof repository === 'string') {
+    return repository
+  }
+  if (repository && typeof repository === 'object' && !Array.isArray(repository)) {
+    const url = /** @type {Record<string, unknown>} */ (repository).url
+    if (typeof url === 'string') {
+      return url
+    }
+  }
+  return null
+}
+
+/**
+ * Чи package.json виглядає як монорепо (поле `workspaces`).
+ * @param {unknown} packageJson кореневий package.json як JS-обʼєкт
+ * @returns {boolean} true, якщо оголошено workspaces
+ */
+export function isMonorepoPackage(packageJson) {
+  if (packageJson === null || typeof packageJson !== 'object' || Array.isArray(packageJson)) {
+    return false
+  }
+  const workspaces = /** @type {Record<string, unknown>} */ (packageJson).workspaces
+  if (Array.isArray(workspaces)) {
+    return workspaces.length > 0
+  }
+  if (workspaces && typeof workspaces === 'object' && !Array.isArray(workspaces)) {
+    const packages = /** @type {Record<string, unknown>} */ (workspaces).packages
+    return Array.isArray(packages) && packages.length > 0
+  }
+  return false
+}

package/scripts/lib/rule-meta.mjs

@@ -0,0 +1,66 @@
+/**
+ * Парсер метаданих правила з `npm/rules/<id>/meta.json` (data-driven автодетект).
+ *
+ * `meta.json.auto` має один із чотирьох видів:
+ *  - `"завжди"`                       → always-on;
+ *  - `["rule", …]`                    → активується, коли всі правила-залежності виявлені;
+ *  - `{ "glob": "<pat>" | [<pat>] }`  → наявність файлів/каталогів за glob (OR);
+ *  - `{ "predicate": "<name>", "arg"? }` → незводимий предикат із реєстру `rule-predicates.mjs`.
+ *
+ * Поля `worktree` правило НЕ має (це скілова вісь). Дзеркало `skill-meta.mjs`.
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** Літерал безумовної активації (українською, як у скілах). */
+export const RULE_ALWAYS = 'завжди'
+
+/**
+ * @typedef {{ always: true } | { rules: string[] } | { glob: string[] } | { predicate: string, arg: unknown }} RuleAutoSpec
+ */
+
+/**
+ * Нормалізує значення `meta.json.auto` у дискриміновану форму.
+ * @param {unknown} value значення поля `auto`
+ * @returns {RuleAutoSpec | null} `null` — формат не розпізнано (= opt-in)
+ */
+export function parseRuleAutoSpec(value) {
+  if (value === RULE_ALWAYS) return { always: true }
+
+  if (Array.isArray(value)) {
+    const rules = value.map(s => String(s).trim()).filter(s => s.length > 0)
+    return rules.length > 0 ? { rules } : null
+  }
+
+  if (value !== null && typeof value === 'object') {
+    const obj = /** @type {Record<string, unknown>} */ (value)
+    if ('glob' in obj) {
+      const raw = obj.glob
+      const globs = (Array.isArray(raw) ? raw : [raw]).filter(g => typeof g === 'string' && g.length > 0)
+      return globs.length > 0 ? { glob: /** @type {string[]} */ (globs) } : null
+    }
+    if ('predicate' in obj) {
+      return typeof obj.predicate === 'string' && obj.predicate.length > 0
+        ? { predicate: obj.predicate, arg: obj.arg }
+        : null
+    }
+  }
+  return null
+}
+
+/**
+ * Читає й парсить `meta.json` одного правила.
+ * @param {string} ruleDir абсолютний шлях до каталогу правила
+ * @returns {Record<string, unknown> | null} обʼєкт або `null` (немає файлу / невалідний JSON / не-обʼєкт)
+ */
+export function readRuleMetaRaw(ruleDir) {
+  const metaPath = join(ruleDir, 'meta.json')
+  if (!existsSync(metaPath)) return null
+  try {
+    const parsed = JSON.parse(readFileSync(metaPath, 'utf8'))
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return null
+    return /** @type {Record<string, unknown>} */ (parsed)
+  } catch {
+    return null
+  }
+}

package/scripts/lib/rule-predicates.mjs

@@ -0,0 +1,147 @@
+/**
+ * Реєстр незводимих до даних предикатів автодетекту правил.
+ *
+ * Прості умови (наявність файлів) живуть як `glob` у `meta.json`; ці предикати —
+ * для умов, що вимагають парсингу залежностей, сканування вмісту source чи URL repo.
+ * Декларація «який предикат + аргумент» — у `meta.json.auto.predicate`; тут — реалізація.
+ *
+ * Сигнатури неоднорідні (одні беруть `facts`, інші — `cwd`/`packageJson`), бо предикати
+ * читають різні джерела; виклик диспетчиться в `auto-rules.mjs` за іменем предиката.
+ */
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { getRepositoryUrl } from './rule-meta-helpers.mjs'
+
+const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
+
+/**
+ * Чи package.json дерева містить будь-який із зазначених пакетів у dependencies.
+ * @param {string} root корінь репо
+ * @param {string[]} keys імена пакетів
+ * @returns {Promise<boolean>} true, якщо знайдено хоч один
+ */
+async function anyDepInTree(root, keys) {
+  const wanted = new Set(keys)
+  let found = false
+  /** @param {string} dir каталог обходу @returns {Promise<void>} */
+  async function walk(dir) {
+    if (found) return
+    let entries
+    try {
+      entries = await readdir(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const entry of entries) {
+      if (found) return
+      const abs = join(dir, entry.name)
+      if (entry.isDirectory()) {
+        if (!IGNORED_DIR_NAMES.has(entry.name)) await walk(abs)
+      } else if (entry.isFile() && entry.name === 'package.json') {
+        try {
+          const deps = JSON.parse(await readFile(abs, 'utf8'))?.dependencies
+          if (deps && typeof deps === 'object' && !Array.isArray(deps)) {
+            for (const k of wanted) if (Object.hasOwn(deps, k)) found = true
+          }
+        } catch {
+          /* ігноруємо пошкоджені package.json */
+        }
+      }
+    }
+  }
+  await walk(root)
+  return found
+}
+
+/**
+ * Чи існує вкладений (не кореневий) package.json без `vite` у devDependencies.
+ * @param {string} root корінь репо
+ * @returns {Promise<boolean>} true, якщо знайдено
+ */
+async function nestedWithoutVite(root) {
+  const rootPkg = join(root, 'package.json')
+  let result = false
+  /** @param {string} dir каталог @returns {Promise<void>} */
+  async function walk(dir) {
+    if (result) return
+    let entries
+    try {
+      entries = await readdir(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const entry of entries) {
+      if (result) return
+      const abs = join(dir, entry.name)
+      if (entry.isDirectory()) {
+        if (!IGNORED_DIR_NAMES.has(entry.name)) await walk(abs)
+      } else if (entry.isFile() && entry.name === 'package.json' && abs !== rootPkg) {
+        try {
+          const dev = JSON.parse(await readFile(abs, 'utf8'))?.devDependencies
+          const hasVite = dev && typeof dev === 'object' && !Array.isArray(dev) && Object.hasOwn(dev, 'vite')
+          if (!hasVite) result = true
+        } catch {
+          /* пошкоджений package.json не вважаємо vite-проєктом */
+        }
+      }
+    }
+  }
+  await walk(root)
+  return result
+}
+
+/** Реєстр предикатів: імʼя → реалізація. Виклик за `meta.json.auto.predicate`. */
+export const RULE_PREDICATES = {
+  /**
+   * @param {unknown} packageJson кореневий package.json
+   * @param {string} arg підрядок-маркер URL
+   * @returns {boolean} true, якщо repository.url містить маркер
+   */
+  repoUrlMarker(packageJson, arg) {
+    const url = getRepositoryUrl(
+      packageJson && typeof packageJson === 'object' && !Array.isArray(packageJson)
+        ? /** @type {Record<string, unknown>} */ (packageJson).repository
+        : null
+    )
+    return typeof url === 'string' && url.toLowerCase().includes(String(arg).toLowerCase())
+  },
+  /**
+   * @param {string} cwd корінь репо
+   * @param {string[]} arg імена пакетів
+   * @returns {Promise<boolean>} true, якщо будь-який пакет у dependencies дерева
+   */
+  depInAnyPackageJson(cwd, arg) {
+    return anyDepInTree(cwd, Array.isArray(arg) ? arg : [])
+  },
+  /**
+   * @param {{ hasGqlTaggedTemplates: boolean }} facts факти
+   * @returns {boolean} true, якщо є gql-літерал
+   */
+  gqlTaggedTemplate(facts) {
+    return facts.hasGqlTaggedTemplates === true
+  },
+  /**
+   * @param {{ hasHasuraConfig: boolean }} facts факти
+   * @returns {boolean} true, якщо config.yaml із маркером
+   */
+  hasuraConfigMarker(facts) {
+    return facts.hasHasuraConfig === true
+  },
+  /**
+   * @param {string} cwd корінь репо
+   * @param {{ hasBunSqlImport: boolean }} facts факти
+   * @returns {Promise<boolean>} true, якщо deps pg/pg-format/mysql2 або import sql з bun
+   */
+  async jsBunDbSignal(cwd, facts) {
+    if (facts.hasBunSqlImport === true) return true
+    return anyDepInTree(cwd, ['pg', 'pg-format', 'mysql2'])
+  },
+  /**
+   * @param {string} cwd корінь репо
+   * @returns {Promise<boolean>} true, якщо вкладений package.json без vite
+   */
+  nestedPackageWithoutVite(cwd) {
+    return nestedWithoutVite(cwd)
+  }
+}

package/skills/worktree/meta.json

@@ -1 +1 @@
-{ "worktree": false }
+{ "auto": "завжди", "worktree": false }

package/rules/abie/auto.md

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

package/rules/adr/auto.md

@@ -1 +0,0 @@
-завжди

package/rules/bun/auto.md

@@ -1 +0,0 @@
-якщо в корені проекту є package.json

package/rules/capacitor/auto.md

@@ -1 +0,0 @@
-якщо в проекті є хоч один файл capacitor.config.json

package/rules/changelog/auto.md

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

package/rules/docker/auto.md

@@ -1 +0,0 @@
-якщо в проекті є хоч один Dockerfile

package/rules/efes/auto.md

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

package/rules/ga/auto.md

@@ -1 +0,0 @@
-якщо присутня директорія .github/workflows

package/rules/graphql/auto.md

@@ -1 +0,0 @@
-якщо хоч в одному js або vue файлі присутній gql` темплейт літерал

package/rules/hasura/auto.md

@@ -1 +0,0 @@
-якщо в директорії присутній config.yaml, який містить рядок `metadata_directory: metadata`

package/rules/image-avif/auto.md

@@ -1 +0,0 @@
-[vue, image-compress]

package/rules/image-compress/auto.md

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

package/rules/js-bun-db/auto.md

@@ -1 +0,0 @@
-якщо в хоч одному package.json в секції dependencies присутній пакет pg, pg-format або mysql2 або є імпорт sql/SQL з Bun (приклад: import { sql } from "bun")

package/rules/js-bun-redis/auto.md

@@ -1 +0,0 @@
-якщо в хоч одному package.json в секції dependencies присутній пакет ioredis або node-redis

package/rules/js-lint/auto.md

@@ -1 +0,0 @@
-якщо присутній хоч один js файл

package/rules/js-mssql/auto.md

@@ -1 +0,0 @@
-якщо в хоч одному package.json в секції dependencies присутній пакет mssql

package/rules/js-run/auto.md

@@ -1 +0,0 @@
-якщо це вкладена директорія з package.json (не в корені) та в devDependencies немає vite

package/rules/k8s/auto.md

@@ -1 +0,0 @@
-якщо присутня хоч одна директорія k8s

package/rules/nginx-default-tpl/auto.md

@@ -1 +0,0 @@
-якщо присутній хоч один файл з переліку - default.conf.template, default.conf, nginx.conf

package/rules/npm-module/auto.md

@@ -1 +0,0 @@
-якщо в корені присутня директорія npm

package/rules/php/auto.md

@@ -1 +0,0 @@
-якщо в корені є composer.json

package/rules/rego/auto.md

@@ -1 +0,0 @@
-якщо в проекті є хоч один rego

package/rules/rust/auto.md

@@ -1 +0,0 @@
-якщо в проекті є хоч один Cargo.toml

package/rules/security/auto.md

@@ -1 +0,0 @@
-завжди

package/rules/style-lint/auto.md

@@ -1 +0,0 @@
-якщо присутній хоч один vue або css файл

package/rules/tauri/auto.md

@@ -1 +0,0 @@
-якщо в хоч в package.json в секції dependencies присутній пакет @tauri-apps/api

package/rules/test/auto.md

@@ -1 +0,0 @@
-завжди

package/rules/text/auto.md

@@ -1 +0,0 @@
-завжди

package/rules/vue/auto.md

@@ -1 +0,0 @@
-якщо присутній хоч один vue файл