@nitra/cursor 1.9.5 → 1.9.6

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.9.6] - 2026-05-12
+
+### Changed
+
+- **js-lint — ігнорувати `.claude/worktrees/` для jscpd і всіх лінтів:** правило `js-lint.mdc` (v1.18) тепер документує, що каталог `.claude/worktrees/` (робочі копії, які Claude Code створює через superpowers-skill `using-git-worktrees`) має бути виключений з лінт-перевірок. Канонічне місце — `.gitignore` (паралельні воркті — це за визначенням не-комітні робочі копії; `gitignore: true` у `.jscpd.json` уже є, тож запис у `.gitignore` каскадно вимикає сканування). Як страховку на випадок запуску jscpd без `gitignore: true` рекомендовано додати `.claude/worktrees/**` у `ignore` `.jscpd.json` — приклад у правилі оновлено. Без цього `bunx jscpd .` фіксує дзеркальні «клони» між кореневим репо і його worktree-копією у `.claude/worktrees/<name>/…`.
+
 ## [1.9.5] - 2026-05-12
 
 ### Changed
@@ -18,7 +24,7 @@
 
 ### Removed
 
-- **graphql — вимога `scripts.dump-schema` у `package.json` прибрана:** правило `graphql.mdc` більше не вимагає канонічний скрипт `dump-schema` (раніше — `bunx graphqurl http://localhost:4040/v1/graphql -H 'X-Hasura-Admin-Secret: secret' --introspect > schema.graphql`) у корені проєкту за наявності gql tagged template literals. У `.mdc` відповідну буліт-точку та JSON-фрагмент видалено; фраза про «стандартний спосіб оновлення локальної `schema.graphql`» теж прибрана з підсумкового речення. Каталог `npm/policy/graphql/` (єдиний файл `package_json/package_json.rego` з deny-правилами на відсутність/неканонічний `scripts.dump-schema`) видалено повністю. Запис реєстру `graphql.package_json` (policyDir `graphql`, rule `graphql`, single `package.json`) прибрано з `npm/scripts/lint-conftest.mjs` (заголовок секції перейменовано — `graphql` вилучено). JSDoc-преамбулу `npm/scripts/check-graphql.mjs` оновлено: видалено абзац про rego-порт перевірки `dump-schema` і згадку `scripts.dump-schema` з докстрингу `check()`. Сам JS-чек і так не торкався `package.json` — після видалення rego-полісі ніяких runtime-перевірок `dump-schema` не лишається. У кореневому `package.json` репо cursor скрипт `dump-schema` теж видалено, оскільки тримати його як shim без правила немає сенсу.
+- **graphql — вимога `scripts.dump-schema` у `package.json` прибрана:** правило `graphql.mdc` більше не вимагає канонічний скрипт `dump-schema` (раніше — `bunx graphqurl http://localhost:4040/v1/graphql -H 'X-Hasura-Admin-Secret: secret' --introspect > schema.graphql`) у корені проєкту за наявності gql tagged template literals. У `.mdc` відповідну буліт-точку та JSON-фрагмент видалено; фраза про «стандартний спосіб оновлення локальної `schema.graphql`» теж прибрана з підсумкового речення. Каталог `npm/policy/graphql/` (єдиний файл `package_json/package_json.rego` з deny-правилами на відсутність/неканонічний `scripts.dump-schema`) видалено повністю. Запис реєстру `graphql.package_json` (policyDir `graphql`, rule `graphql`, single `package.json`) прибрано з `npm/scripts/lint-conftest.mjs` (заголовок секції перейменовано — `graphql` вилучено). JSDoc-преамбулу `npm/scripts/check-graphql.mjs` оновлено: видалено абзац про rego-порт перевірки `dump-schema` і згадку `scripts.dump-schema` з JSDoc функції `check()`. Сам JS-чек і так не торкався `package.json` — після видалення rego-полісі ніяких runtime-перевірок `dump-schema` не лишається. У кореневому `package.json` репо cursor скрипт `dump-schema` теж видалено, оскільки тримати його як shim без правила немає сенсу.
 
 ## [1.9.3] - 2026-05-11
 

package/mdc/js-lint.mdc

@@ -1,7 +1,7 @@
 ---
 description: Перевірка JavaScript коду
 alwaysApply: true
