@nitra/cursor 3.10.0 → 3.12.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [3.12.0] - 2026-06-02
+
+### Added
+
+- flow: cwd-незалежний резолвинг активного стану — spec/plan/verify/review/gate/release знаходять .flow.json поточної гілки навіть із головного дерева (швидкий шлях без git, toplevel-резолв, авторезолв єдиного активного flow), + опційний --branch <гілка>. Гейти виконуються у теці worktree.
+- flow release: інференс зміненого воркспейсу з diff від base_commit — авто-додає --ws у change, якщо не задано явно (один змінений subworkspace → його .changes/; кілька → fail з підказкою явного --ws; лише корінь → дефолт). Усуває потрапляння change-файлу в корінь монорепо при змінах під підпакетом.
+
+### Fixed
+
+- Усунуто суперечність n-changelog.mdc ↔ n-npm-module.mdc: прибрано перевірки version/CHANGELOG у package_structure.mjs, що штовхали до ручного bump (єдиний артефакт змін — change-файл; узгодженість валідує changelog/consistency.mjs); npm-module.mdc делегує bump/CHANGELOG у changelog.mdc, який отримав post-release-інваріант.
+- trace: резолв лінків front-matter відносно теки артефакту (+ root-relative fallback) — file-relative spec/plan лінки (`../specs/…`) більше не дають хибний «розрив ланцюга»; поле `flow` (runtime `.flow.json`) показується, але не рахується розривом. Розрив визначають лише chain-поля (adr/spec/plan/change/task).
+
+## [3.11.0] - 2026-06-02
+
+### Changed
+
+- coverage: scoped режим --changed — flow-турнікет (DEFAULT_GATES) перевіряє лише змінені від base_commit файли (vitest --changed + Stryker --mutate), однаково для закомічених і незакомічених змін; повний coverage лишається для bun run coverage / n-coverage-fix
+
 ## [3.10.0] - 2026-06-01
 
 ### Added

package/bin/n-cursor.js

@@ -1527,9 +1527,10 @@ try {
     }
     case 'coverage': {
       // n-cursor coverage — оркестратор покриття + мутаційного тестування з discovery
-      // провайдерів через .n-cursor.json#rules (test.mdc).
+      // провайдерів через .n-cursor.json#rules (test.mdc). --changed звужує scope до
+      // змінених від base файлів (flow-турнікет: лише vitest/Stryker по diff).
       const { runCoverageCli } = await import('../rules/test/coverage/coverage.mjs')
-      process.exitCode = await runCoverageCli({ fix: args.includes('--fix') })
+      process.exitCode = await runCoverageCli({ fix: args.includes('--fix'), changed: args.includes('--changed') })
 
       break
     }

package/package.json

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

package/rules/changelog/changelog.mdc

@@ -1,6 +1,6 @@
 ---
 description: CHANGELOG.md в кожному workspace, з двома моделями бази порівняння (npm і Python)
-version: '3.1'
+version: '3.2'
 alwaysApply: true
 ---
 
@@ -97,3 +97,9 @@ alwaysApply: true
 ```
 
 Секції — підмножина `### Added`, `### Changed`, `### Fixed`, `### Removed` (одна або кілька).
+
+## Post-release інваріант (гарантує CI)
+
+Перша (верхня) секція `## [version]` у `CHANGELOG.md` дорівнює полю `version` у маніфесті — але це **post-release** твердження, яке забезпечує `n-cursor release` у CI, агрегуючи change-файли (bump `version` + генерація секції + git-тег `<name>@<version>`). **Локально цю рівність руками не підтримують**: у feature-флоу `version`/`CHANGELOG.md` не чіпають, тож верхня секція може відставати від майбутньої версії — це нормально. Drift `version` поза CI (vs реєстр / vs git-база) ловить `check changelog` як заборонений ручний bump.
+
+Інструкції щодо bump `version` і редагування `CHANGELOG.md` живуть **лише** в цьому правилі — джерелі істини. Інші правила (зокрема `n-npm-module.mdc`) їй підпорядковані й власних інструкцій bump/CHANGELOG не дублюють.

package/rules/flow/flow.mdc

