@nitra/cursor 1.37.0 → 1.39.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.39.0] - 2026-05-31
+
+### Changed
+
+- worktree skill: додати auto завжди до meta.json
+- rules: автодетект перенесено з хардкоду auto-rules.mjs + auto.md на data-driven meta.json (glob/predicate/deps); увімкнено автодетект tauri
+
+## [1.38.0] - 2026-05-31
+
+### Added
+
+- worktree: кросплатформний CLI n-cursor worktree (add/remove/list/prune) — виконавець конвенції .worktrees/ з інвентарним файлом-описом; тонкий skill worktree; pure-doc правило worktree
+
 ## [1.37.0] - 2026-05-31
 
 ### Changed

package/README.md

@@ -68,6 +68,12 @@
 npx @nitra/cursor
 npx @nitra/cursor fix
 npx @nitra/cursor fix bun ga
+
+# Керування git-worktree (.worktrees/ + інвентарний файл-опис)
+npx @nitra/cursor worktree add <branch> "<опис>"
+npx @nitra/cursor worktree list
+npx @nitra/cursor worktree remove <branch> [--force]
+npx @nitra/cursor worktree prune
 ```
 
 Команда `check` запускає programmatic перевірки з каталогу `scripts/` пакету. Якщо в корені репозиторію вже є `.n-cursor.json`, перед перевірками виконується зчитування конфігу — зокрема додається або виправляється поле `$schema`, якщо воно відсутнє або не збігається з очікуваним URL.

package/bin/n-cursor.js

@@ -103,6 +103,7 @@ import { syncClaudeConfig } from '../scripts/sync-claude-config.mjs'
 import { upgradeNitraCursorToLatestAndBunInstall } from '../scripts/upgrade-nitra-cursor-and-install.mjs'
 import { runRenameYamlExtensionsCli } from './rename-yaml-extensions.mjs'
 import { runSkillsCli } from '../scripts/skills-cli.mjs'
+import { runWorktreeCli } from '../scripts/worktree-cli.mjs'
 import { syncSetupBunDepsAction } from '../scripts/sync-setup-bun-deps-action.mjs'
 import { runLintCli } from '../scripts/lib/run-lint-cli.mjs'
 import { formatTimingSummary } from '../scripts/lib/timing-summary.mjs'
@@ -1525,6 +1526,11 @@ try {
 
       break
     }
+    case 'worktree': {
+      process.exitCode = await runWorktreeCli(args)
+
+      break
+    }
     case undefined:
     case '': {
       await runSync()
@@ -1534,7 +1540,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, change, release, skill`
+        `   Очікується: (без аргументів) синхронізація правил, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, coverage, change, release, skill, worktree`
       )
       process.exitCode = 1
     }

package/package.json

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

package/rules/abie/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "repoUrlMarker", "arg": "https://github.com/abinbevefes/" } }

package/rules/adr/meta.json

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

package/rules/bun/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "package.json" } }

package/rules/capacitor/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/capacitor.config.json" } }

package/rules/changelog/meta.json

@@ -0,0 +1 @@
+{ "auto": ["bun"] }

package/rules/ci4/meta.json

@@ -0,0 +1 @@
+{}

package/rules/docker/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ["**/Dockerfile", "**/Dockerfile.*"] } }

package/rules/efes/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "repoUrlMarker", "arg": "https://github.com/efes-cloud/" } }

package/rules/feedback/meta.json

@@ -0,0 +1 @@
+{}

package/rules/ga/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ".github/workflows/**" } }

package/rules/graphql/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "gqlTaggedTemplate" } }

package/rules/hasura/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "hasuraConfigMarker" } }

package/rules/image-avif/meta.json

@@ -0,0 +1 @@
+{ "auto": ["vue", "image-compress"] }

package/rules/image-compress/meta.json

@@ -0,0 +1 @@
+{ "auto": ["bun"] }

package/rules/js-bun-db/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "jsBunDbSignal" } }

package/rules/js-bun-redis/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "depInAnyPackageJson", "arg": ["ioredis", "node-redis"] } }

