@nitra/cursor 1.17.2 → 1.17.3

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.17.3] - 2026-05-24
+
+### Added
+
+- Концерн `stryker_config` правила `test` тепер ідемпотентно додає у кореневий `.gitignore` патерни Stryker-output-у:
+  - `**/reports/stryker/.tmp/` — in-place backup-каталог (з baseline-у `tempDirName`).
+  - `**/reports/stryker/mutation.json` — JSON-репорт мутацій.
+  - Header-секція `# Stryker mutation testing (test.mdc)`, sectioning через `ensureGitignoreEntries`.
+- Спільний helper `npm/scripts/utils/ensure-gitignore-entries.mjs` — append-only оновлювач `.gitignore` з header-секціями. Idempotent (точне співпадіння рядка після `trim`), створює файл якщо немає, зберігає trailing-newline. 5 unit-тестів.
+
+### Changed
+
+- `test.mdc` 2.0 → 2.1: додано параграф про gitignore-керування Stryker-output-у в секцію «Налаштування mutation-testing».
+- `stryker_config` concern: додано виклик `ensureGitignoreEntries` після копіювання baseline-ів; репортер видає pass-повідомлення про додані патерни.
+
 ## [1.17.2] - 2026-05-24
 
 ### Added

package/package.json

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

package/rules/test/js/stryker_config.mjs

@@ -17,11 +17,18 @@ 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 { ensureGitignoreEntries } from '../../../scripts/utils/ensure-gitignore-entries.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')
 
+// Stryker-output патерни для .gitignore: temp-каталог з backup-файлами
+// (`tempDirName: 'reports/stryker/.tmp'` у baseline) і JSON-репорт мутацій.
+// Канон in-place mode у baseline лишає backup'и у `reports/stryker/.tmp/backup-XXX/`,
+// які НЕ можна комітити. Подвійний-зірочка-префікс покриває всі workspaces.
+const STRYKER_GITIGNORE_ENTRIES = ['**/reports/stryker/.tmp/', '**/reports/stryker/mutation.json']
+
 /**
  * @returns {Promise<number>} 0 — OK або silently skipped, 1 — порушення
  */
@@ -57,5 +64,12 @@ export async function check() {
     await copyFile(BASELINE_PATH, target)
     reporter.pass(`stryker.config.mjs створено з canonical baseline (${relative(cwd, target)}) (test.mdc)`)
   }
+
+  // Гарантуємо що Stryker temp/output ніколи не комітяться. Patterns
+  // покривають усі workspaces через `**/`-префікс (єдиний root .gitignore).
+  const { added } = await ensureGitignoreEntries(cwd, STRYKER_GITIGNORE_ENTRIES, 'Stryker mutation testing (test.mdc)')
+  if (added.length > 0) {
+    reporter.pass(`.gitignore: додано Stryker-патерни (${added.join(', ')}) (test.mdc)`)
+  }
   return reporter.getExitCode()
 }

package/rules/test/test.mdc

@@ -1,6 +1,6 @@
 ---
 description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.0'
+version: '2.1'
 globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
@@ -81,3 +81,5 @@ Recursive globs ловлять файли всередині `tests/` так с
 Канон cargo-mutants config: [mutants.toml.baseline](./js/data/cargo_mutants_config/mutants.toml.baseline)
 
 Customization (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерни лише забезпечують наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.
+
+Додатково: коли `js-lint` enabled, концерн `stryker_config` ідемпотентно додає у кореневий `.gitignore` патерни Stryker-output-у — `**/reports/stryker/.tmp/` (in-place backup-каталог з baseline-у) і `**/reports/stryker/mutation.json` (JSON-репорт). Це запобігає випадковому коміту backup-копій вихідного коду та мутаційного звіту як build-артефактів.

package/scripts/utils/ensure-gitignore-entries.mjs

@@ -0,0 +1,30 @@
+/**
+ * Idempotent append-only оновлювач `.gitignore` у корені проєкту. Перевіряє,
+ * чи задані entries уже присутні (точне співпадіння рядка після `trim`); відсутні
+ * дописує під header-комент, не порушуючи решту файлу. Якщо `.gitignore` немає —
+ * створюється з заданими entries + header.
+ *
+ * Викликається з test-концерну `stryker_config` (gitignore Stryker temp dirs).
+ */
+import { existsSync } from 'node:fs'
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * @param {string} cwd корінь репо (де знаходиться `.gitignore`)
+ * @param {string[]} entries патерни для .gitignore (порядок збережено)
+ * @param {string} sectionLabel header-коментар над секцією (без `#`-префікса)
+ * @returns {Promise<{added: string[]}>} перелік патернів, що були дописані
+ */
+export async function ensureGitignoreEntries(cwd, entries, sectionLabel) {
+  const gitignorePath = join(cwd, '.gitignore')
+  const existing = existsSync(gitignorePath) ? await readFile(gitignorePath, 'utf8') : ''
+  const existingLines = new Set(existing.split('\n').map(line => line.trim()))
+  const missing = entries.filter(entry => !existingLines.has(entry))
+  if (missing.length === 0) return { added: [] }
+
+  const prefix = existing.length === 0 || existing.endsWith('\n') ? '' : '\n'
+  const block = `${prefix}\n# ${sectionLabel}\n${missing.join('\n')}\n`
+  await writeFile(gitignorePath, existing + block)
+  return { added: missing }
+}