@@ -78,9 +78,12 @@ Composer, Claude Code) працює **Пасивний Турнікет**: ти,
    npx @nitra/cursor flow verify
    ```
 
-   Проганяє Quality Gate (lint). Повертає `0` (pass) або `1` із виводом
-   проваленого gate. Coverage (тести + Stryker-мутації) **поза** turnstile —
-   запускай окремо `npx @nitra/cursor coverage` або в CI.
+   Проганяє Quality Gates (lint + coverage). Повертає `0` (pass) або `1` із
+   виводом проваленого gate. **Обидва гейти перевіряють лише змінені файли**
+   (diff від `base_commit`): `lint` — quick-режим, `coverage --changed` — vitest
+   `--changed` + Stryker `--mutate` по diff. Працює однаково, незалежно від того,
+   чи зміни вже закомічені у worktree. Повний coverage (увесь проєкт) — окремо:
+   `bun run coverage` або `/n-coverage-fix`.
 
 6. **Review (adversarial)** — рекомендовано перед release:
 

package/rules/js-lint/coverage/coverage.mjs

@@ -10,13 +10,36 @@ import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync } from 'node:fs'
 import { mkdtemp, readFile, rm } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
-import { join, relative } from 'node:path'
+import { isAbsolute, join, relative } from 'node:path'
 
 import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
 import { addCoverage, addMutation } from '../../test/coverage/coverage.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
+/** JS/TS-розширення — файли, які мутує Stryker і покриває vitest. */
+const JS_FILE = /\.(c|m)?[jt]sx?$/
+/** Тест-файли (`*.test.*` / `*.spec.*`) — НЕ production-код, не йдуть у Stryker `--mutate`. */
+const TEST_FILE = /\.(test|spec)\.[^.]+$/
+
+/**
+ * Звужує список змінених файлів (relative до cwd) до тих, що лежать під `jsRoot`,
+ * мають JS/TS-розширення, і рібейзить їх відносно `jsRoot`.
+ * @param {string[]} changedFiles relative-до-cwd шляхи змінених файлів
+ * @param {string} cwd корінь проєкту
+ * @param {string} jsRoot абсолютний шлях workspace-кореня
+ * @returns {string[]} JS-файли під jsRoot, шляхи relative до jsRoot
+ */
+export function scopeToRoot(changedFiles, cwd, jsRoot) {
+  const out = []
+  for (const f of changedFiles) {
+    if (!JS_FILE.test(f)) continue
+    const rel = relative(jsRoot, join(cwd, f))
+    if (rel.startsWith('..') || isAbsolute(rel)) continue
+    out.push(rel)
+  }
+  return out
+}
 const VITEST_HINT =
   'js-lint coverage: vitest відсутній у package.json — додай `vitest`, `@vitest/coverage-v8` та `@stryker-mutator/vitest-runner` у devDependencies (див. test.mdc)'
 
@@ -217,7 +240,11 @@ export function parseStrykerReport(report, jsRoot) {
  * у такому випадку сигналізує "no tests" → collectOneRoot пропускає workspace.
  */
 const defaultRunner = {
-  runJsCoverage({ cwd, lcovDir }) {
+  runJsCoverage({ cwd, lcovDir, base }) {
+    // base !== undefined ⇔ --changed-режим: vitest сам рахує зачеплені змінами тести
+    // через граф імпортів. `--changed <base>` порівнює base↔робоче дерево (committed і
+    // uncommitted разом); `--changed` без аргументу — uncommitted vs HEAD.
+    const changedArgs = base === undefined ? [] : base === null ? ['--changed'] : ['--changed', base]
     const r = spawnSync(
       'bunx',
       [
@@ -226,13 +253,14 @@ const defaultRunner = {
         '--passWithNoTests',
         '--coverage',
         '--coverage.reporter=lcov',
-        `--coverage.reportsDirectory=${lcovDir}`
+        `--coverage.reportsDirectory=${lcovDir}`,
+        ...changedArgs
       ],
       { cwd, stdio: 'inherit', env: process.env }
     )
     return r.status ?? 1
   },
-  runStryker({ cwd }) {
+  runStryker({ cwd, mutate }) {
     // `npx`, не `bunx`: bunx завжди ставить пакет у `T/bunx-<uid>-<pkg>@latest` і запускає
     // Stryker звідти. Плагін-discovery у Stryker (`@stryker-mutator/*`) globится відносно
     // CORE-install-каталогу (`core/dist/src/di/plugin-loader.js` → `../../../../../@stryker-mutator/*`),
@@ -240,30 +268,48 @@ const defaultRunner = {
     // встановлений `@stryker-mutator/vitest-runner` залишається невидимим, і workers падають з
     // `Cannot find TestRunner plugin "vitest"`. `npx` ходить угору по `node_modules/.bin/` і
     // запускає Stryker з локального hoisted-install, де поряд лежить vitest-runner.
-    const r = spawnSync('npx', ['@stryker-mutator/core', 'run'], { cwd, stdio: 'inherit', env: process.env })
+    // mutate (непорожній) ⇔ --changed-режим: мутуємо лише змінені production-файли цього root.
+    const mutateArgs = mutate && mutate.length > 0 ? ['--mutate', mutate.join(',')] : []
+    const r = spawnSync('npx', ['@stryker-mutator/core', 'run', ...mutateArgs], {
+      cwd,
+      stdio: 'inherit',
+      env: process.env
+    })
     return r.status ?? 1
   }
 }
 
 /**
  * Збирає метрики покриття + мутаційного тестування для **одного** JS-root.
- * Пропускає workspace без тестів (повертає `null`): vitest у такому випадку
- * пройшов з `--passWithNoTests`, але lcov порожній — нема сенсу запускати
- * Stryker. Реальні помилки (vitest exit ≠ 0, mutation.json відсутній попри
- * наявні тести) кидаються — у multi-root режимі це не маскує справжній збій.
+ *
+ * Full-режим (`scope === null`): vitest на всьому suite + Stryker на всіх файлах
+ * config-глоба. Пропускає workspace без тестів (повертає `null`): vitest пройшов з
+ * `--passWithNoTests`, але lcov порожній — нема сенсу запускати Stryker.
+ *
+ * Changed-режим (`scope = { files, base }`): vitest `--changed <base>` (лише
+ * зачеплені тести) + Stryker `--mutate` лише по змінених production-файлах. Тут
+ * **не** пропускаємо на порожньому lcov — змінений src без тестів має дати
+ * NoCoverage-мутанти (gate впаде, як і має). Якщо змінено лише тест-файли (нема
+ * production-src) — Stryker не запускаємо (мутувати нічого), повертаємо лише coverage.
+ *
+ * Реальні помилки (vitest exit ≠ 0, відсутній mutation.json попри запуск Stryker)
+ * кидаються — у multi-root режимі це не маскує справжній збій.
  * @param {string} jsRoot абсолютний шлях до workspace-кореня
  * @param {string} cwd корінь проєкту (для рібейзингу `survived[].file`)
  * @param {{runJsCoverage:Function, runStryker:Function}} runner spawn-ін'єкція
- * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результати або null коли workspace без тестів
+ * @param {{files:string[], base:string|null}|null} [scope] changed-scope (null = full-режим)
+ * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результати або null коли full-режим і workspace без тестів
  */
