@nitra/cursor 1.8.132 → 1.8.135

package/bin/auto-rules.md

@@ -8,6 +8,8 @@ abie - якщо в кореневому package.json в секції "repository
 
 bun - якщо в корені проекту є package.json
 
+capacitor - якщо в проекті є хоч один файл capacitor.config.json
+
 docker - якщо в проекті є хоч один Dockerfile
 
 ga - якщо присутня директорія .github/workflows

package/mdc/capacitor.mdc

@@ -0,0 +1,18 @@
+---
+description: Правила для проєктів Capacitor
+alwaysApply: true
+version: '1.0'
+---
+
+## Версія Capacitor
+
+У `package.json` (у **корені** репозиторію чи **workspace**-пакеті) оголошення **`@capacitor/core`**
+має вказувати діапазон, **сумісний лише з мажорною версією 8 і вище** (наприклад `^8.0.0`).
+**`*`**, `latest` і діапазони, де можлива 7-мажор, — неприйнятні. Програма перевірки — **`check-capacitor.mjs`**
+(репозиторій **@nitra/cursor**).
+
+## iOS: лише SPM
+
+Нативний iOS-шар **не** повинен використовувати **CocoaPods** (наприклад файл **`Podfile`**
+поза каталогом `Pods/`) — **Swift Package Manager (SPM)**. Якщо каталога **`ios/`** немає, перевірка iOS
+у цьому кроці пропускається.

package/mdc/k8s.mdc

@@ -416,6 +416,8 @@ spec:
 
 У маніфестах під **`k8s`** заборонено **`apiVersion: autoscaling/v1`** (legacy HPA з єдиною метрикою CPU). Мігруй **HorizontalPodAutoscaler** на **`autoscaling/v2`**: поле **`spec.metrics`** (замість **`spec.targetCPUUtilizationPercentage`**) з **`type: Resource`** і **`target.type: Utilization`** / **`AverageUtilization`** — підтримує декілька метрик і зовнішні метрики. `check k8s` падає на будь-якому документі з **`apiVersion: autoscaling/v1`**.
 
