@nitra/cursor 1.28.1 → 1.28.3

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.28.3] - 2026-05-28
+
+### Changed
+
+- **`rules/efes/`** — слідом за перейменуванням `@nitra/efes-docs` → `@nitra/efes-shared` (репо `efes-cloud/docs` → `efes-cloud/shared`): rego-полісі `npm/rules/efes/policy/package_json_docs/` перейменовано на `package_json_shared/`, namespace `efes.package_json_docs` → `efes.package_json_shared`, перевірка тепер шукає `@nitra/efes-shared` у `devDependencies`. Оновлено `efes.mdc` (version `1.1` → `1.2`) та шлях до GraphQL-схеми у `graphql.mdc` (`node_modules/@nitra/efes-shared/schema/maya.graphql`). Споживачі efes-проєктів мають перейти на `@nitra/efes-shared`.
+
+## [1.28.2] - 2026-05-28
+
+### Changed
+
+- **`rules/rust/coverage/coverage.mjs`** — `cargo mutants` запускається з `--jobs N` (дефолт `min(4, cpus/2)`, override через env `CARGO_MUTANTS_JOBS`). Прапорець `--in-place` прибраний — cargo-mutants створює власну sandbox-копію в `target/mutants.<i>/`, що **обов'язкове** для `--jobs > 1`. Ефект: ~7× прискорення Rust mutation testing на 8-ядерних машинах (виміряно на Tauri-проєкті: 8 год → ~65 хв). Edge-case `--in-place` лишається доступним користувачам напряму через `cargo mutants --in-place` (наш runner його більше не передає). Експортовано `resolveJobs(envValue)` і `buildCargoMutantsArgs({ manifestPath, outDir, jobs })` як чисті функції для unit-тестів.
+- **`rules/tauri/js/cargo_mutants_config.mjs#TAURI_KEY_SNIPPETS.exclude_globs`** — додано `src/lib.rs` як Tauri runtime entrypoint (`pub fn run`). Один мутант там тримає весь app shell, тому ділить sandbox-фейл з `src/main.rs`. Дзеркальна правка в `tauri.mdc` (canon-TOML і пояснення семантики).
+- **`rules/rust/rust.mdc`** (`version` 1.1 → 1.2), **`rules/tauri/tauri.mdc`** (`version` 1.3 → 1.4) — актуалізовано опис паралельного запуску cargo-mutants і Tauri exclude_globs.
+
 ## [1.28.0] - 2026-05-27
 
 ### BREAKING

package/package.json

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

package/rules/efes/efes.mdc

@@ -1,17 +1,17 @@
 ---
 description: Правила для проєктів Efes (репозиторії під github.com/efes-cloud)
 alwaysApply: true
-version: '1.1'
+version: '1.2'
 ---
 
 Правило **efes** для споживачів **@nitra/cursor** у репозиторіях під **`github.com/efes-cloud/*`**.
 
-## `@nitra/efes-docs` у `devDependencies`
+## `@nitra/efes-shared` у `devDependencies`
 
-У кореневому **`package.json`** efes-проєкту в **`devDependencies`** має бути **`@nitra/efes-docs`** — пакет з канонічними контрактами/схемами efes-сервісів (зокрема використовується у `graphql.mdc` як `node_modules/@nitra/efes-docs/schema/maya.graphql`). Версію правило не фіксує — лише presence. Додати:
+У кореневому **`package.json`** efes-проєкту в **`devDependencies`** має бути **`@nitra/efes-shared`** — пакет зі спільними efes-ресурсами (схеми, скіли, типи; зокрема використовується у `graphql.mdc` як `node_modules/@nitra/efes-shared/schema/maya.graphql`). Версію правило не фіксує — лише presence. Додати:
 
 ```bash
-bun add -d @nitra/efes-docs
+bun add -d @nitra/efes-shared
 ```
 
 ## Швидкий gate через conftest (Rego)
@@ -20,4 +20,4 @@ bun add -d @nitra/efes-docs
 
 Пакети (директорія в **`npm/rules/efes/policy/`** → namespace → що перевіряє):
 
-- **`package_json_docs/`** → `efes.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/efes-docs` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
+- **`package_json_shared/`** → `efes.package_json_shared` — у кореневому `package.json` `devDependencies` має містити `@nitra/efes-shared` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.

package/rules/efes/policy/package_json_shared/package_json_shared.rego

