@nitra/cursor 1.17.0 → 1.17.2

package/rules/test/js/cargo_mutants_config.mjs

@@ -0,0 +1,65 @@
+/**
+ * Концерн `cargo_mutants_config` правила test (test.mdc): якщо `rust` присутнє
+ * в `.n-cursor.json#rules` і не у `disable-rules` — резолвить ВСІ Cargo.toml
+ * (cwd і всі workspaces, з підтримкою Tauri-патерну) і копіює canonical
+ * baseline `.cargo/mutants.toml` у каталог кожного manifest'а, якщо файлу немає.
+ *
+ * Self-gating: концерн silently skips коли `rust` не enabled.
+ * Якщо `rust` enabled, але жодного Cargo.toml не знайдено — теж silently skip
+ * (manifest може з'явитися пізніше; це не помилка).
+ *
+ * Baseline — порожній файл з коментом; cargo-mutants має робочі defaults.
+ */
+import { existsSync } from 'node:fs'
+import { copyFile, mkdir } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { resolveAllCargoManifests } from '../../../scripts/utils/resolve-cargo-manifest.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const BASELINE_PATH = join(HERE, 'data', 'cargo_mutants_config', 'mutants.toml.baseline')
+
+/**
+ * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const cwd = process.cwd()
+  const config = await readNCursorConfigLite(cwd)
+
+  // Self-gate: rust має бути enabled
+  if (!config.rules.includes('rust') || config.disableRules.includes('rust')) {
+    return reporter.getExitCode()
+  }
+
+  const manifests = await resolveAllCargoManifests(cwd)
+  if (manifests.length === 0) {
+    // rust enabled, але Cargo.toml ще немає — silently skip (manifest може з'явитися пізніше)
+    return reporter.getExitCode()
+  }
+
+  if (!existsSync(BASELINE_PATH)) {
+    reporter.fail(
+      `.cargo/mutants.toml canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`
+    )
+    return reporter.getExitCode()
+  }
+
+  for (const manifestPath of manifests) {
+    const cargoDir = dirname(manifestPath)
+    const target = join(cargoDir, '.cargo', 'mutants.toml')
+
+    if (existsSync(target)) {
+      reporter.pass(`.cargo/mutants.toml існує (${relative(cwd, target)})`)
+      continue
+    }
+
+    await mkdir(dirname(target), { recursive: true })
+    await copyFile(BASELINE_PATH, target)
+    reporter.pass(`.cargo/mutants.toml створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
+  }
+  return reporter.getExitCode()
+}

package/rules/test/js/data/cargo_mutants_config/mutants.toml.baseline

@@ -0,0 +1,4 @@
+# .cargo/mutants.toml — конфігурація cargo-mutants (опційно).
+# cargo-mutants має робочі defaults; цей файл — стартова точка для customization.
+# Документація: https://mutants.rs/
+# Канон постачає правило `test` (@nitra/cursor).

package/rules/test/js/data/stryker_config/stryker.config.baseline.mjs

@@ -0,0 +1,12 @@
+/** @type {import('@stryker-mutator/core').PartialStrykerOptions} */
+export default {
+  testRunner: 'command',
+  commandRunner: { command: 'bun test' },
+  // inPlace: уникає hoisted-node_modules issues у Bun monorepo (sandbox-копія втрачає resolution).
+  // Також тести, що читають git/fs-state (integration checks), працюють тільки in-place.
+  inPlace: true,
+  tempDirName: 'reports/stryker/.tmp',
+  reporters: ['json', 'clear-text'],
+  jsonReporter: { fileName: 'reports/stryker/mutation.json' },
+  coverageAnalysis: 'off'
+}

package/rules/test/js/location.mjs