package/rules/js-lint/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ["**/*.mjs", "**/*.cjs", "**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"] } }

package/rules/js-mssql/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "depInAnyPackageJson", "arg": ["mssql"] } }

package/rules/js-run/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "nestedPackageWithoutVite" } }

package/rules/k8s/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/k8s/**" } }

package/rules/nginx-default-tpl/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ["**/default.conf.template", "**/default.conf", "**/nginx.conf"] } }

package/rules/npm-module/js/rule_meta.mjs

@@ -0,0 +1,63 @@
+/**
+ * Перевірка метаданих правил пакета `@nitra/cursor` (концерн правила npm-module).
+ *
+ * Кожен `npm/rules/<id>/` має містити валідний `meta.json`:
+ *  - `auto` (якщо присутнє) — розпізнане `parseRuleAutoSpec` (завжди / масив / glob / predicate);
+ *  - для `predicate` — імʼя є в реєстрі `RULE_PREDICATES`;
+ *  - залишковий `auto.md` заборонено (міграція на meta.json завершена).
+ *
+ * Застосовний лише в репо пакета (де є `npm/rules/`); у споживача каталогу нема — пропуск.
+ */
+import { existsSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { parseRuleAutoSpec, readRuleMetaRaw } from '../../../scripts/lib/rule-meta.mjs'
+import { RULE_PREDICATES } from '../../../scripts/lib/rule-predicates.mjs'
+
+/**
+ * Валідує всі `npm/rules/<id>/meta.json`.
+ * @param {string} [cwd] корінь репозиторію
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function check(cwd = process.cwd()) {
+  const reporter = createCheckReporter()
+  const rulesDir = join(cwd, 'npm', 'rules')
+  if (!existsSync(rulesDir)) {
+    reporter.pass('npm/rules/ відсутній — немає правил для валідації')
+    return Promise.resolve(reporter.getExitCode())
+  }
+
+  for (const entry of readdirSync(rulesDir, { withFileTypes: true })) {
+    if (!entry.isDirectory() || entry.name.startsWith('.')) continue
+    const id = entry.name
+    const ruleDir = join(rulesDir, id)
+    let ruleOk = true
+
+    if (existsSync(join(ruleDir, 'auto.md'))) {
+      reporter.fail(`rules/${id}: залишковий auto.md — видали (метадані тепер у meta.json)`)
+      ruleOk = false
+    }
+
+    const raw = readRuleMetaRaw(ruleDir)
+    if (!raw) {
+      reporter.fail(`rules/${id}: відсутній або невалідний meta.json`)
+      continue
+    }
+    if (raw.auto !== undefined) {
+      const spec = parseRuleAutoSpec(raw.auto)
+      if (spec === null) {
+        reporter.fail(`rules/${id}: meta.json.auto нерозпізнане (очікується "завжди" / масив / {glob} / {predicate})`)
+        ruleOk = false
+      } else if ('predicate' in spec && !Object.hasOwn(RULE_PREDICATES, spec.predicate)) {
+        reporter.fail(`rules/${id}: невідомий predicate "${spec.predicate}" (немає в RULE_PREDICATES)`)
+        ruleOk = false
+      }
+    }
+    if (ruleOk) {
+      reporter.pass(`rules/${id}: meta.json валідний`)
+    }
+  }
+
+  return Promise.resolve(reporter.getExitCode())
+}

package/rules/npm-module/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "npm/**" } }

package/rules/php/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "composer.json" } }

package/rules/rego/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/*.rego" } }

package/rules/release/meta.json

@@ -0,0 +1 @@
+{}

package/rules/rust/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/Cargo.toml" } }

package/rules/security/meta.json

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

package/rules/style-lint/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": ["**/*.css", "**/*.vue"] } }

package/rules/tauri/meta.json

@@ -0,0 +1 @@
+{ "auto": { "predicate": "depInAnyPackageJson", "arg": ["@tauri-apps/api"] } }

package/rules/test/meta.json

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

package/rules/text/meta.json

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

package/rules/vue/meta.json

@@ -0,0 +1 @@
+{ "auto": { "glob": "**/*.vue" } }

package/rules/worktree/fix.mjs

@@ -0,0 +1,19 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
+import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
+
+/**
+ * Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
+ * Library mode: викликається CLI orchestration через `import + run(ctx)`.
+ * @param {import('../../scripts/lib/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
+ * @returns {Promise<number>} 0 — OK, 1 — порушення
+ */
+export function run(ctx) {
+  return runStandardRule(import.meta.dirname, ctx)
+}
+
+if (isRunAsCli(import.meta.url)) {
+  // Standalone: bun rules/<id>/fix.mjs — повний еквівалент `npx @nitra/cursor fix <id>`
+  // (config-loading + whitelist + summary). Дві ролі fix.mjs: library (run) + standalone (main).
+  // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  process.exit(await runRuleCli(import.meta.dirname))
+}

package/rules/worktree/meta.json

@@ -0,0 +1 @@
+{}

package/rules/worktree/worktree.mdc

@@ -0,0 +1,34 @@
+---
+description: Конвенція git-worktree у цьому репо — створення, інвентаризація та прибирання через n-cursor worktree CLI.
+globs:
+alwaysApply: true
+---
+
+# Worktree-конвенція
+
+Усі git-worktree створюй і прибирай через CLI `n-cursor worktree` — він кладе їх у
+`.worktrees/` (gitignored) і веде інвентарний файл-опис поруч.
+
+## Розташування
+
+```
+.worktrees/
+  feat-skill-meta/        ← git worktree checkout
+  feat-skill-meta.md      ← інвентарний опис поруч (gitignored через .worktrees/)
+```
+
+Слеш у гілці перетворюється на дефіс: `feat/skill-meta` → `.worktrees/feat-skill-meta/`.
+Git-гілка лишається з оригінальним імʼям (`feat/skill-meta`).
+
+## Команди
+
+- **Створити** (опис обовʼязковий): `npx @nitra/cursor worktree add <branch> "<навіщо>"`
+- **Інвентаризація**: `npx @nitra/cursor worktree list`
+- **Прибрати**: `npx @nitra/cursor worktree remove <branch> [--force]`
+- **Прибрати осиротілі**: `npx @nitra/cursor worktree prune`
+
+## Заборони
+
+- Не клади worktree в `.claude/worktrees/` — це приватна директорія харнесу Claude Code.
+- Не клади worktree в батьківський каталог `../cursor-<name>` — ускладнює інвентаризацію.
+- Не створюй worktree вручну (`git worktree add`) повз CLI — інакше не буде інвентарного опису.

package/schemas/rule-meta.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://unpkg.com/@nitra/cursor/schemas/rule-meta.json",
+  "title": "n-cursor rule meta",
+  "description": "Метадані правила @nitra/cursor: умова автоактивації (auto). Файл npm/rules/<id>/meta.json.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "auto": {
+      "description": "Умова автоактивації правила: \"завжди\", масив id правил-залежностей, glob, або іменований предикат.",
+      "oneOf": [
+        { "const": "завжди" },
+        { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+        {
+          "type": "object",
+          "required": ["glob"],
+          "additionalProperties": false,
+          "properties": {
+            "glob": {
+              "oneOf": [
+                { "type": "string", "minLength": 1 },
+                { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["predicate"],
+          "additionalProperties": false,
+          "properties": {
+            "predicate": { "type": "string", "minLength": 1 },
+            "arg": {}
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/v8r-catalog.json

@@ -30,6 +30,11 @@
       "name": "n-cursor skill meta",
       "fileMatch": ["npm/skills/*/meta.json"],
       "url": "https://unpkg.com/@nitra/cursor/schemas/skill-meta.json"
+    },
+    {
+      "name": "n-cursor rule meta",
+      "fileMatch": ["npm/rules/*/meta.json"],
+      "url": "https://unpkg.com/@nitra/cursor/schemas/rule-meta.json"
     }
   ]
 }