@nitra/cursor 1.14.0 → 1.15.1

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.15.1] - 2026-05-24
+
+### Fixed
+
+- `adr.mdc`: виправлено stale template-лінк `./js/hooks/template/.gitignore.snippet` → `./js/templates/hooks/.gitignore.snippet` (після flat-layout міграції `js/<concern>.mjs` у комміті `6ecd84c` шлях не оновили, через що `inlineTemplateLinks` падав під час `bun start` із `file not found`).
+
+## [1.15.0] - 2026-05-24
+
+### Added
+
+- **Нове правило `rust`** (`npm/rules/rust/`): канонічний скрипт `lint-rust` у `package.json` (`cargo fmt` → `cargo clippy --fix` → `cargo clippy ... -D warnings`), CI workflow `.github/workflows/lint-rust.yml` з `dtolnay/rust-toolchain@stable` (`components: rustfmt, clippy`) + `Swatinem/rust-cache@v2`, VSCode-розширення `rust-lang.rust-analyzer` + `tamasfe.even-better-toml`. Auto-trigger — наявність `Cargo.toml` (`hasCargoToml` fact у `auto-rules.mjs`). Три rego policy-пакети (`package_json`, `vscode_extensions`, `lint_rust_yml`) читають канон через `data.template.*` з drift-тестами.
+
+### Changed
+
+- **Правило `tauri` (1.1 → 1.2) звужено:** `rust-lang.rust-analyzer` більше не вимагається у `tauri.vscode_extensions` — перенесено в нове правило `rust`. Tauri-проєкт автоматично активує `rust` через `src-tauri/Cargo.toml`. Канон `tauri.mdc` оновлено: лишається лише `tauri-apps.tauri-vscode`.
+
 ## [1.14.0] - 2026-05-24
 
 ### Changed (BREAKING)

package/package.json

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

package/rules/adr/adr.mdc

@@ -95,7 +95,7 @@ docs/adr/
 └── hooks.json                 # Cursor Agent stop-hooks для тих самих скриптів
 ```
 
-`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене): [.gitignore.snippet](./js/hooks/template/.gitignore.snippet).
+`.gitignore` у корені проєкту повинен містити базові рядки (`node_modules/`, `dist/`, `*.secret`) і патерни для ADR Stop-hook (**`.claude/hooks/*.log`**, `.claude/hooks/.normalize-state`, `.claude/hooks/.normalize.lock`). Канонічний фрагмент (дописується `npx @nitra/cursor`, коли правило `adr` увімкнене): [.gitignore.snippet](./js/templates/hooks/.gitignore.snippet).
 
 ## Stop-hook у `.claude/settings.json`
 

package/rules/rust/auto.md

@@ -0,0 +1 @@
+якщо в проекті є хоч один Cargo.toml

package/rules/rust/fix.mjs

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

package/rules/rust/js/applies.mjs

@@ -0,0 +1,31 @@
+/**
+ * Applies-гейт правила rust: маркер — наявність `Cargo.toml` у `cwd` або
+ * в будь-якому workspace-підкаталозі (рекурсивний пошук з пропуском
+ * `node_modules`, `.git`, `.next`, `.turbo`). Якщо повертає `false` —
+ * `runStandardRule` пропускає всі концерни (JS і policy) цього правила.
+ * `check()` друкує тільки context-pass; реальна робота — у policy-концернах.
+ */
+import { existsSync } from 'node:fs'
+
+import { createCheckReporter } from '../../../scripts/utils/check-reporter.mjs'
+
+import { hasCargoTomlInTree } from '../utils/has-cargo-toml.mjs'
+
+const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo'])
+
+/**
+ * @returns {Promise<boolean>} `true` — правило застосовне; `false` — пропустити
+ */
+export function applies() {
+  if (existsSync('Cargo.toml')) return Promise.resolve(true)
+  return Promise.resolve(hasCargoTomlInTree(process.cwd(), IGNORED_DIR_NAMES))
+}
+
+/**
+ * @returns {number} exit-код (0 — OK, 1 — порушення)
+ */
+export function check() {
+  const reporter = createCheckReporter()
+  reporter.pass('Знайдено Cargo.toml — застосовуємо правила rust.mdc')
+  return reporter.getExitCode()
+}