-version: '1.17'
+version: '1.18'
 ---
 
 **oxlint**, **ESLint**, **jscpd**. У скрипті **`lint-js`** і в CI — **`bunx oxlint`**, **`bunx eslint`**, **`bunx jscpd`** (у 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 не додавай без потреби монорепо.
@@ -43,7 +43,9 @@ version: '1.17'
 }
 ```
 
-У корені проєкту має бути `.jscpd.json`. Мінімум: увімкнути облік `.gitignore`, ненульовий код виходу при знаходженні клонів, консольний звіт. За потреби додай `ignore` (дзеркальні каталоги, шаблони) та `minLines`, щоб відсікти дрібні збіги:
+У корені проєкту має бути `.jscpd.json`. Мінімум: увімкнути облік `.gitignore`, ненульовий код виходу при знаходженні клонів, консольний звіт. За потреби додай `ignore` (дзеркальні каталоги, шаблони) та `minLines`, щоб відсікти дрібні збіги.
+
+Каталог `.claude/worktrees/` (робочі копії, які Claude Code створює через **superpowers:using-git-worktrees**) має ігноруватися: додай його у кореневий `.gitignore` (це штатне місце для не-комітних робочих копій), а в `.jscpd.json` додай `.claude/worktrees/**` у `ignore` як страховку на випадок запуску без `gitignore: true`. Без цього jscpd сканує паралельну копію репо в worktree і фіксує самозбіги між дзеркальними файлами.
 
 ```json title=".jscpd.json"
 {
@@ -51,10 +53,14 @@ version: '1.17'
   "exitCode": 1,
   "reporters": ["console"],
   "minLines": 25,
-  "ignore": ["**/dist/**"]
+  "ignore": [".claude/worktrees/**", "**/dist/**"]
 }
 ```
 
+```text title=".gitignore (фрагмент)"
+.claude/worktrees/
+```
+
 ## jscpd: рефакторинг і структура
 
 Коли **jscpd** знаходить клони, спочатку зменшуй дублювання кодом, а не конфігом.

package/package.json

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

package/scripts/check-npm-module.mjs

@@ -80,6 +80,13 @@ const TEST_FRAMEWORK_MODULES = new Set([
   'tape'
 ])
 
+/** Символи у glob-сегменті, які треба екранувати для RegExp (без `*` / `?` — їх обробляємо окремо). */
+const REGEX_SPECIAL_IN_GLOB = new Set(['.', '+', '^', '$', '{', '}', '(', ')', '|', '[', ']', '\\'])
+
+/** Збіги для post-обробки glob → regex після злиття сегментів через `/` (див. `globToRegex`). */
+const GLOBSTAR_LEADING_RE = /^__GLOBSTAR__\//u
+const GLOBSTAR_TRAILING_RE = /\/__GLOBSTAR__$/u
+
 /**
  * Чи є під `npm/src` хоча б один `.js` (рекурсивно).
  * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
@@ -338,13 +345,13 @@ function checkPublishWorkflow(passFn, failFn) {
 }
 
 /**
- * Перетворює glob-патерн (як у npm `files`) у анкоровану `RegExp`. Підтримує
- * globstar (нуль або більше сегментів), `*` (символи без `/`) і `?` (один
- * символ без `/`). Не підтримує brace-expansion і class `[…]` — у негативних
- * патернах `files` цього достатньо для практичних випадків (приклад:
- * negation з префіксом `!` і двома зірочками поряд з `_test.rego`).
+ * Перетворює glob-патерн (як у npm `files`) у `RegExp` з якорями `^` / `$`.
+ * Підтримує globstar (нуль або більше сегментів), `*` (символи без `/`) і `?`
+ * (один символ без `/`). Не підтримує brace-expansion і class `[…]` — у
+ * негативних патернах `files` цього достатньо для практичних випадків
+ * (приклад: negation з префіксом `!` і двома зірочками поряд з `_test.rego`).
  * @param {string} glob posix-шлях у glob-нотації
- * @returns {RegExp} регулярка, анкорована з обох боків
+ * @returns {RegExp} `RegExp` з якорями `^` / `$`
  */
 export function globToRegex(glob) {
   const parts = glob.split('/')
@@ -354,16 +361,16 @@ export function globToRegex(glob) {
     for (const c of p) {
       if (c === '*') out += '[^/]*'
       else if (c === '?') out += '[^/]'
-      else if ('.+^${}()|[]\\'.includes(c)) out += `\\${c}`
+      else if (REGEX_SPECIAL_IN_GLOB.has(c)) out += `\\${c}`
       else out += c
     }
     return out
   })
   let re = tokens.join('/')
-  re = re.replace(/\/__GLOBSTAR__\//gu, '(?:/.*/|/)')
-  re = re.replace(/^__GLOBSTAR__\//u, '(?:.*/)?')
-  re = re.replace(/\/__GLOBSTAR__$/u, '(?:/.*)?')
-  re = re.replace(/__GLOBSTAR__/gu, '.*')
+  re = re.replaceAll('/__GLOBSTAR__/', '(?:/.*/|/)')
+  re = re.replace(GLOBSTAR_LEADING_RE, '(?:.*/)?')
+  re = re.replace(GLOBSTAR_TRAILING_RE, '(?:/.*)?')
+  re = re.replaceAll('__GLOBSTAR__', '.*')
   return new RegExp(`^${re}$`, 'u')
 }
 
@@ -449,7 +456,7 @@ export function findTestFrameworkImport(content, virtualPath) {
  */
 export async function classifyPublishedFileAsTest(relPath) {
   const segments = relPath.split('/')
-  const base = segments[segments.length - 1]
+  const base = segments.at(-1)
   const dirs = segments.slice(0, -1)
   const testDir = dirs.find(seg => TEST_DIR_NAMES.has(seg.toLowerCase()))
   if (testDir) return `test-style каталог "${testDir}/"`
@@ -482,7 +489,7 @@ async function checkNoTestsInPublishedFiles(pass, fail) {
     if (reason) violations.push({ file: rel, reason })
   }
   if (violations.length === 0) {
-    pass(`npm/: усі ${files.length} опублікованих файли без тестів/фікстур`)
+    pass(`npm/: усі ${files.length} опублікованих файли без тестів і fixtures`)
     return
   }
   for (const v of violations) {