@@ -18,7 +18,7 @@ const TESTS_DIR_NAME = 'tests'
 /**
  * Чи файл є JS-тестом (`*.test.mjs`).
  * @param {string} absPath абсолютний шлях
- * @returns {boolean}
+ * @returns {boolean} true для шляхів із суфіксом `.test.mjs`
  */
 function isTestFile(absPath) {
   return basename(absPath).endsWith('.test.mjs')

package/rules/test/js/stryker_config.mjs

@@ -0,0 +1,61 @@
+/**
+ * Концерн `stryker_config` правила test (test.mdc): якщо `js-lint` присутнє в
+ * `.n-cursor.json#rules` і не у `disable-rules` — резолвить ВСІ JS-roots
+ * (всі workspaces з package.json, або cwd у single-package) і копіює canonical
+ * baseline `stryker.config.mjs` у кожен root, де файлу немає.
+ *
+ * Self-gating: концерн silently skips коли `js-lint` не enabled — це навмисно,
+ * щоб не шуміти у single-language проєктах без JS coverage tooling.
+ *
+ * Baseline — мінімум для запуску Stryker з bun test runner; mutate-патерни
+ * лишаються на Stryker defaults (`src/**\/*.{js,mjs,ts,jsx,tsx,cjs}`).
+ */
+import { existsSync } from 'node:fs'
+import { copyFile } from 'node:fs/promises'
+import { dirname, join, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { createCheckReporter } from '../../../scripts/lib/check-reporter.mjs'
+import { readNCursorConfigLite } from '../../../scripts/lib/read-n-cursor-config-lite.mjs'
+import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const BASELINE_PATH = join(HERE, 'data', 'stryker_config', 'stryker.config.baseline.mjs')
+
+/**
+ * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
+ */
+export async function check() {
+  const reporter = createCheckReporter()
+  const cwd = process.cwd()
+  const config = await readNCursorConfigLite(cwd)
+
+  // Self-gate: js-lint має бути enabled
+  if (!config.rules.includes('js-lint') || config.disableRules.includes('js-lint')) {
+    return reporter.getExitCode()
+  }
+
+  const jsRoots = await resolveAllJsRoots(cwd)
+  if (jsRoots.length === 0) {
+    reporter.fail('test: js-lint enabled, але кореневий package.json не знайдено (test.mdc)')
+    return reporter.getExitCode()
+  }
+
+  if (!existsSync(BASELINE_PATH)) {
+    reporter.fail(
+      `stryker.config.mjs canonical baseline не знайдено (${BASELINE_PATH}) — перевстанови @nitra/cursor`
+    )
+    return reporter.getExitCode()
+  }
+
+  for (const jsRoot of jsRoots) {
+    const target = join(jsRoot, 'stryker.config.mjs')
+    if (existsSync(target)) {
+      reporter.pass(`stryker.config.mjs існує (${relative(cwd, target)})`)
+      continue
+    }
+    await copyFile(BASELINE_PATH, target)
+    reporter.pass(`stryker.config.mjs створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
+  }
+  return reporter.getExitCode()
+}

package/rules/test/test.mdc

@@ -1,7 +1,8 @@
 ---
-description: JS-тести (*.test.mjs) живуть у каталозі tests/ поряд із джерельним файлом, а не безпосередньо в тій же директорії
-version: '1.2'
-alwaysApply: true
+description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
+version: '2.0'
+globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,.cargo/mutants.toml},**/*.test.mjs"
+alwaysApply: false
 ---
 
 ## Конвенція розміщення тестів
@@ -68,3 +69,15 @@ Recursive globs ловлять файли всередині `tests/` так с
 У `package.json` (корінь) має бути `scripts.coverage` із викликом `n-cursor coverage`:
 
 Канон `scripts.coverage` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
+
+## Налаштування mutation-testing
+
+Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` і `scripts/stryker.config.mjs`.
+
+Канон Stryker config (мінімум для роботи з `bun test`): [stryker.config.baseline.mjs](./js/data/stryker_config/stryker.config.baseline.mjs)
+
+Аналогічно, якщо `rust` присутнє в `rules` — створюється `.cargo/mutants.toml` у каталозі **кожного** Cargo.toml-маніфесту: кореневий `Cargo.toml`, `<workspace>/src-tauri/Cargo.toml` (Tauri-патерн) і `<workspace>/Cargo.toml` (flat workspace).
+
+Канон cargo-mutants config: [mutants.toml.baseline](./js/data/cargo_mutants_config/mutants.toml.baseline)
+
+Customization (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерни лише забезпечують наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.

package/rules/text/fix.mjs

@@ -1,3 +1,4 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
@@ -10,10 +11,9 @@ export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
 
-if (import.meta.main) {
+if (isRunAsCli()) {
   // 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/lib/run-rule-cli.mjs')
-  // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // 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/vue/fix.mjs

@@ -1,3 +1,4 @@
+import { isRunAsCli, runRuleCli } from '../../scripts/lib/run-rule-cli.mjs'
 import { runStandardRule } from '../../scripts/lib/run-standard-rule.mjs'
 
 /**
@@ -10,10 +11,9 @@ export function run(ctx) {
   return runStandardRule(import.meta.dirname, ctx)
 }
 
-if (import.meta.main) {
+if (isRunAsCli()) {
   // 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/lib/run-rule-cli.mjs')
-  // eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
+  // 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/scripts/lib/run-rule-cli.mjs

@@ -7,6 +7,7 @@
  * Library-mode виклик з CLI orchestration — інше: див. `runStandardRule` + `fix.mjs::run(ctx)`.
  */
 import { basename } from 'node:path'
+import { pathToFileURL } from 'node:url'
 
 import { isRuleEnabled, readNCursorConfigLite } from './read-n-cursor-config-lite.mjs'
 import { runStandardRule } from './run-standard-rule.mjs'
@@ -14,6 +15,16 @@ import { getOrCreateWalkCache } from '../utils/walk-cache.mjs'
 
 const PACKAGE_NAME = '@nitra/cursor'
 
+/**
+ * Чи поточний модуль запущено як CLI entry-point (`bun rules/<id>/fix.mjs`).
+ * @returns {boolean} true, коли `import.meta.url` збігається з `process.argv[1]`
+ */
+export function isRunAsCli() {
+  const entry = process.argv[1]
+  if (!entry) return false
+  return import.meta.url === pathToFileURL(entry).href
+}
+
 /**
  * @param {string} ruleDir абсолютний шлях до `rules/<id>/`
  * @returns {Promise<number>} 0 — OK або правило не enabled; 1 — порушення

package/scripts/lib/run-standard-rule.mjs

@@ -32,7 +32,7 @@ import { withLock } from '../utils/with-lock.mjs'
  * @param {RuleContext} [ctx] контекст прогону (walkCache тощо)
  * @returns {Promise<number>} 0 OK, 1 violations
  */
-export async function runStandardRule(ruleDir, ctx = {}) {
+export function runStandardRule(ruleDir, ctx = {}) {
   const ruleId = basename(ruleDir)
   const bundledRulesDir = dirname(ruleDir)
   return withLock(`fix-${ruleId}`, async () => {

package/scripts/utils/resolve-cargo-manifest.mjs

@@ -0,0 +1,62 @@
+/**
+ * Резолвить шлях до Cargo.toml у проєкті: cwd/Cargo.toml або в одному з
+ * workspace-підкаталогів (з підтримкою Tauri-патерну `<workspace>/src-tauri/`).
+ * Спільна утиліта для coverage-провайдера rust і test-концерну cargo_mutants_config.
+ * Повертає null (а не throw) щоб callsite-и могли gracefully skip-нути.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string|null>} абсолютний шлях до Cargo.toml або null
+ */
+export async function resolveCargoManifest(cwd) {
+  const rootManifest = join(cwd, 'Cargo.toml')
+  if (existsSync(rootManifest)) return rootManifest
+
+  const rootPkgPath = join(cwd, 'package.json')
+  if (existsSync(rootPkgPath)) {
+    const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+    const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+    for (const ws of workspaces) {
+      const tauri = join(cwd, ws, 'src-tauri', 'Cargo.toml')
+      if (existsSync(tauri)) return tauri
+      const flat = join(cwd, ws, 'Cargo.toml')
+      if (existsSync(flat)) return flat
+    }
+  }
+  return null
+}
+
+/**
+ * Plural-варіант: повертає всі Cargo.toml-маніфести в проєкті — корінь
+ * (`cwd/Cargo.toml`) і у workspace-підкаталогах (`<ws>/src-tauri/Cargo.toml`
+ * пріоритетніше за `<ws>/Cargo.toml`). Порожній масив якщо нічого не знайдено.
+ * Використовується test-концерном `cargo_mutants_config` для per-manifest
+ * baseline-копіювання.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до знайдених Cargo.toml
+ */
+export async function resolveAllCargoManifests(cwd) {
+  const manifests = []
+  const rootManifest = join(cwd, 'Cargo.toml')
+  if (existsSync(rootManifest)) manifests.push(rootManifest)
+
+  const rootPkgPath = join(cwd, 'package.json')
+  if (existsSync(rootPkgPath)) {
+    const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+    const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+    for (const ws of workspaces) {
+      const tauri = join(cwd, ws, 'src-tauri', 'Cargo.toml')
+      if (existsSync(tauri)) {
+        manifests.push(tauri)
+        continue
+      }
+      const flat = join(cwd, ws, 'Cargo.toml')
+      if (existsSync(flat)) manifests.push(flat)
+    }
+  }
+  return manifests
+}

package/scripts/utils/resolve-js-root.mjs

@@ -0,0 +1,46 @@
+/**
+ * Резолвить корінь JS-коду в проєкті: для workspace-projects — перший workspace
+ * (наприклад `app/` у mlmail), для single-package — корінь cwd. Спільна утиліта
+ * для coverage-провайдера js-lint і test-концерну stryker_config (DRY).
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь проєкту (де `.n-cursor.json` і кореневий package.json)
+ * @returns {Promise<string|null>} абсолютний шлях до JS-root або null без кореневого package.json
+ */
+export async function resolveJsRoot(cwd) {
+  const rootPkgPath = join(cwd, 'package.json')
+  if (!existsSync(rootPkgPath)) return null
+  const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+  const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+  if (workspaces.length > 0) {
+    const wsPath = join(cwd, workspaces[0])
+    if (existsSync(join(wsPath, 'package.json'))) return wsPath
+  }
+  return cwd
+}
+
+/**
+ * Plural-варіант: повертає всі JS-roots проєкту. Для workspace-projects — кожен
+ * workspace з власним `package.json`; для single-package — `[cwd]`. Порожній
+ * масив без кореневого package.json. Використовується test-концерном
+ * `stryker_config` для per-workspace baseline-копіювання.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до всіх JS-roots
+ */
+export async function resolveAllJsRoots(cwd) {
+  const rootPkgPath = join(cwd, 'package.json')
+  if (!existsSync(rootPkgPath)) return []
+  const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
+  const workspaces = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+  if (workspaces.length === 0) return [cwd]
+  const roots = []
+  for (const ws of workspaces) {
+    const wsPath = join(cwd, ws)
+    if (existsSync(join(wsPath, 'package.json'))) roots.push(wsPath)
+  }
+  return roots.length > 0 ? roots : [cwd]
+}

package/scripts/utils/with-lock.mjs

@@ -3,7 +3,7 @@
  * Алгоритм: mkdirSync-based lock, перевірка живості PID, sha256-dedup з TTL.
  */
 import * as fs from 'node:fs'
-import * as path from 'node:path'
+import { join } from 'node:path'
 import * as os from 'node:os'
 import { setTimeout as sleep } from 'node:timers/promises'
 import { worktreeFingerprint } from './worktree-fingerprint.mjs'
@@ -12,9 +12,14 @@ const DEFAULTS = {
   ttl: 600_000,
   staleThreshold: 1_800_000,
   waitTimeout: 1_200_000,
-  pollInterval: 1_500
+  pollInterval: 1500
 }
 
+/**
+ * Чи процес із заданим PID ще живий на поточному host.
+ * @param {number} pid ідентифікатор процесу з owner.json
+ * @returns {boolean} true, якщо process.kill(pid, 0) не кинув помилку
+ */
 function isAlive(pid) {
   try {
     process.kill(pid, 0)
@@ -24,14 +29,21 @@ function isAlive(pid) {
   }
 }
 
+/**
+ * Повертає функцію, що знімає lock-директорію.
+ * @param {string} lockDir абсолютний шлях до lock-директорії
+ * @returns {() => void} release-колбек для finally/signal handler
+ */
 function makeRelease(lockDir) {
   return () => fs.rmSync(lockDir, { recursive: true, force: true })
 }
 
 /**
- * @param {{exitCode:number, fingerprint:string|null, finishedAt:number}} result
- * @param {string|null} fingerprint
- * @param {number} ttl
+ * Чи можна пропустити повторний прогін за кешованим result.json.
+ * @param {{exitCode:number, fingerprint:string|null, finishedAt:number}} result попередній результат з result.json
+ * @param {string|null} fingerprint поточний fingerprint робочого дерева
+ * @param {number} ttl TTL дедуплікації в мілісекундах
+ * @returns {boolean} true, якщо попередній успішний прогін можна повторно використати
  */
 export function shouldDedup(result, fingerprint, ttl) {
   if (result.exitCode !== 0) return false
@@ -41,27 +53,26 @@ export function shouldDedup(result, fingerprint, ttl) {
 }
 
 /**
- * @param {string} key
- * @param {() => number | Promise<number>} runFn
- * @param {{ttl?:number, staleThreshold?:number, waitTimeout?:number, pollInterval?:number, cacheDir?:string, getFingerprint?:() => string | null}} [opts]
- * @returns {Promise<number>}
+ * Серіалізує важку команду через атомарний lock і dedup за fingerprint.
+ * @param {string} key ключ локу (наприклад `lint-ga`, `fix-bun`)
+ * @param {() => number | Promise<number>} runFn основна робота; повертає exit code
+ * @param {{ttl?:number, staleThreshold?:number, waitTimeout?:number, pollInterval?:number, cacheDir?:string, getFingerprint?:() => string | null}} [opts] TTL, шлях кешу та override fingerprint
+ * @returns {Promise<number>} exit code виконаної або дедуплікованої команди
  */
 export async function withLock(key, runFn, opts = {}) {
   const { ttl, staleThreshold, waitTimeout, pollInterval } = { ...DEFAULTS, ...opts }
   const getFingerprint = opts.getFingerprint ?? worktreeFingerprint
-  const cacheDir = opts.cacheDir ?? path.join(process.cwd(), 'node_modules/.cache/n-cursor', key)
-  const lockDir = path.join(cacheDir, 'lock')
-  const ownerFile = path.join(lockDir, 'owner.json')
-  const resultFile = path.join(cacheDir, 'result.json')
+  const cacheDir = opts.cacheDir ?? join(process.cwd(), 'node_modules/.cache/n-cursor', key)
+  const lockDir = join(cacheDir, 'lock')
+  const ownerFile = join(lockDir, 'owner.json')
+  const resultFile = join(cacheDir, 'result.json')
   const release = makeRelease(lockDir)
 
   const fingerprint = getFingerprint()
   fs.mkdirSync(cacheDir, { recursive: true })
 
   const loopStart = Date.now()
-  let locked = false
 
-  // eslint-disable-next-line no-constant-condition
   while (true) {
     if (Date.now() - loopStart >= waitTimeout) {
       console.error(`⚠️ ${key}: чекав ${waitTimeout / 60_000} хв — запускаю без локу`)
@@ -73,7 +84,6 @@ export async function withLock(key, runFn, opts = {}) {
         ownerFile,
         JSON.stringify({ pid: process.pid, host: os.hostname(), startedAt: Date.now(), fingerprint })
       )
-      locked = true
       break
     } catch (error) {
       if (error.code !== 'EEXIST') throw error
@@ -113,6 +123,7 @@ export async function withLock(key, runFn, opts = {}) {
 
   const onSignal = () => {
     release()
+    // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit -- SIGINT/SIGTERM мають завершити процес із кодом 130
     process.exit(130)
   }
   process.once('SIGINT', onSignal)

package/scripts/utils/worktree-fingerprint.mjs

@@ -1,13 +1,16 @@
-/**
- * Fingerprint поточного стану git-робочого дерева.
- * Повертає sha256-hex (64 символи) або null, якщо не в git-репо.
- * @param {typeof import('child_process').spawnSync} spawn
- */
 import { spawnSync } from 'node:child_process'
 import { createHash } from 'node:crypto'
 
+/**
+ * Fingerprint поточного стану git-робочого дерева.
+ * @param {typeof import('child_process').spawnSync} [spawn] sync-виклик git (ін'єкція для тестів)
+ * @returns {string|null} sha256-hex (64 символи) або null, якщо не в git-репо
+ */
 export function worktreeFingerprint(spawn = spawnSync) {
-  /** @param {string[]} args */
+  /**
+   * @param {string[]} args аргументи підкоманди git
+   * @returns {string} stdout git-команди
+   */
   function git(args) {
     const r = spawn('git', args, { encoding: 'utf8' })
     if (r.status !== 0 || r.error) throw new Error(`git ${args[0]} failed`)
@@ -21,7 +24,7 @@ export function worktreeFingerprint(spawn = spawnSync) {
     // повертаються у `"..."` формі, і `git hash-object` не знаходить файл → throw → fingerprint=null.
     const untrackedRaw = git(['ls-files', '-z', '--others', '--exclude-standard'])
     const untrackedFiles = untrackedRaw.split('\0').filter(Boolean)
-    const pairs = untrackedFiles.map(f => `${f}:${git(['hash-object', f]).trim()}`).sort()
+    const pairs = untrackedFiles.map(f => `${f}:${git(['hash-object', f]).trim()}`).toSorted()
     const raw = [commitHash, diffText, ...pairs].join('\n')
     return createHash('sha256').update(raw).digest('hex')
   } catch {