+Ресурси **batch** (наприклад **CronJob**, **Job**): застаріле **`apiVersion: batch/v1beta1`** у файлах під **`k8s` під час `check k8s` переписується** на **`apiVersion: batch/v1`**.
+
 ```yaml
 # yaml-language-server: $schema=https://raw.githubusercontent.com/yannh/kubernetes-json-schema/master/v1.33.9-standalone-strict/horizontalpodautoscaler-autoscaling-v2.json
 apiVersion: autoscaling/v2

package/package.json

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

package/scripts/auto-rules.mjs

@@ -21,6 +21,7 @@ import {
 export const AUTO_RULE_ORDER = Object.freeze([
   'abie',
   'bun',
+  'capacitor',
   'docker',
   'ga',
   'graphql',
@@ -119,6 +120,7 @@ function updateDirFacts(dirName, facts) {
  * @param {string} fileName базове імʼя файлу
  * @param {string} relPath шлях відносно кореня
  * @param {{
+ *   hasCapacitorConfig: boolean,
  *   hasDockerfile: boolean,
  *   hasJsLikeSource: boolean,
  *   hasNginxDefaultTplFile: boolean,
@@ -129,6 +131,9 @@ function updateDirFacts(dirName, facts) {
  * @returns {void}
  */
 function updateFileFacts(fileName, relPath, facts) {
+  if (fileName === 'capacitor.config.json') {
+    facts.hasCapacitorConfig = true
+  }
   if (fileName === 'Dockerfile' || fileName.startsWith('Dockerfile.')) {
     facts.hasDockerfile = true
   }
@@ -182,6 +187,7 @@ async function updateGqlFactFromFile(absPath, relPath, facts) {
  * @param {string} absPath абсолютний шлях до файлу
  * @param {string} root абсолютний шлях кореня
  * @param {{
+ *   hasCapacitorConfig: boolean,
  *   hasDockerfile: boolean,
  *   hasGqlTaggedTemplates: boolean,
  *   hasJsLikeSource: boolean,
@@ -261,6 +267,7 @@ export function isMonorepoPackage(packageJson) {
  * Обходить дерево проєкту, збираючи факти для автоувімкнення правил.
  * @param {string} root абсолютний шлях кореня репозиторію
  * @returns {Promise<{
+ *   hasCapacitorConfig: boolean,
  *   hasDockerfile: boolean,
  *   hasGaWorkflowsDir: boolean,
  *   hasGqlTaggedTemplates: boolean,
@@ -275,6 +282,7 @@ export function isMonorepoPackage(packageJson) {
  */
 export async function collectAutoRuleFacts(root) {
   const facts = {
+    hasCapacitorConfig: false,
     hasDockerfile: false,
     hasGaWorkflowsDir: existsSync(join(root, '.github', 'workflows')),
     hasGqlTaggedTemplates: false,
@@ -386,6 +394,7 @@ export async function detectAutoRulesAndSkills({
   const autoRuleChecks = [
     { enabled: isAbie, id: 'abie' },
     { enabled: packageJsonExists, id: 'bun' },
+    { enabled: facts.hasCapacitorConfig, id: 'capacitor' },
     { enabled: facts.hasDockerfile, id: 'docker' },
     { enabled: facts.hasGaWorkflowsDir, id: 'ga' },
     { enabled: facts.hasGqlTaggedTemplates, id: 'graphql' },

package/scripts/check-capacitor.mjs

@@ -0,0 +1,350 @@
+/**
+ * Перевіряє відповідність проєкту правилам capacitor.mdc для застосунків **Capacitor**.
+ *
+ * Якщо у репозиторії **немає** ознак Capacitor (див. наведене) — вихід **0**, перевірка не застосовується.
+ *
+ * **Ознака Capacitor:** наявні **`capacitor.config.json`**, **`capacitor.config.ts`**, **`capacitor.config.mjs`**
+ * (у корені) **або** у будь-якому `package.json` (рекурсивно, з пропуском типових каталогів) оголошено
+ * хоча б одну залежність **`@capacitor/…`** (у **`dependencies`**, **`devDependencies`**, опційно
+ * **`optionalDependencies`**, **`peerDependencies`**).
+ *
+ * **Версія мінімум 8:** у кожному `package.json`, де вказано **`@capacitor/core`**, діапазон версії
+ * мусить допускати лише **Capacitor 8+** (оцінка мінімального **major** з рядка діапазону npm, зокрема
+ * `||` і діапазонів через `-` у спрощеному вигляді). **`*`**, **latest** та нерозпізнані випадки — **порушення**:
+ * варто задати явний діапазон, наприклад **`^8.0.0`**. Якщо оголошено `capacitor.config.*` без жодного
+ * **`@capacitor/core`** у дереві `package.json` — також помилка.
+ *
+ * **iOS лише через SPM (Swift Package Manager):** якщо в корні є каталог **`ios/`** — у ньому **не** має
+ * бути файлів **Podfile** (CocoaPods) **поза** каталогом **Pods** (тобто не використовувати **Podfile**
+ * у вихідному iOS-шарі; присутній **Podfile** — порушення). Якщо **немає** `ios/` — вимогу iOS у цьому
+ * прогоні пропущено.
+ */
+import { existsSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+
+import { createCheckReporter } from './utils/check-reporter.mjs'
+
+/** Мінімальна допустима мажорна версія Capacitor (capacitor.mdc) */
+const MIN_CAPACITOR_MAJOR = 8
+
+/** @type {Set<string>} */
+const IGNORED_DIRS_FOR_PACKAGE_JSON = new Set([
+  'node_modules',
+  '.git',
+  'dist',
+  'coverage',
+  'Pods',
+  '.turbo',
+  '.next',
+  'build'
+])
+
+/** `||` у діапазоні npm-версій */
+const NPM_OR_PARTS_RE = /\s*\|\|\s*/
+
+/** `a - b` (діапазон діапазонів) */
+const NPM_HYPHEN_RANGE_RE = /^(.+?)\s+-\s+(.+)$/
+
+const FIRST_VERSION_NUM_RE = /^(?:v)?(\d+)/i
+
+const PREFIX_GEQ_RE = /^>=\s*/u
+const PREFIX_GT_RE = /^>\s*/u
+const STRIP_CARET_TILDE_EQ_RE = /^[=^~]+\s*/u
+
+/**
+ * Мінімальний **major** (нижня межа) для **однієї** OR-частини діапазону npm (без `||` всередині).
+ * @param {string} segment одна частина після `||` або весь рядок
+ * @returns {number | null} null, якщо **`*` / `x` / `latest`**, або **major** **нижньої** межі
+ */
+export function capacitorSegmentMinMajor(segment) {
+  if (typeof segment !== 'string') {
+    return null
+  }
+  const s0 = segment.trim()
+  if (!s0) {
+    return null
+  }
+  const low = s0.toLowerCase()
+  if (s0 === '*' || low === 'x' || low === 'latest') {
+    return null
+  }
+  if (s0.startsWith('<') || s0.startsWith('<=')) {
+    return 0
+  }
+  if (s0.startsWith('>') && !s0.startsWith('>=')) {
+    return firstVersionMajorFromNpmValue(s0.replace(PREFIX_GT_RE, ''))
+  }
+  const rangeHyphen = s0.match(NPM_HYPHEN_RANGE_RE)
+  if (rangeHyphen) {
+    return firstVersionMajorFromNpmValue(rangeHyphen[1].trim())
+  }
+  if (s0.startsWith('^') || s0.startsWith('~') || s0.startsWith('=')) {
+    return firstVersionMajorFromNpmValue(s0.replace(STRIP_CARET_TILDE_EQ_RE, ''))
+  }
+  if (s0.startsWith('>=')) {
+    return firstVersionMajorFromNpmValue(s0.replace(PREFIX_GEQ_RE, ''))
+  }
+  return firstVersionMajorFromNpmValue(s0)
+}
+
+/**
+ * Витягує **major** з першого числа у вигляді **X** або **X.Y** / **X.Y.Z** (опційно **v**).
+ * @param {string} t рядок ділянки **версії** (без префікса **операторів**)
+ * @returns {number | null} перше **ціле** (major) або **null**
+ */
+function firstVersionMajorFromNpmValue(t) {
+  const s = t.trim()
+  if (!s) {
+    return null
+  }
+  const m = s.match(FIRST_VERSION_NUM_RE)
+  if (!m) {
+    return null
+  }
+  return Number.parseInt(m[1], 10)
+}
+
+/**
+ * Мінімальна можлива (нижня) **major**-версія для повного діапазону npm, у т. ч. з `||`.
+ * @param {string} versionRange повне поле `package.json` для **@capacitor/core**
+ * @returns {number | null} **null** якщо **`*` / latest** в одній з частин
+ */
+export function capacitorVersionRangeMinMajor(versionRange) {
+  if (typeof versionRange !== 'string') {
+    return null
+  }
+  const parts = versionRange.split(NPM_OR_PARTS_RE)
+  let overallMin = /** @type {number | null} */ (null)
+  for (const p of parts) {
+    const m = capacitorSegmentMinMajor(p)
+    if (m === null) {
+      return null
+    }
+    if (overallMin === null || m < overallMin) {
+      overallMin = m
+    }
+  }
+  return overallMin
+}
+
+/**
+ * @param {string} versionRange рядок **версії** з `package.json`
+ * @param {number} [min] мінімальний **major** (за замовчуванням `MIN_CAPACITOR_MAJOR`)
+ * @returns {boolean} **true**, якщо нижня межа **≥** **min**
+ */
+export function isCapacitorCoreVersionAtLeast8(versionRange, min = MIN_CAPACITOR_MAJOR) {
+  const low = capacitorVersionRangeMinMajor(versionRange)
+  if (low === null) {
+    return false
+  }
+  return low >= min
+}
+
+/**
+ * @param {(m: string) => void} fail друк помилки
+ * @param {(m: string) => void} pass друк успіху
+ * @param {string} rel відносний **posix**-шлях `package.json`
+ * @param {string} range поле `version` для **@capacitor/core**
+ * @returns {void}
+ */
+function reportOneCapacitorCoreRange(fail, pass, rel, range) {
+  if (isCapacitorCoreVersionAtLeast8(range)) {
+    pass(`«${rel}»: @capacitor/core — діапазон сумісний з ${MIN_CAPACITOR_MAJOR}+`)
+  } else {
+    fail(
+      `«${rel}»: @capacitor/core «${range}» — мінімальна допустима мажорна версія Capacitor ${MIN_CAPACITOR_MAJOR} (capacitor.mdc). Вкажи, наприклад, ^${MIN_CAPACITOR_MAJOR}.0.0`
+    )
+  }
+}
+
+/**
+ * @param {string} absPath шлях до `package.json`
+ * @param {string} root корінь репозиторію
+ * @param {{ byPath: Map<string, string>, anyCapacitor: boolean }} out накопичувач **byPath** і **anyCapacitor**
+ * @returns {Promise<void>}
+ */
+export async function recordCapacitorFromOnePackageJson(absPath, root, out) {
+  let raw
+  try {
+    raw = await readFile(absPath, 'utf8')
+  } catch {
+    return
+  }
+  let pkg
+  try {
+    pkg = JSON.parse(raw)
+  } catch {
+    return
+  }
+  const rel = (relative(root, absPath) || absPath).replaceAll('\\', '/')
+  for (const block of ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']) {
+    const rec = pkg?.[block]
+    if (rec !== null && rec !== undefined && typeof rec === 'object' && !Array.isArray(rec)) {
+      const obj = /** @type {Record<string, unknown>} */ (rec)
+      for (const [name, val] of Object.entries(obj)) {
+        if (typeof name === 'string' && name.startsWith('@capacitor/')) {
+          out.anyCapacitor = true
+        }
+        if (name === '@capacitor/core' && typeof val === 'string' && val !== '') {
+          out.byPath.set(rel, val)
+        }
+      }
+    }
+  }
+}
+
+/**
+ * Зчитує всі `package.json` з дерева, накопичує `byPath` і `anyCapacitor`.
+ * @param {string} root корінь репозиторію
+ * @param {{ byPath: Map<string, string>, anyCapacitor: boolean }} out накопичувач
+ * @returns {Promise<void>}
+ */
+export async function collectCapacitorDataFromAllPackageJson(root, out) {
+  out.anyCapacitor = false
+  if (out.byPath) {
+    out.byPath.clear()
+  } else {
+    out.byPath = new Map()
+  }
+
+  /**
+   * @param {string} dir абсолютний **каталог** для `readdir`
+   * @returns {Promise<void>}
+   */
+  async function walk(dir) {
+    let entries
+    try {
+      entries = await readdir(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const entry of entries) {
+      const absPath = join(dir, entry.name)
+      if (entry.isDirectory() && !IGNORED_DIRS_FOR_PACKAGE_JSON.has(entry.name)) {
+        await walk(absPath)
+      } else if (entry.isFile() && entry.name === 'package.json') {
+        await recordCapacitorFromOnePackageJson(absPath, root, out)
+      }
+    }
+  }
+
+  await walk(root)
+}
+
+/**
+ * @param {string} root абсолютний або **cwd**-відносний **корінь** репозиторію
+ * @returns {boolean} **true** якщо `capacitor.config.{json,ts,mjs}` існує
+ */
+export function hasCapacitorConfigInRoot(root) {
+  return (
+    existsSync(join(root, 'capacitor.config.json')) ||
+    existsSync(join(root, 'capacitor.config.ts')) ||
+    existsSync(join(root, 'capacitor.config.mjs'))
+  )
+}
+
+/**
+ * Чи варто застосовувати правила: конфіг **або** **@capacitor/** у залежностях.
+ * @param {string} root корінь
+ * @param {boolean} anyCapacitor чи зустрілось **@capacitor/** у **package.json**
+ * @returns {boolean} **true** якщо застосовуємо **check capacitor**
+ */
+export function isCapacitorRelevantForCheck(root, anyCapacitor) {
+  return hasCapacitorConfigInRoot(root) || anyCapacitor
+}
+
+/**
+ * Рекурсивно шукає `Podfile` у **ios/**, **не** заходячи в **Pods** (кеш CocoaPods) і типові build-каталоги.
+ * @param {string} root корінь репозиторію
+ * @param {string} dir абсолютний каталог
+ * @param {(rel: string) => void} onPodfileRelative **callback** з **posix**-шляхом `Podfile` від **root**
+ * @returns {Promise<boolean>} **true** — знайдено **хоча б один** `Podfile`
+ */
+export async function walkIosForPodfileSkipPods(root, dir, onPodfileRelative) {
+  let entries
+  try {
+    entries = await readdir(dir, { withFileTypes: true })
+  } catch {
+    return false
+  }
+  for (const e of entries) {
+    if (e.name !== 'Pods' && e.name !== 'build' && e.name !== 'DerivedData') {
+      const abs = join(dir, e.name)
+      if (e.isFile() && e.name === 'Podfile') {
+        onPodfileRelative((relative(root, abs) || abs).replaceAll('\\', '/'))
+        return true
+      }
+      if (e.isDirectory()) {
+        const found = await walkIosForPodfileSkipPods(root, abs, onPodfileRelative)
+        if (found) {
+          return true
+        }
+      }
+    }
+  }
+  return false
+}
+
+/**
+ * @param {string} root корінь
+ * @returns {Promise<string | null>} **relative**-шлях `Podfile` (або **null**)
+ */
+export async function findFirstPodfileUnderIosExcludingPods(root) {
+  const iosDir = join(root, 'ios')
+  if (!existsSync(iosDir)) {
+    return null
+  }
+  let first = /** @type {string | null} */ (null)
+  await walkIosForPodfileSkipPods(root, iosDir, rel => {
+    if (first === null || rel.length < first.length) {
+      first = rel
+    }
+  })
+  return first
+}
+
+/**
+ * @returns {Promise<number>} **0** — **ok**; **1** — **fail** (див. **capacitor.mdc**)
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const { pass, fail, getExitCode } = reporter
+  const root = process.cwd()
+
+  const acc = { byPath: new Map(), anyCapacitor: false }
+  await collectCapacitorDataFromAllPackageJson(root, acc)
+  const { byPath, anyCapacitor } = acc
+
+  if (!isCapacitorRelevantForCheck(root, anyCapacitor)) {
+    pass('Capacitor не виявлено (без capacitor.config у корені, без @capacitor/ у package.json) — check capacitor пропущено')
+    return getExitCode()
+  }
+
+  pass('Проєкт з ознаками Capacitor — застосовую capacitor.mdc')
+
+  if (byPath.size === 0) {
+    fail(
+      `додай залежність @capacitor/core з діапазоном ^${MIN_CAPACITOR_MAJOR}.0.0 (або іншим, сумісним лише з ${MIN_CAPACITOR_MAJOR}+) у package.json (capacitor.mdc)`
+    )
+  } else {
+    for (const [rel, range] of byPath) {
+      reportOneCapacitorCoreRange(fail, pass, rel, range)
+    }
+  }
+
+  const podfileRel = await findFirstPodfileUnderIosExcludingPods(root)
+  if (podfileRel === null) {
+    if (existsSync(join(root, 'ios'))) {
+      pass('ios/ без Podfile поза Pods/ (лише SPM, capacitor.mdc)')
+    } else {
+      pass('каталог ios/ не знайдено — вимогу iOS/SPM пропущено')
+    }
+  } else {
+    fail(
+      `iOS: знайдено Podfile «${podfileRel}» — для Capacitor використовуй лише SPM, без CocoaPods (прибери Podfile, capacitor.mdc)`
+    )
+  }
+
+  return getExitCode()
+}

package/scripts/check-k8s.mjs

@@ -23,6 +23,8 @@
  *
  * **`kind: Ingress`** заборонено (потрібен перехід на Gateway API).
  * **`apiVersion: autoscaling/v1`** заборонено (мігруй **HorizontalPodAutoscaler** на **`autoscaling/v2`**).
+ * Рядок **`apiVersion: batch/v1beta1`** (CronJob, Job) **автоматично** переписується на **`apiVersion: batch/v1`**
+ * (окрім рядків-коментарів і рядків, де після значення йде наприклад `# …`).
  *
  * Файли під **`k8s`**, де всі YAML-документи — лише **`kind: BackendConfig`**, **видаляються** автоматично.
  * Якщо **BackendConfig** змішано з іншими ресурсами в одному файлі — перевірка завершується помилкою (розділи маніфести).
