@nitra/cursor 1.40.1 → 1.41.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.41.0] - 2026-05-31
+
+### Changed
+
+- js-lint: канон oxlint оновлено — додано 13 правил @e18e/eslint-plugin і ignorePatterns (npm/types/**, demo/node/rules-demo.js)
+- js-lint: мінімальна версія @nitra/eslint-config піднята до 3.10.0 (Rego package_json + js-lint.mdc v1.27)
+
 ## [1.40.1] - 2026-05-31
 
 ### Changed

package/package.json

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

package/rules/js-bun-db/js-bun-db.mdc

@@ -2,7 +2,7 @@
 description: Використання pg / mysql2 / Bun SQL у Node.js та Bun
 globs: "**/package.json,**/src/conn/**"
 alwaysApply: false
-version: '1.12'
+version: '1.14'
 ---
 
 ## Підтримувані версії баз даних
@@ -57,16 +57,12 @@ const sql = format(`MERGE INTO t USING (VALUES %s) AS s(id, date, data) ON ...`,
 await pgWrite.unsafe(sql)
 
 // ✅ UNNEST — 3 параметри незалежно від розміру batch; план стабільний і може кешуватись
-const ids   = batch.map(r => r.id)
-const dates = batch.map(r => r.date)
-const data  = batch.map(r => JSON.stringify(r.data))
-
 await pgWrite`
   WITH s(id, date, data) AS (
     SELECT * FROM unnest(
-      ${ids}::int[],
-      ${dates}::date[],
-      ${data}::jsonb[]
+      ${pgWrite.array(batch.map(r => r.id),   'int4')},
+      ${pgWrite.array(batch.map(r => r.date), 'date')},
+      ${pgWrite.array(batch.map(r => r.data), 'jsonb')}
     )
   )
   MERGE INTO my_table AS t
@@ -98,6 +94,22 @@ await pgWrite`
 `
 ```
 
+## JSONB-параметри: без `JSON.stringify`
+
+Bun SQL серіалізує JS-об'єкти й масиви у JSON автоматично — викликати `JSON.stringify` перед передачею в `::jsonb` / `::jsonb[]` **заборонено**.
+
+```javascript
+// ❌ зайвий JSON.stringify — подвійна серіалізація або зайвий рядок
+await sql`INSERT INTO events (details) VALUES (${JSON.stringify(detailsForEvent)}::jsonb)`
+
+await sql`SELECT * FROM unnest(${sql.array(batch.map(r => JSON.stringify(r.data)), 'jsonb')})`
+
+// ✅ об'єкт/масив передається напряму
+await sql`INSERT INTO events (details) VALUES (${detailsForEvent}::jsonb)`
+
+await sql`SELECT * FROM unnest(${sql.array(batch.map(r => r.data), 'jsonb')})`
+```
+
 `UNION ALL`-цикл замість `unnest` підходить для малих динамічних запитів (2–5 рядків), де кожна гілка семантично різна. Для bulk upsert — завжди `unnest`.
 
 ### Заборонений «drop-in» шим

package/rules/js-lint/js/data/tooling/oxlint-canonical.json

@@ -5,6 +5,19 @@
   "categories": {},
   "rules": {
     "e18e/prefer-includes": "error",
+    "e18e/prefer-array-fill": "deny",
+    "e18e/prefer-array-to-reversed": "deny",
+    "e18e/prefer-array-to-sorted": "deny",
+    "e18e/prefer-array-to-spliced": "deny",
+    "e18e/prefer-nullish-coalescing": "deny",
+    "e18e/prefer-spread-syntax": "deny",
+    "e18e/prefer-url-canparse": "deny",
+    "e18e/ban-dependencies": "deny",
+    "e18e/prefer-array-from-map": "deny",
+    "e18e/prefer-timer-args": "deny",
+    "e18e/prefer-static-regex": "deny",
+    "e18e/prefer-date-now": "deny",
+    "e18e/prefer-regex-test": "deny",
     "array-callback-return": "deny",
     "no-new-wrappers": "deny",
     "import/no-named-as-default": "deny",

package/rules/js-lint/js/tooling.mjs

@@ -213,7 +213,7 @@ async function checkEslintConfig(passFn, failFn, cwd) {
 }
 
 // Перевірки `prettier` / `@nitra/prettier-config` у залежностях (text.mdc) і
-// `@nitra/eslint-config ≥ 3.9.2` тепер у Rego: відповідно
+// `@nitra/eslint-config ≥ 3.10.0` тепер у Rego: відповідно
 // `npm/policy/text/package_json/` і `npm/policy/js_lint/package_json/`. Тут
 // лишилася лише workspace-ітерація для `type: "module"` і engines, бо js_lint
 // Rego запускається лише на кореневому `package.json`.

package/rules/js-lint/js-lint.mdc

@@ -2,10 +2,10 @@
 description: Перевірка JavaScript коду
 globs: "**/{.oxlintrc.json,eslint.config.js,.jscpd.json,knip.json,package.json},**/*.{js,mjs,cjs,jsx,ts,tsx}"
 alwaysApply: false
-version: '1.26'
+version: '1.28'
 ---
 
-**oxlint**, **ESLint**, **jscpd**, **knip**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`**, **`bunx knip`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config` мінімум `^3.9.2`** (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd/knip не додавай без потреби монорепо.
+**oxlint**, **ESLint**, **jscpd**, **knip**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`**, **`bunx knip`** (у CI без **`--fix`** для oxlint/eslint — див. приклад workflow нижче). Без **prettier** і **@nitra/prettier-config**. У **`devDependencies`** має бути **`@nitra/eslint-config`** — версія не нижче канонічного мінімуму зі snippet нижче (semver-поріг, єдине джерело істини) (з **3.8.0** правило `no-restricted-syntax` забороняє `for...in`; з **3.9.2** у `getConfig` вбудовано ignore для **`**/adr/**`** — ADR-документи не валідуються ESLint, локально цей glob додавати не потрібно; також транзитивно йде **`@e18e/eslint-plugin`** для oxlint); пакет **`@e18e/eslint-plugin`** окремо не додавай. Пакети oxlint/eslint/jscpd/knip не додавай без потреби монорепо.
 
 У кожному **`package.json`** проєкту (корінь і всі workspace-пакети) має бути **`"type": "module"`** — весь код у ESM.
 
@@ -16,12 +16,12 @@ version: '1.26'
     "lint-js": "bunx oxlint --fix && bunx eslint --fix . && bunx jscpd . && bunx knip --no-config-hints"
   },
   "devDependencies": {
-    "@nitra/eslint-config": "^3.9.4"
+    "@nitra/eslint-config": "^3.10.0"
   }
 }
 ```
 
-Канон `type` + `scripts.lint-js` (substring requirement): [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
+Канон `type` + `scripts.lint-js` (substring requirement) і мінімальна `@nitra/eslint-config` (semver-поріг `devDependencies`): [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
 
 У `.vscode/extensions.json` `recommendations` мають містити `dbaeumer.vscode-eslint`, `github.vscode-github-actions`, `oxc.oxc-vscode`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
 

package/rules/js-lint/policy/package_json/package_json.rego

@@ -2,11 +2,13 @@
 #
 # Канон надходить через --data: { "template": { "snippet": ... } }
 # Структура --data сформована з template/package.json.snippet.json
-# (canonical `type` + `scripts.lint-js`).
+# (canonical `type` + `scripts.lint-js` + `devDependencies.@nitra/eslint-config` як мін-поріг).
 #
-# Логіка, що ЛИШАЄТЬСЯ у rego (inverse, не виноситься у template):
-#  - `engines.node` >= 24, `engines.bun` >= 1.3 (semver range parsing);
-#  - `@nitra/eslint-config` >= 3.9.2 (semver range parsing).
+# Мінімальна версія `@nitra/eslint-config` — ЄДИНЕ джерело в snippet
+# (`devDependencies.@nitra/eslint-config`); rego лише парсить поріг і робить semver-порівняння.
+#
+# Логіка, що ЛИШАЄТЬСЯ у rego (inverse, без template-значення):
+#  - `engines.node` >= 24, `engines.bun` >= 1.3 (semver range parsing).
 package js_lint.package_json
 
 import rego.v1
@@ -44,7 +46,7 @@ deny contains msg if {
 	msg := "package.json: engines.bun має бути >= 1.3 (js-lint.mdc)"
 }
 
-# ── deny: @nitra/eslint-config >= 3.9.2 (inverse) ───────────────────────
+# ── deny: @nitra/eslint-config >= snippet-поріг ─────────────────────────
 
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
@@ -56,11 +58,17 @@ deny contains msg if {
 	range := object.get(object.get(input, "devDependencies", {}), "@nitra/eslint-config", "")
 	range != ""
 	not eslint_config_meets_min(range)
-	msg := sprintf("package.json: @nitra/eslint-config має бути >= 3.9.2 (зараз %q) (js-lint.mdc)", [range])
+	msg := sprintf("package.json: @nitra/eslint-config має бути >= %s (зараз %q) (js-lint.mdc)", [eslint_min_display, range])
 }
 
 # ── helpers ──────────────────────────────────────────────────────────────
 
+# Канонічний мін-поріг `@nitra/eslint-config` із snippet (напр. "^3.10.0").
+eslint_min_range := object.get(object.get(data.template.snippet, "devDependencies", {}), "@nitra/eslint-config", "")
+
+# Поріг для повідомлення без діапазонних префіксів (напр. "3.10.0").
+eslint_min_display := trim_left(eslint_min_range, "^~>=v ")
+
 normalize_script(s) := regex.replace(trim_space(s), `\s+`, " ")
 
 engines_node_meets(spec) if {
@@ -84,24 +92,25 @@ engines_bun_meets(spec) if {
 eslint_config_meets_min(range) if startswith(trim_space(range), "workspace:")
 
 eslint_config_meets_min(range) if {
-	parts := split_to_numbers(range)
-	count(parts) >= 3
-	parts[0] > 3
+	actual := split_to_numbers(range)
+	count(actual) >= 3
+	min_parts := split_to_numbers(eslint_min_range)
+	count(min_parts) >= 3
+	semver_gte(actual, min_parts)
 }
 
-eslint_config_meets_min(range) if {
-	parts := split_to_numbers(range)
-	count(parts) >= 3
-	parts[0] == 3
-	parts[1] > 9
+# actual >= min_parts за major.minor.patch (лексикографічно).
+semver_gte(a, b) if a[0] > b[0]
+
+semver_gte(a, b) if {
+	a[0] == b[0]
+	a[1] > b[1]
 }
 
-eslint_config_meets_min(range) if {
-	parts := split_to_numbers(range)
-	count(parts) >= 3
-	parts[0] == 3
-	parts[1] == 9
-	parts[2] >= 2
+semver_gte(a, b) if {
+	a[0] == b[0]
+	a[1] == b[1]
+	a[2] >= b[2]
 }
 
 first_major(spec) := major if {

package/rules/js-lint/policy/package_json/template/package.json.snippet.json

@@ -2,5 +2,8 @@
   "type": "module",
   "scripts": {
     "lint-js": "bunx oxlint --fix && bunx eslint --fix . && bunx jscpd . && bunx knip --no-config-hints"
+  },
+  "devDependencies": {
+    "@nitra/eslint-config": "^3.10.0"
   }
 }

package/schemas/v8r-catalog.json

@@ -28,11 +28,13 @@
     },
     {
       "name": "n-cursor skill meta",
+      "description": "Маніфест skill-пакета n-cursor (npm/skills/<id>/meta.json) — назва, тригери, дозволи",
       "fileMatch": ["npm/skills/*/meta.json"],
       "url": "https://unpkg.com/@nitra/cursor/schemas/skill-meta.json"
     },
     {
       "name": "n-cursor rule meta",
+      "description": "Маніфест rule-пакета n-cursor (npm/rules/<id>/meta.json) — назва, опис, версія правила",
       "fileMatch": ["npm/rules/*/meta.json"],
       "url": "https://unpkg.com/@nitra/cursor/schemas/rule-meta.json"
     }