@@ -0,0 +1,16 @@
+# Перевірка кореневого `package.json` efes-проєкту: у `devDependencies` має бути
+# `@nitra/efes-shared` (спільні efes-ресурси — схеми, скіли, типи; використовується,
+# зокрема, у `graphql.mdc` як `node_modules/@nitra/efes-shared/schema/maya.graphql`).
+# Версію не фіксуємо — лише presence.
+#
+# Inverse-presence перевірка лишається inline у rego (як `@nitra/cspell-dict`
+# у `text.package_json`).
+package efes.package_json_shared
+
+import rego.v1
+
+deny contains msg if {
+	dev := object.get(input, "devDependencies", {})
+	not "@nitra/efes-shared" in object.keys(dev)
+	msg := "package.json: devDependencies має містити @nitra/efes-shared — bun add -d @nitra/efes-shared (efes.mdc)"
+}

package/rules/efes/policy/{package_json_docs → package_json_shared}/target.json

@@ -1,5 +1,5 @@
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
   "files": { "single": "package.json", "required": true },
-  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/efes-docs'] (efes.mdc)"
+  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/efes-shared'] (efes.mdc)"
 }

package/rules/graphql/graphql.mdc

@@ -15,7 +15,7 @@ alwaysApply: false
 Підстав свої шляхи до схеми та до файлів з операціями; приклад орієнтиру:
 
 ```yaml title=".graphqlrc.yml"
-schema: node_modules/@nitra/efes-docs/schema/maya.graphql
+schema: node_modules/@nitra/efes-shared/schema/maya.graphql
 documents:
   - '**/*.{vue,js,ts,tsx}'
 ```

package/rules/rust/coverage/coverage.mjs

@@ -9,7 +9,7 @@
 import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { mkdtemp, readFile, rm } from 'node:fs/promises'
-import { tmpdir } from 'node:os'
+import { cpus, tmpdir } from 'node:os'
 import { join } from 'node:path'
 
 import { hasCargoTomlInTree } from '../lib/has-cargo-toml.mjs'
@@ -27,6 +27,32 @@ export function detect(cwd) {
   return Promise.resolve(hasCargoTomlInTree(cwd, IGNORED_DIR_NAMES))
 }
 