@@ -93,7 +95,7 @@
  * не з’явиться `Deployment` (k8s.mdc).
  */
 import { existsSync } from 'node:fs'
-import { readFile, readdir, stat, unlink } from 'node:fs/promises'
+import { readFile, readdir, stat, unlink, writeFile } from 'node:fs/promises'
 import { basename, dirname, join, relative, resolve } from 'node:path'
 
 import { parseAllDocuments } from 'yaml'
@@ -1561,6 +1563,73 @@ async function removeBackendConfigOnlyK8sYamlFiles(root, fail, pass) {
   }
 }
 
+/**
+ * Один рядок YAML: якщо це `apiVersion` зі значенням **`batch/v1beta1`**, повертає той самий рядок із **`batch/v1`**
+ * (з тими самими відступами/пробілами після `apiVersion:`, крім випадків з лапками — нормалізується до `apiVersion: batch/v1`).
+ * Рядки, що після trim починаються з `#`, не змінюються.
+ * @param {string} line
+ * @returns {string}
+ */
+function rewriteLineBatchV1beta1ApiVersion(line) {
+  const t = line.trimStart()
+  if (t.startsWith('#')) {
+    return line
+  }
+  const m = line.match(/^(\s*apiVersion:\s*)(?:"|')?batch\/v1beta1(?:"|')?(\s*)$/)
+  if (m) {
+    return `${m[1]}batch/v1${m[2]}`
+  }
+  return line
+}
+
+/**
+ * У повному тексті YAML замінює всі **цілі** рядки `apiVersion: batch/v1beta1` (за потреби в лапках) на `apiVersion: batch/v1`.
+ * Зберігає **CRLF** / **LF** як у вихідному рядку.
+ * @param {string} raw вміст файлу
+ * @returns {{ changed: boolean, content: string }}
+ */
+export function replaceBatchV1beta1ApiVersionInYamlText(raw) {
+  const eol = raw.includes('\r\n') ? '\r\n' : '\n'
+  const lines = raw.split(/\r?\n/)
+  let changed = false
+  const out = lines.map(line => {
+    const n = rewriteLineBatchV1beta1ApiVersion(line)
+    if (n !== line) {
+      changed = true
+    }
+    return n
+  })
+  if (!changed) {
+    return { changed: false, content: raw }
+  }
+  return { changed: true, content: out.join(eol) }
+}
+
+/**
+ * Проходить усі `*.yaml` / `*.yml` під сегментом `k8s` і на диску застосовує **`replaceBatchV1beta1ApiVersionInYamlText`**.
+ * @param {string} root корінь репозиторію
+ * @param {(msg: string) => void} fail
+ * @param {(msg: string) => void} pass
+ * @returns {Promise<void>}
+ */
+async function rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, fail, pass) {
+  const yamlFiles = await findK8sYamlFiles(root)
+  for (const abs of yamlFiles) {
+    const rel = (relative(root, abs) || abs).replaceAll('\\', '/')
+    try {
+      const raw = await readFile(abs, 'utf8')
+      const { changed, content } = replaceBatchV1beta1ApiVersionInYamlText(raw)
+      if (changed) {
+        await writeFile(abs, content, 'utf8')
+        pass(`${rel}: оновлено apiVersion batch/v1beta1 → batch/v1 (k8s.mdc)`)
+      }
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      fail(`${rel}: не вдалося прочитати/записати при заміні batch/v1beta1 → batch/v1 (${msg})`)
+    }
+  }
+}
+
 /**
  * Прибирає BOM і ділить на рядки.
  * @param {string} content вміст файлу
@@ -4819,6 +4888,8 @@ export async function check() {
 
   const root = process.cwd()
 
+  await rewriteBatchV1beta1ApiVersionInK8sYamlFiles(root, fail, pass)
+
   await removeBackendConfigOnlyK8sYamlFiles(root, fail, pass)
 
   const yamlFiles = await findK8sYamlFiles(root)