package/rules/rust/policy/lint_rust_yml/lint_rust_yml.rego

@@ -0,0 +1,55 @@
+# Перевірка `.github/workflows/lint-rust.yml` для правила rust (rust.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/lint-rust.yml.snippet.yml.
+# Перевіряємо:
+#   - кожен `uses` з template (підмножина): actions/checkout@v6,
+#     dtolnay/rust-toolchain@stable, Swatinem/rust-cache@v2;
+#   - кожен `run` з template має бути присутнім (як substring) серед
+#     run-кроків input'а — drift-safe: зміна template одразу рухає перевірку.
+# Універсальні workflow-перевірки (name, concurrency, branches) — у `ga.workflow_common`.
+package rust.lint_rust_yml
+
+import rego.v1
+
+# Усі `uses` з канону workflow.
+expected_uses contains u if {
+	some step in data.template.snippet.jobs.lint.steps
+	u := object.get(step, "uses", "")
+	u != ""
+}
+
+# Усі `uses` з input workflow.
+actual_uses contains u if {
+	some job in object.get(input, "jobs", {})
+	some step in object.get(job, "steps", [])
+	u := object.get(step, "uses", "")
+	u != ""
+}
+
+# Конкатенація всіх `run`-кроків з input workflow.
+all_run_text := concat("\n", [run_text |
+	some job in object.get(input, "jobs", {})
+	some step in object.get(job, "steps", [])
+	run_text := step_run_to_text(step)
+])
+
+deny contains msg if {
+	some required_use in expected_uses
+	not required_use in actual_uses
+	msg := sprintf("lint-rust.yml: відсутній step з `uses: %s` (rust.mdc)", [required_use])
+}
+
+deny contains msg if {
+	some step in data.template.snippet.jobs.lint.steps
+	expected_run := object.get(step, "run", "")
+	expected_run != ""
+	not contains(all_run_text, expected_run)
+	msg := sprintf("lint-rust.yml: жоден крок run не містить %q (rust.mdc)", [expected_run])
+}
+
+step_run_to_text(step) := step.run if is_string(step.run)
+
+else := concat("\n", [s | some s in step.run]) if is_array(step.run)
+
+else := ""

package/rules/rust/policy/lint_rust_yml/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".github/workflows/lint-rust.yml", "required": true },
+  "missingMessage": ".github/workflows/lint-rust.yml не існує — створи з канонічним вмістом (rust.mdc)"
+}

package/rules/rust/policy/lint_rust_yml/template/lint-rust.yml.snippet.yml

@@ -0,0 +1,44 @@
+name: Lint Rust
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.rs'
+      - '**/Cargo.toml'
+      - '**/Cargo.lock'
+      - '**/rustfmt.toml'
+      - '**/clippy.toml'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Rustfmt
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings

package/rules/rust/policy/package_json/package_json.rego

@@ -0,0 +1,18 @@
+# Перевірка `package.json` для правила rust (rust.mdc).
+#
+# Канон надходить через --data: { "template": { "contains": ... } }
+# Структура --data сформована з template/package.json.contains.json.
+# Перевіряємо substring-вимоги до scripts.lint-rust: усі три кроки
+# (`cargo fmt`, `cargo clippy --fix`, фінальний `cargo clippy ... -D warnings`)
+# мають бути присутніми у значенні скрипта.
+package rust.package_json
+
+import rego.v1
+
+deny contains msg if {
+	some script_name, needles in data.template.contains.scripts
+	actual := object.get(object.get(input, "scripts", {}), script_name, "")
+	some needle in needles
+	not contains(actual, needle)
+	msg := sprintf("package.json: scripts.%s має містити %q (rust.mdc)", [script_name, needle])
+}

package/rules/rust/policy/package_json/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": "package.json", "required": true },
+  "missingMessage": "package.json не існує — створи зі scripts.lint-rust (rust.mdc)"
+}