-async function collectOneRoot(jsRoot, cwd, runner) {
+async function collectOneRoot(jsRoot, cwd, runner, scope = null) {
   const wsRel = relative(cwd, jsRoot)
+  // У changed-режимі production-файли для мутації = змінені JS цього root без тест-файлів.
+  const mutateSrc = scope ? scope.files.filter(f => !TEST_FILE.test(f)) : null
 
-  // 1. Coverage через vitest run --passWithNoTests --coverage
+  // 1. Coverage через vitest run --passWithNoTests --coverage (+ --changed у changed-режимі)
   const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
   let coverage
   try {
-    const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
+    const code = await runner.runJsCoverage(scope ? { cwd: jsRoot, lcovDir, base: scope.base } : { cwd: jsRoot, lcovDir })
     if (code !== 0) throw new Error(`JS coverage exit ${code}`)
     const lcovPath = join(lcovDir, 'lcov.info')
     coverage = existsSync(lcovPath)
@@ -273,13 +319,20 @@ async function collectOneRoot(jsRoot, cwd, runner) {
     await rm(lcovDir, { recursive: true, force: true })
   }
 
-  // Порожній lcov ⇔ vitest з --passWithNoTests не знайшов тестів. Пропускаємо
-  // workspace, щоб не запускати Stryker марно і не псувати агрегат.
-  const hasTests = coverage.lines.total > 0 || coverage.functions.total > 0
-  if (!hasTests) return null
+  // Full-режим: порожній lcov ⇔ vitest не знайшов тестів → пропускаємо workspace,
+  // щоб не ганяти Stryker марно. У changed-режимі НЕ пропускаємо (див. JSDoc).
+  if (!scope) {
+    const hasTests = coverage.lines.total > 0 || coverage.functions.total > 0
+    if (!hasTests) return null
+  }
 
-  // 2. Mutation через Stryker
-  await runner.runStryker({ cwd: jsRoot })
+  // Changed-режим без production-src (змінено лише тест-файли) → мутувати нічого.
+  if (scope && mutateSrc.length === 0) {
+    return { coverage, mutation: { caught: 0, total: 0 }, survived: [] }
+  }
+
+  // 2. Mutation через Stryker (у changed-режимі — лише по mutateSrc)
+  await runner.runStryker(scope ? { cwd: jsRoot, mutate: mutateSrc } : { cwd: jsRoot })
   const mutationPath = join(jsRoot, 'reports', 'stryker', 'mutation.json')
   if (!existsSync(mutationPath)) {
     throw new Error(
@@ -317,22 +370,36 @@ async function collectOneRoot(jsRoot, cwd, runner) {
  * з зрозумілим повідомленням ("Жодного провайдера покриття не знайдено").
  * Шляхи у `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs`
  * знаходив джерела через `join(projectRoot, file)`.
+ *
+ * Changed-режим (`opts.changedFiles` задано): кожен root отримує лише свої змінені
+ * JS-файли (`scopeToRoot`); roots без змінених JS пропускаються повністю (ні vitest,
+ * ні Stryker). Якщо змін нема ніде — повертає `[]` без error-логу (оркестратор
+ * трактує порожній changed-scope як pass).
  * @param {string} cwd корінь проєкту
- * @param {{runner?: typeof defaultRunner}} [opts] runner-ін'єкція для тестів
- * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядок `JS` або `[]` коли тестів нема ніде
+ * @param {{runner?: typeof defaultRunner, changedFiles?: string[], base?: string|null}} [opts] runner-ін'єкція + changed-scope
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядок `JS` або `[]` коли тестів/змін нема ніде
  */
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
+  const changed = Array.isArray(opts.changedFiles)
   const jsRoots = await resolveAllJsRoots(cwd)
   if (jsRoots.length === 0) throw new Error('js-lint coverage: package.json не знайдено')
 
   const results = []
   for (const jsRoot of jsRoots) {
-    const r = await collectOneRoot(jsRoot, cwd, runner)
+    let scope = null
+    if (changed) {
+      const files = scopeToRoot(opts.changedFiles, cwd, jsRoot)
+      if (files.length === 0) continue // root без змінених JS — пропускаємо
+      scope = { files, base: opts.base ?? null }
+    }
+    const r = await collectOneRoot(jsRoot, cwd, runner, scope)
     if (r !== null) results.push(r)
   }
 
   if (results.length === 0) {
+    // Changed-режим: нема змінених JS у жодному root → тихо порожньо (це pass, не помилка).
+    if (changed) return []
     console.error(
       'js-lint coverage: жоден workspace не має тестів ' +
         '(`*.test.{js,mjs}` у `tests/` або поряд із джерелом) — ' +

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

@@ -20,16 +20,15 @@
  *    test-фреймворків (`bun:test`, `node:test`, `vitest`, `@jest/globals`, `mocha`, `jest`, `ava`, …).
  *    Виняток: `*_test.rego` дозволені поруч з полісі — це конвенція conftest.
  *
- * Версія та CHANGELOG: перший заголовок `## [version]` у `npm/CHANGELOG.md` має збігатися з `version` у
- * `npm/package.json` (найсвіжіший реліз зверху). Якщо в git є незакомічені зміни під `npm/`, `version` у робочому
- * файлі має відрізнятися від `HEAD` — інакше типовий пропуск bump після правок у пакеті.
+ * Версія та CHANGELOG тут НЕ перевіряються: єдиний артефакт зміни — change-файл, а узгодженість
+ * `version`/`CHANGELOG.md` (включно з drift від ручного bump) валідує `changelog/js/consistency.mjs`
+ * за моделлю `n-changelog.mdc`. Інваріант «верхня секція CHANGELOG == package.json.version» істинний
+ * лише post-release і його гарантує `n-cursor release` у CI — локально його не підтримують руками.
  * @param {string} cwd корінь репозиторію
  */
-import { execFile } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { readFile, stat } from 'node:fs/promises'
 import { join, sep } from 'node:path'
-import { promisify } from 'node:util'
 
 import { parseSync } from 'oxc-parser'
 
@@ -43,14 +42,6 @@ import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
 import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 
-const execFileAsync = promisify(execFile)
-
-/** Перший заголовок релізу у Keep a Changelog (`## [1.2.3]`). */
-const CHANGELOG_FIRST_VERSION_RE = /^## \[([^\]]+)\]/m
-
-/** Поле `version` у текстовому зрізі `package.json` (для `git show HEAD:npm/package.json`). */
-const PACKAGE_JSON_VERSION_RE = /"version":\s*"([^"]+)"/u
-
 /** Файл проєкту TypeScript для emit без каталогу `src` (див. npm-module.mdc) */
 const EMIT_TYPES_CONFIG = 'npm/tsconfig.emit-types.json'
 
@@ -91,9 +82,9 @@ const GLOBSTAR_TRAILING_RE = /\/__GLOBSTAR__$/u
 
 /**
  * Чи є під `npm/src` хоча б один `.js` (рекурсивно).
+ * @param {string} cwd корінь репозиторію
  * @param {string[]} [ignorePaths] абсолютні шляхи каталогів, повністю виключених з обходу
  * @returns {Promise<boolean>} `true`, якщо знайдено хоча б один `.js`
- * @param {string} cwd корінь репозиторію
  */
 async function npmSrcTreeHasJsFile(cwd, ignorePaths = []) {
   const root = join(cwd, 'npm/src')
@@ -215,136 +206,6 @@ function checkEmitTypesConfig(passFn, failFn, cwd) {
   passFn(`${EMIT_TYPES_CONFIG} є (структуру перевіряє npx @nitra/cursor fix → npm_module.emit_types_config)`)
 }
 
-/**
- * Перевіряє npm-publish.yml workflow.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- * @param {string} cwd корінь репозиторію
- */
-/**
- * Чи виконано `git` у корені робочого дерева.
- * @returns {Promise<boolean>} true, якщо процес запущено в межах git work tree
- * @param {string} cwd корінь репозиторію
- */
-async function gitInsideWorkTree(cwd) {
-  try {
-    const { stdout } = await execFileAsync('git', ['rev-parse', '--is-inside-work-tree'], { encoding: 'utf8', cwd })
-    return stdout.trim() === 'true'
-  } catch {
-    return false
-  }
-}
-
-/**
- * Список незакомічених шляхів під `npm/` відносно `HEAD`.
- * @param {string} cwd корінь репозиторію
- * @returns {Promise<string[] | null>} шляхи або `null`, якщо `git` недоступний
- */
-async function gitDiffNameOnlyNpm(cwd) {
-  try {
-    const { stdout } = await execFileAsync('git', ['diff', '--name-only', 'HEAD', '--', 'npm'], {
-      encoding: 'utf8',
-      cwd
-    })
-    return stdout.trim().split('\n').filter(Boolean)
-  } catch {
-    return null
-  }
-}
-
-/**
- * Поле `version` з `npm/package.json` на заданому git-ref (`HEAD:npm/package.json`).
- * @param {string} refPath на кшталт `HEAD:npm/package.json`
- * @param {string} cwd корінь репозиторію
- * @returns {Promise<string | null>} значення поля `version` або `null`, якщо ref недоступний
- */
-async function gitShowNpmPackageVersionAt(refPath, cwd) {
-  try {
-    const { stdout } = await execFileAsync('git', ['show', refPath], { encoding: 'utf8', cwd })
-    const m = stdout.match(PACKAGE_JSON_VERSION_RE)
-    return m ? m[1] : null
-  } catch {
-    return null
-  }
-}
-
-/**
- * Версія з першого заголовка `## […]` у тексті CHANGELOG.
- * @param {string} changelogText вміст файлу CHANGELOG.md
- * @returns {string | null} версія з першої секції або `null`, якщо заголовка немає
- */
-function firstChangelogSectionVersion(changelogText) {
-  const m = changelogText.match(CHANGELOG_FIRST_VERSION_RE)
-  return m ? m[1] : null
-}
-
-/**
- * Перший реліз у CHANGELOG має збігатися з `version` у `npm/package.json`.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при виявленому порушенні
- * @returns {Promise<void>}
- * @param {string} cwd корінь репозиторію
- */
-async function checkChangelogTopMatchesPackageVersion(passFn, failFn, cwd) {
-  if (!existsSync(join(cwd, 'npm/CHANGELOG.md')) || !existsSync(join(cwd, 'npm/package.json'))) return
-  const pkg = JSON.parse(await readFile(join(cwd, 'npm/package.json'), 'utf8'))
-  const ver = typeof pkg.version === 'string' ? pkg.version : null
-  if (!ver) {
-    failFn('npm/package.json: відсутнє поле version')
-    return
-  }
-  const cl = await readFile(join(cwd, 'npm/CHANGELOG.md'), 'utf8')
-  const first = firstChangelogSectionVersion(cl)
-  if (!first) {
-    failFn('npm/CHANGELOG.md: не знайдено жодного заголовка ## [version]')
-    return
-  }
-  if (first !== ver) {
-    failFn(
-      `npm/CHANGELOG.md: перша секція [${first}] не збігається з npm/package.json version "${ver}" ` +
-        '(зверху має бути найсвіжіший реліз і той самий номер — npm-module.mdc).'
-    )
-    return
-  }
-  passFn(`npm/CHANGELOG.md: перша секція [${first}] збігається з npm/package.json`)
-}
-
-/**
- * Незакомічені зміни під `npm/` вимагають підвищення `version` відносно `HEAD`.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при виявленому порушенні
- * @returns {Promise<void>}
- * @param {string} cwd корінь репозиторію
- */
-async function checkDirtyNpmRequiresVersionBump(passFn, failFn, cwd) {
-  if (!(await gitInsideWorkTree(cwd))) {
-    passFn('npm-module: git недоступний або поза work tree — перевірку незакоміченого bump пропущено')
-    return
-  }
-  const changed = await gitDiffNameOnlyNpm(cwd)
-  if (changed === null) {
-    passFn('npm-module: git diff під npm/ недоступний — пропущено')
-    return
-  }
-  if (changed.length === 0) return
-
-  const headVer = await gitShowNpmPackageVersionAt('HEAD:npm/package.json', cwd)
-  if (headVer === null) return
-
-  const pkg = JSON.parse(await readFile(join(cwd, 'npm/package.json'), 'utf8'))
-  const cur = typeof pkg.version === 'string' ? pkg.version : null
-  if (!cur) return
-
-  if (cur === headVer) {
-    failFn(
-      `Незакомічені зміни під npm/ (${changed.join(', ')}), але "version" у npm/package.json лишився ${cur} ` +
-        '(як у HEAD). Підвищ version (+1) і додай секцію ## [нова версія] зверху CHANGELOG (npm-module.mdc).'
-    )
-    return
-  }
-  passFn(`npm/: незакомічені зміни під npm/ узгоджені з підвищенням version (${headVer} → ${cur})`)
-}
-
 /**
  * FS-existence для `npm-publish.yml` workflow. Поля workflow (`on.push.paths`,
  * `branches`, `id-token: write`, JS-DevTools/npm-publish step) валідує
@@ -614,8 +475,5 @@ export async function check(cwd = process.cwd()) {
 
   await checkPublishWorkflow(pass, fail, cwd)
 
-  await checkChangelogTopMatchesPackageVersion(pass, fail, cwd)
-  await checkDirtyNpmRequiresVersionBump(pass, fail, cwd)
-
   return reporter.getExitCode()
 }

package/rules/npm-module/npm-module.mdc

@@ -2,7 +2,7 @@
 description: Оформлення репозиторію для npm модуля
 globs: "npm/**,**/package.json,**/hk.pkl,.github/workflows/npm-publish.yml,**/tsconfig*.json"
 alwaysApply: false
-version: '1.13'
+version: '1.14'
 ---
 
 Bun monorepo: workspace **`npm/`**, кореневий **`package.json`**, **`.github/workflows/`**; опційно **`demo/`**.
@@ -55,21 +55,11 @@ bunx -p typescript tsc src/**/*.js --declaration --allowJs --emitDeclarationOnly
 
 Після додавання **`hk.pkl`**: **`hk install`**.
 
-## Build версія
+## Версія та CHANGELOG
 
-Після змін у **`npm/`** обовʼязково підвищ **build**-версію в **`npm/package.json`**, але не роби зайвих підвищень: між номером у файлі й тим, що вже збережено в **git** (`HEAD`), має лишатися не більше одного кроку **+1**.
+Версію (`version` у **`npm/package.json`**) і **`npm/CHANGELOG.md`** **не редагуй вручну** — навіть для hotfix. Єдиний артефакт зміни — **change-файл** (`npx @nitra/cursor change --bump <major|minor|patch> --section <Added|Changed|Fixed|Removed> --message "<…>"`); bump `version` і генерацію секції CHANGELOG робить `n-cursor release` у CI на `main`. Будь-який ручний bump `version` поза CI завалює `check changelog` — навіть із change-файлом.
 
-У робочій копії не повинно бути більше одного незбереженого в **git** підвищення **build**-версії за раз.
-
-**Чеклист у тому ж наборі змін, що й правки під `npm/`:** `version` у **`npm/package.json`** → **+1**; зверху **`npm/CHANGELOG.md`** нова секція **`## [нова версія] - …`**; у секції лише те, що входить у цей реліз.
-
-**Антипатерн:** не дописувати нові bullet-и в уже існуючу секцію **`## [X.Y.Z]`**, якщо паралельно не піднімаєш **`version`** до нового номера й не створюєш **нову** секцію зверху. Інакше змішуються різні релізи в одному номері, а `check npm-module` / `check changelog` гірше ловлять порушення.
-
-**Підказка:** щоб не дублювати bump і бачити різницю зі збереженим деревом, перевір `git status npm/package.json` або `git diff HEAD -- npm/package.json` перед другим підвищенням у тій самій гілці / наборі змін.
-
-## CHANGELOG
-
-Найновіша версія — **перша** секція **`## [version]`** у файлі (зверху після заголовка). Вона **має збігатися** з полем **`version`** у **`npm/package.json`**.
+Повна модель (база порівняння, інверсія шляхів, формат CHANGELOG, post-release-інваріант «верхня секція CHANGELOG == `version`») — у **`n-changelog.mdc`** (джерело істини). Це правило їй підпорядковане й власних інструкцій bump/CHANGELOG не дублює.
 
 ## npm publish
 

package/rules/rust/coverage/coverage.mjs

@@ -16,6 +16,8 @@ import { hasCargoTomlInTree } from '../lib/has-cargo-toml.mjs'
 import { resolveCargoManifest } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
 
 const IGNORED_DIR_NAMES = new Set(['node_modules', '.git', '.next', '.turbo', 'target'])
+/** Rust-релевантні зміни: `.rs`-джерела або маніфести Cargo. */
+const RUST_CHANGE = /(\.rs$)|((^|\/)Cargo\.(toml|lock)$)/
 
 /**
  * Чи провайдер застосовний у поточному cwd.
@@ -33,7 +35,7 @@ export function detect(cwd) {
  * на ≤2 ядрах = 1, на 4 = 2, на 8+ = 4. Стеля 4 — Rust linker bottleneck:
  * вище практичного приросту не дає навіть на 16+ ядрах.
  * @param {string | undefined} envValue значення `process.env.CARGO_MUTANTS_JOBS`
- * @returns {number}
+ * @returns {number} кількість паралельних воркерів (>= 1)
  */
 export function resolveJobs(envValue) {
   if (envValue !== undefined && envValue !== '') {
@@ -119,12 +121,21 @@ const defaultRunner = {
 
 /**
  * Збирає Rust-метрики покриття + мутаційного тестування.
+ *
+ * Changed-режим (`opts.changedFiles` задано): якщо серед змінених немає Rust-релевантних
+ * файлів (`.rs` / `Cargo.toml` / `Cargo.lock`) — повертає `[]` (skip), щоб JS-only крок
+ * турнікета не ганяв повний `cargo mutants`. Якщо Rust змінено — наразі прогін повний по
+ * crate (per-file scoping cargo-mutants — окремий крок).
  * @param {string} cwd корінь проєкту
- * @param {{runner?: typeof defaultRunner}} [opts] ін'єкція runner-а для тестів
+ * @param {{runner?: typeof defaultRunner, changedFiles?: string[]}} [opts] ін'єкція runner-а + changed-scope
  * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}}>>} рядки для COVERAGE.md
  */
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
+  // Changed-режим без Rust-релевантних змін → не запускаємо повний crate-прогін.
+  if (Array.isArray(opts.changedFiles) && !opts.changedFiles.some(f => RUST_CHANGE.test(f))) {
+    return []
+  }
   const manifestPath = await resolveCargoManifest(cwd)
   if (manifestPath === null) {
     throw new Error('rust coverage: Cargo.toml не знайдено (cwd + workspaces)')