@nitra/cursor 1.38.0 → 1.39.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.39.1] - 2026-05-31
+
+### Changed
+
+- worktree rule: при завершенні гілки worktree за замовчуванням пропонувати squash-merge (один коміт)
+
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.38.0",
+  "version": "1.39.1",
   "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

@@ -27,6 +27,20 @@ Git-гілка лишається з оригінальним імʼям (`feat/
 - **Прибрати**: `npx @nitra/cursor worktree remove <branch> [--force]`
 - **Прибрати осиротілі**: `npx @nitra/cursor worktree prune`
 
+## Завершення гілки worktree
+
+Коли робота у worktree завершена і її треба влити в базову гілку — **за замовчуванням пропонуй
+squash-merge** (уся гілка одним комітом), а не fast-forward чи merge-комітом. Worktree — це одна
+логічна задача, тож в історії базової гілки їй відповідає **один** коміт; проміжні TDD-коміти
+(«додав парсер», «видалив auto.md» тощо) у базовій гілці не потрібні. Реліз і `CHANGELOG`
+агрегуються за change-файлом, не за кількістю комітів, тож squash нічого не ламає.
+
+```bash
+git checkout <base> && git merge --squash <branch> && git commit
+```
+
+Якщо користувач явно просить зберегти поетапну історію — лише тоді fast-forward / merge-коміт.
+
 ## Заборони
 
 - Не клади worktree в `.claude/worktrees/` — це приватна директорія харнесу Claude Code.

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"
     }
   ]
 }