+/**
+ * Обчислює кількість паралельних воркерів cargo-mutants. Env override через
+ * CARGO_MUTANTS_JOBS (валідне ціле >= 1). Fallback — min(4, max(1, cpus/2)):
+ * на ≤2 ядрах = 1, на 4 = 2, на 8+ = 4. Стеля 4 — Rust linker bottleneck:
+ * вище практичного приросту не дає навіть на 16+ ядрах.
+ * @param {string | undefined} envValue значення `process.env.CARGO_MUTANTS_JOBS`
+ * @returns {number}
+ */
+export function resolveJobs(envValue) {
+  if (envValue !== undefined && envValue !== '') {
+    const n = Number.parseInt(envValue, 10)
+    if (Number.isFinite(n) && n >= 1) return n
+  }
+  return Math.min(4, Math.max(1, Math.floor(cpus().length / 2)))
+}
+
+/**
+ * Будує argv для `cargo mutants`. `--in-place` навмисно відсутній: cargo-mutants
+ * створює власну sandbox-копію в `target/mutants.<i>/`, що обов'язкове для `--jobs > 1`.
+ * @param {{ manifestPath: string, outDir: string, jobs: number }} opts
+ * @returns {string[]}
+ */
+export function buildCargoMutantsArgs({ manifestPath, outDir, jobs }) {
+  return ['mutants', '--jobs', String(jobs), '-o', outDir, '--manifest-path', manifestPath]
+}
+
 const defaultRunner = {
   runLlvmCov({ manifestPath }) {
     const r = spawnSync('cargo', ['llvm-cov', '--manifest-path', manifestPath, '--json', '--summary-only'], {
@@ -36,7 +62,8 @@ const defaultRunner = {
     return { exitCode: r.status ?? 1, stdout: r.stdout?.toString('utf8') ?? '' }
   },
   runCargoMutants({ manifestPath, outDir }) {
-    const r = spawnSync('cargo', ['mutants', '--in-place', '-o', outDir, '--manifest-path', manifestPath], {
+    const jobs = resolveJobs(process.env.CARGO_MUTANTS_JOBS)
+    const r = spawnSync('cargo', buildCargoMutantsArgs({ manifestPath, outDir, jobs }), {
       stdio: 'inherit',
       env: process.env
     })

package/rules/rust/rust.mdc

@@ -2,7 +2,7 @@
 description: Перевірка Rust коду
 globs: "**/{Cargo.toml,Cargo.lock,rustfmt.toml,clippy.toml,.vscode/extensions.json,package.json},**/*.rs"
 alwaysApply: false
-version: '1.1'
+version: '1.2'
 ---
 
 **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`).
@@ -28,4 +28,4 @@ Tauri-проєкт завжди має `src-tauri/Cargo.toml`, тому прав
 
 ## Покриття + мутаційне тестування Rust
 
-Покриття + мутаційне тестування Rust постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/rust/coverage/coverage.mjs`: `cargo llvm-cov --json --summary-only` + `cargo mutants --in-place`. Бінарники: `cargo install cargo-llvm-cov && cargo install cargo-mutants`.
+Покриття + мутаційне тестування Rust постачаються через `n-cursor coverage` (правило `test.mdc`). Реалізація провайдера — у `npm/rules/rust/coverage/coverage.mjs`: `cargo llvm-cov --json --summary-only` + `cargo mutants --jobs N` (паралельні воркери, дефолт `min(4, cpus/2)`; override через env `CARGO_MUTANTS_JOBS`). Прапорець `--in-place` прибраний — cargo-mutants створює власну sandbox-копію в `target/mutants.<i>/`, що сумісне з `--jobs > 1`. Бінарники: `cargo install cargo-llvm-cov && cargo install cargo-mutants`.

package/rules/tauri/js/cargo_mutants_config.mjs

@@ -37,8 +37,11 @@ const TAURI_KEY_SNIPPETS = Object.freeze({
   exclude_globs: `# Platform bridge / app shell — boundary-файли (тестуються smoke/e2e, не mutation unit).
 # Якщо у bridge-файлі з'являється pure/business logic — винеси її у platform-neutral
 # модуль (src/auth/oauth.rs, src/gmail/message.rs, ...) і тестуй mutation-testing там.
+# src/lib.rs (Tauri pub fn run) — runtime entrypoint, що запускає весь app shell:
+# один мутант там тримає весь Tauri runtime, тому ділить sandbox-фейл з src/main.rs.
 exclude_globs = [
   "src/main.rs",
+  "src/lib.rs",
   "src/**/android.rs",
   "src/**/ios.rs",
   "src/**/mobile.rs",

package/rules/tauri/tauri.mdc

@@ -2,7 +2,7 @@
 description: Tauri
 globs: "**/src-tauri/**,**/tauri.conf.json"
 alwaysApply: false
-version: '1.3'
+version: '1.4'
 ---
 
 У `.vscode/extensions.json` `recommendations` має містити `tauri-apps.tauri-vscode`:
@@ -36,6 +36,7 @@ additional_cargo_test_args = ["--lib", "--tests"]
 
 exclude_globs = [
   "src/main.rs",
+  "src/lib.rs",
   "src/**/android.rs",
   "src/**/ios.rs",
   "src/**/mobile.rs",
@@ -49,6 +50,7 @@ exclude_globs = [
 Семантика (фіксована між Tauri-проєктами):
 
 - **`src/main.rs`** — binary shell entrypoint: запускає Tauri runtime, реєструє plugins/handlers і повертає управління циклу подій. Тестується smoke/e2e (запуск бінарника), не mutation unit;
+- **`src/lib.rs`** — Tauri runtime entrypoint (`pub fn run`): піднімає весь app shell. Один мутант там тримає весь Tauri runtime, тому ділить sandbox-фейл з `src/main.rs` і тестується smoke/e2e, а не mutation unit;
 - **`*android.rs`, `*ios.rs`, `*mobile.rs`** — mobile plugin bridge / platform glue: тонка обгортка над JNI/Objective-C виклики, mapping platform errors, виклики Tauri AppHandle і native API;
 - **`*macos.rs`, `*windows.rs`, `*linux.rs`, `*desktop.rs`** — desktop platform bridge / OS integration glue: opener/window APIs, OS-specific I/O, mapping platform errors.
 

package/rules/efes/policy/package_json_docs/package_json_docs.rego

@@ -1,16 +0,0 @@
-# Перевірка кореневого `package.json` efes-проєкту: у `devDependencies` має бути
-# `@nitra/efes-docs` (контракти/схеми efes-сервісів — використовується, зокрема,
-# у `graphql.mdc` як `node_modules/@nitra/efes-docs/schema/maya.graphql`). Версію
-# не фіксуємо — лише presence.
-#
-# Inverse-presence перевірка лишається inline у rego (як `@nitra/cspell-dict`
-# у `text.package_json`).
-package efes.package_json_docs
-
-import rego.v1
-
-deny contains msg if {
-	dev := object.get(input, "devDependencies", {})
-	not "@nitra/efes-docs" in object.keys(dev)
-	msg := "package.json: devDependencies має містити @nitra/efes-docs — bun add -d @nitra/efes-docs (efes.mdc)"
-}