package/rules/rust/policy/package_json/template/package.json.contains.json

@@ -0,0 +1,9 @@
+{
+  "scripts": {
+    "lint-rust": [
+      "cargo fmt --all",
+      "cargo clippy --fix --allow-staged --allow-dirty",
+      "cargo clippy --all-targets --all-features -- -D warnings"
+    ]
+  }
+}

package/rules/rust/policy/vscode_extensions/target.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
+  "files": { "single": ".vscode/extensions.json", "required": true },
+  "missingMessage": ".vscode/extensions.json не існує — створи з recommendations \"rust-lang.rust-analyzer\" і \"tamasfe.even-better-toml\" (rust.mdc)"
+}

package/rules/rust/policy/vscode_extensions/template/extensions.json.snippet.json

@@ -0,0 +1 @@
+{ "recommendations": ["rust-lang.rust-analyzer", "tamasfe.even-better-toml"] }

package/rules/rust/policy/vscode_extensions/vscode_extensions.rego

@@ -0,0 +1,15 @@
+# Перевірка `.vscode/extensions.json` для правила rust (rust.mdc).
+#
+# Канон надходить через --data: { "template": { "snippet": ... } }
+# Структура --data сформована з template/extensions.json.snippet.json.
+# Semantics: subset-of для recommendations — кожен з канону має бути присутнім,
+# інші екстеншени дозволені.
+package rust.vscode_extensions
+
+import rego.v1
+
+deny contains msg if {
+	some rec in data.template.snippet.recommendations
+	not rec in {r | some r in object.get(input, "recommendations", [])}
+	msg := sprintf(".vscode/extensions.json: recommendations має містити %q (rust.mdc)", [rec])
+}

package/rules/rust/rust.mdc

@@ -0,0 +1,27 @@
+---
+description: Перевірка Rust коду
+globs: "**/{Cargo.toml,Cargo.lock,rustfmt.toml,clippy.toml,.vscode/extensions.json,package.json},**/*.rs"
+alwaysApply: false
+version: '1.0'
+---
+
+**rustfmt** ([rust-lang/rustfmt](https://github.com/rust-lang/rustfmt)) — форматер; **clippy** ([rust-lang/rust-clippy](https://github.com/rust-lang/rust-clippy)) — лінтер. У скрипті **`lint-rust`** локально йдуть три кроки в одному рядку: `cargo fmt --all` → `cargo clippy --fix --allow-staged --allow-dirty --all-targets --all-features` → фінальний `cargo clippy --all-targets --all-features -- -D warnings`. У CI — без `--fix`: `cargo fmt --all -- --check` і `cargo clippy ... -- -D warnings` (див. `lint-rust.yml`).
+
+`cargo`, `rustfmt`, `clippy` не додавай у `devDependencies` — це Rust toolchain, ставиться через `rustup` локально або через `dtolnay/rust-toolchain@stable` у CI.
+
+Канон `scripts.lint-rust` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
+
+У `.vscode/extensions.json` `recommendations` мають містити `rust-lang.rust-analyzer` і `tamasfe.even-better-toml`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
+
+Канон workflow `.github/workflows/lint-rust.yml`: [lint-rust.yml.snippet.yml](./policy/lint_rust_yml/template/lint-rust.yml.snippet.yml)
+
+Перед **`./.github/actions/setup-bun-deps`** в інших workflows йде **`actions/checkout@v6`** (див. **ga.mdc**). У **lint-rust.yml** після checkout — `dtolnay/rust-toolchain@stable` (з `components: rustfmt, clippy`) + `Swatinem/rust-cache@v2` для кешу `~/.cargo` і `target/`. Bun composite дії тут не потрібен — toolchain ставиться напряму.
+
+## Композиція з Tauri
+
+Tauri-проєкт завжди має `src-tauri/Cargo.toml`, тому правило `rust` активується автоматично разом з `tauri`. Поділ обов'язків:
+
+- `rust` — `lint-rust` скрипт, `rust-analyzer`, `even-better-toml`, CI workflow.
+- `tauri` — `tauri-apps.tauri-vscode` (див. **tauri.mdc**).
+
+Обидва правила перевіряють `.vscode/extensions.json` за `contains`-семантикою; конкурентного запису немає.

package/rules/rust/utils/has-cargo-toml.mjs

@@ -0,0 +1,39 @@
+/**
+ * Rule-level applies-walker правила rust: рекурсивно шукає Cargo.toml у
+ * cwd або будь-якому workspace-підкаталозі. Пропускає `node_modules`, `.git`,
+ * `.next`, `.turbo` за тим самим списком, що `npm/scripts/auto-rules.mjs`.
+ *
+ * Утиліта rule-local, бо лише `rust` потребує "знайти Cargo.toml у дереві";
+ * якщо з'явиться другий споживач — підняти у `npm/scripts/utils/`.
+ */
+import { readdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+/**
+ * Чи присутній хоч один Cargo.toml у дереві `root` (синхронно, з раннім return).
+ * @param {string} root абсолютний шлях кореня
+ * @param {Set<string>} ignoredDirNames імена директорій, в які НЕ заходимо
+ * @returns {boolean} true, якщо знайдено Cargo.toml
+ */
+export function hasCargoTomlInTree(root, ignoredDirNames) {
+  /**
+   * @param {string} dir абсолютний шлях каталогу для обходу
+   * @returns {boolean} true якщо в піддереві є Cargo.toml
+   */
+  function walk(dir) {
+    let entries
+    try {
+      entries = readdirSync(dir, { withFileTypes: true })
+    } catch {
+      return false
+    }
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name === 'Cargo.toml') return true
+      if (entry.isDirectory() && !ignoredDirNames.has(entry.name)) {
+        if (walk(join(dir, entry.name))) return true
+      }
+    }
+    return false
+  }
+  return walk(root)
+}

package/rules/tauri/js/tooling.mjs

@@ -70,9 +70,7 @@ export async function check() {
 
   const extPath = '.vscode/extensions.json'
   if (!existsSync(extPath)) {
-    fail(
-      `${extPath} не існує — створи з recommendations "tauri-apps.tauri-vscode" і "rust-lang.rust-analyzer" (tauri.mdc)`
-    )
+    fail(`${extPath} не існує — створи з recommendations "tauri-apps.tauri-vscode" (tauri.mdc)`)
     return reporter.getExitCode()
   }
   const violations = runConftestBatch({

package/rules/tauri/policy/vscode_extensions/vscode_extensions.rego

@@ -1,24 +1,22 @@
 # Перевірка `.vscode/extensions.json` для tauri (tauri.mdc).
 #
-# Викликається з `rules/tauri/fix.mjs` через `runConftestBatch` лише ПІСЛЯ того,
-# як JS виявив маркер Tauri-проєкту (`src-tauri/` каталог, `tauri.conf.json`
-# у будь-якому пакеті, або залежність `@tauri-apps/*`). Без `target.json` поруч
-# (не auto-discoverable через `n-cursor fix`) — інакше false-positive порушення на не-Tauri проєктах.
+# Викликається з `rules/tauri/js/tooling.mjs` через `runConftestBatch` лише
+# ПІСЛЯ того, як JS виявив маркер Tauri-проєкту (`src-tauri/` каталог,
+# `tauri.conf.json` у будь-якому пакеті, або залежність `@tauri-apps/*`).
+# Без `target.json` поруч (не auto-discoverable через `n-cursor fix`) — це
+# conditional правило.
 #
-# Canonical (tauri.mdc): `recommendations` має містити обидва записи —
-#   - tauri-apps.tauri-vscode
-#   - rust-lang.rust-analyzer
-#
-# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+# Canonical (tauri.mdc): `recommendations` має містити `tauri-apps.tauri-vscode`.
+# `rust-lang.rust-analyzer` і `tamasfe.even-better-toml` — вимагаються правилом
+# `rust` (rust.mdc), бо Tauri-проєкт завжди має `src-tauri/Cargo.toml`.
 package tauri.vscode_extensions
 
 import rego.v1
 
-required_extensions := {"tauri-apps.tauri-vscode", "rust-lang.rust-analyzer"}
+required_extensions := {"tauri-apps.tauri-vscode"}
 
 missing_extension_template := ".vscode/extensions.json: recommendations має містити %q (tauri.mdc)"
 
-# Множина усіх записів `recommendations` (поза deny — performance/non-loop-expression).
 recommendations_set := {r | some r in object.get(input, "recommendations", [])}
 
 deny contains msg if {

package/rules/tauri/tauri.mdc

@@ -2,15 +2,15 @@
 description: Tauri
 globs: "**/src-tauri/**,**/tauri.conf.json"
 alwaysApply: false
-version: '1.1'
+version: '1.2'
 ---
 
-
-в файлі .vscode/extensions.json є налаштування для Vue:
+У `.vscode/extensions.json` `recommendations` має містити `tauri-apps.tauri-vscode`:
 
 ```json title=".vscode/extensions.json"
 {
-  "recommendations": ["tauri-apps.tauri-vscode",
-    "rust-lang.rust-analyzer"]
+  "recommendations": ["tauri-apps.tauri-vscode"]
 }
 ```
+
+Розширені Rust-вимоги (`rust-lang.rust-analyzer`, `tamasfe.even-better-toml`, скрипт `lint-rust`, CI `lint-rust.yml`) — у правилі **`rust`** (`n-rust.mdc`). Tauri-проєкт завжди має `src-tauri/Cargo.toml`, тому `rust` активується автоматично разом з `tauri`.

package/scripts/auto-rules.mjs

@@ -48,6 +48,7 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'npm-module',
   'php',
   'rego',
+  'rust',
   'security',
   'style-lint',
   'text',
@@ -291,6 +292,7 @@ function updateDirFacts(dirName, facts) {
  * @param {string} relPath шлях відносно кореня
  * @param {{
  *   hasCapacitorConfig: boolean,
+ *   hasCargoToml: boolean,
  *   hasDockerfile: boolean,
  *   hasJsLikeSource: boolean,
  *   hasNginxDefaultTplFile: boolean,
@@ -304,6 +306,9 @@ function updateFileFacts(fileName, relPath, facts) {
   if (fileName === 'capacitor.config.json') {
     facts.hasCapacitorConfig = true
   }
+  if (fileName === 'Cargo.toml') {
+    facts.hasCargoToml = true
+  }
   if (fileName === 'Dockerfile' || fileName.startsWith('Dockerfile.')) {
     facts.hasDockerfile = true
   }
@@ -407,6 +412,7 @@ async function updateHasuraFactFromFile(absPath, fileName, facts) {
  * @param {{
  *   hasBunSqlImport: boolean,
  *   hasCapacitorConfig: boolean,
+ *   hasCargoToml: boolean,
  *   hasDockerfile: boolean,
  *   hasGqlTaggedTemplates: boolean,
  *   hasHasuraConfig: boolean,
@@ -493,6 +499,7 @@ export function isMonorepoPackage(packageJson) {
  * @param {string} root абсолютний шлях кореня репозиторію
  * @returns {Promise<{
  *   hasCapacitorConfig: boolean,
+ *   hasCargoToml: boolean,
  *   hasDockerfile: boolean,
  *   hasGaWorkflowsDir: boolean,
  *   hasBunSqlImport: boolean,
@@ -511,6 +518,7 @@ export async function collectAutoRuleFacts(root) {
   const facts = {
     hasBunSqlImport: false,
     hasCapacitorConfig: false,
+    hasCargoToml: false,
     hasDockerfile: false,
     hasGaWorkflowsDir: existsSync(join(root, '.github', 'workflows')),
     hasGqlTaggedTemplates: false,
@@ -656,6 +664,7 @@ export async function detectAutoRules({
     { enabled: npmDirExists, id: 'npm-module' },
     { enabled: composerJsonExists, id: 'php' },
     { enabled: facts.hasRegoFile, id: 'rego' },
+    { enabled: facts.hasCargoToml, id: 'rust' },
     { enabled: facts.hasVueOrCssSource, id: 'style-lint' }
   ]
   for (const item of autoRuleChecks) {