@nitra/cursor 1.28.3 → 1.28.5

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.28.5] - 2026-05-28
+
+### Fixed
+
+- **`scripts/utils/resolve-js-root.mjs`** — `resolveAllJsRoots()` тепер розгортає glob-патерни (`cf/*`, `packages/*` тощо) у списку `workspaces` через `node:fs/promises#glob`. Без цього `cf/*` як літерал не резолвився через `existsSync`, і `resolveJsRoot()` падав на fallback → `cwd`; `n-cursor coverage` із кореня запускав vitest у root-у проєкту без `vitest.config.js` (через `gt/tests/setup.mjs` не підвантажувався). `resolveJsRoot()` тепер тонкий wrapper над `resolveAllJsRoots()[0]`. Додано 2 тести: glob-розгортання `cf/*` і fallback на `[cwd]` при порожньому збігу.
+- **`rules/js-lint/coverage/coverage.mjs#collect()`** — у monorepo тепер ітерує **всі** JS-roots з `resolveAllJsRoots()`, запускає vitest + Stryker у кожному окремо та сумує `lcov` (через локальний `addCoverage`) і `mutation` (через `addMutation`). Шляхи у `survived[].file` і `survived[].exampleTest.testFile` рібейзяться відносно `cwd` (`relative(cwd, jsRoot)`/`join(wsRel, file)`), щоб `coverage-fix.mjs#buildFixPrompt` коректно читав source-файли через `join(projectRoot, file)`. `detect()` повертає `true`, якщо vitest є хоча б в одному workspace АБО в кореневому `package.json`. Додано тест агрегування у monorepo з `cf/*`-glob.
+
+## [1.28.4] - 2026-05-28
+
+### Changed
+
+- **`rules/test/auto.md` → `завжди`**, **`scripts/auto-rules.mjs`** — правило `test` тепер додається у `.n-cursor.json#rules` беззастережно (як `adr`/`security`/`text`), без вимоги наявності `*.test.mjs`. `AUTO_RULE_ORDER` отримало `test`; `addRule('test')` викликається з безумовного блоку. Тест `auto-rules.test.mjs` оновлено: `'test'` додано в `ALL_RULES` і в очікуваний результат «додає правила за ознаками проєкту». Мотивація — узгодження з `bun.mdc`-винятком на root-only Vitest/Stryker peer/tools: щоб умова «корінь єдине місце для `vitest`/`@vitest/coverage-v8`/`@stryker-mutator/vitest-runner`» була правдою у кожному споживачі `@nitra/cursor`, а не «лише у dog food-репо».
+- **`rules/bun/bun.mdc`** (`version` 1.9 → 2.0) і дзеркало `.cursor/rules/n-bun.mdc` — переформульовано пункт про root-only Vitest/Stryker peer/tools: прибрано згадку «лише для dog food-репо `@nitra/cursor`», тепер виняток описано як **загальний** для будь-якого монорепо, що вмикає правило `test` і виконує `n-cursor coverage`. Структурна причина: published workspace-и за `npm-module.mdc` не мають `devDependencies`, а оркестратор coverage запускається з кореня. Збігається з фактичною поведінкою `policy/package_json/package_json.rego` (`allowed_root_test_deps` — глобальний whitelist, без перевірки імені репо).
+- **`rules/bun/policy/package_json/package_json.rego`** — оновлено docstring модуля і коментар на `allowed_root_dev_dependency`: тепер посилаються на always-on `test/auto.md` + `npm-module.mdc`, без «dog food-прогонів». Логіка `allowed_root_test_deps` не змінилася — лише пояснення синхронізовано з `bun.mdc`.
+
 ## [1.28.3] - 2026-05-28
 
 ### Changed

package/package.json

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

package/rules/bun/bun.mdc

@@ -2,7 +2,7 @@
 description: Bun як єдиний package manager у монорепо
 globs: "**/package.json,**/bunfig.toml,**/bun.lock,**/bun.lockb"
 alwaysApply: false
-version: '1.9'
+version: '2.0'
 ---
 
 Проект використовує тільки Bun для керування залежностями та запуску скриптів.
@@ -42,7 +42,7 @@ Lockfile у репозиторії: `bun.lock`.
 - Якщо залежність потрібна лише одному пакету, додавати її в директорії цього пакета.
 - У CI та локально запускати скрипти через `bun run`.
 
-В кореневому в package.json не повинно бути `dependencies`, а в `devDependencies` — тільки модулі `@nitra/*`. Виняток для цього dog food-репозиторію `@nitra/cursor`: root-only Vitest/Stryker peer/tools (`vitest`, `@vitest/coverage-v8`, `@stryker-mutator/vitest-runner`), бо published workspace `npm/` не має devDependencies за `npm-module.mdc`. Якщо в package.json є поля `packageManager`, то прибрати їх, також прибрати всі директорії та файли для yarn.
+В кореневому `package.json` не повинно бути `dependencies`, а в `devDependencies` — тільки модулі `@nitra/*`. **Виняток (root-only)** — Vitest/Stryker peer/tools для `n-cursor coverage`: `vitest`, `@vitest/coverage-v8`, `@stryker-mutator/vitest-runner`. Тримати їх **у корені** доводиться у будь-якому монорепо-споживачі, бо правило `test` enabled завжди (`test/auto.md` = `завжди`), а класти ці пакети у workspace-и не можна: published пакети (`npm-module.mdc`) не мають мати `devDependencies`, а інші workspace-и однаково запускають coverage оркестратор з кореня. Якщо в package.json є поля `packageManager`, то прибрати їх, також прибрати всі директорії та файли для yarn.
 
 - Заборонені top-level поля у root `package.json` (з причинами): [package.json.deny.json](./policy/package_json/template/package.json.deny.json)
 

package/rules/bun/policy/package_json/package_json.rego

@@ -5,7 +5,9 @@
 # (top-level fields заборонені у root).
 #
 # Логіка, що ЛИШАЄТЬСЯ у rego (inverse-patterns, не виносяться у template):
-#  - `devDependencies` лише `@nitra/*` + root-only тестові peer/tools для dog food (inverse-pattern)
+#  - `devDependencies` лише `@nitra/*` + root-only тестові peer/tools для `n-cursor coverage`
+#    (правило `test` enabled завжди — див. `test/auto.md`; published workspace-и не мають
+#     `devDependencies` за `npm-module.mdc`)
 #  - Агрегований `lint` скрипт (cross-script aggregation logic)
 #
 # Перевірки, які ЗАЛИШИЛИСЬ у JS (потребують FS / cross-file):
@@ -71,8 +73,9 @@ allowed_root_test_deps := {"vitest", "@vitest/coverage-v8", "@stryker-mutator/vi
 allowed_root_dev_dependency(name) if {
 	startswith(name, "@nitra/")
 } else if {
-	# Ці пакети потрібні на рівні root для dog food-прогонів Vitest/Stryker у монорепо,
-	# але npm-module забороняє класти devDependencies у published workspace `npm/`.
+	# Vitest/Stryker peer/tools для `n-cursor coverage` живуть у корені будь-якого
+	# монорепо-споживача: правило `test` enabled завжди, а published workspace-и
+	# не мають `devDependencies` (`npm-module.mdc`).
 	name in allowed_root_test_deps
 }
 

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

@@ -10,9 +10,9 @@ 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 } from 'node:path'
+import { join, relative } from 'node:path'
 
-import { resolveJsRoot } from '../../../scripts/utils/resolve-js-root.mjs'
+import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
@@ -30,21 +30,24 @@ function hasVitestDep(pkg) {
 
 /**
  * Чи провайдер застосовний у поточному cwd. Активується, коли `vitest`
- * декларовано у JS-root АБО у кореневому `package.json` (workspace-проєкт із
- * hoisted node_modules — типовий патерн bun monorepo, де npm-module rule
- * забороняє devDeps у published workspace-у, тож вони живуть у корені).
- * Інакше silent skip із hint у stderr (одноразово).
+ * декларовано хоча б в одному JS-root АБО у кореневому `package.json`
+ * (workspace-проєкт із hoisted node_modules — типовий патерн bun monorepo,
+ * де npm-module rule забороняє devDeps у published workspace-у, тож вони
+ * живуть у корені). Інакше silent skip із hint у stderr (одноразово).
  * @param {string} cwd корінь проєкту
  * @returns {Promise<boolean>} true, якщо проєкт сумісний з vitest-based coverage
  */
 export async function detect(cwd) {
-  const jsRoot = await resolveJsRoot(cwd)
-  if (jsRoot === null) return false
-  const pkgPath = join(jsRoot, 'package.json')
-  if (!existsSync(pkgPath)) return false
-  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
-  if (hasVitestDep(pkg)) return true
-  if (jsRoot !== cwd) {
+  const jsRoots = await resolveAllJsRoots(cwd)
+  if (jsRoots.length === 0) return false
+  for (const jsRoot of jsRoots) {
+    const pkgPath = join(jsRoot, 'package.json')
+    if (!existsSync(pkgPath)) continue
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+    if (hasVitestDep(pkg)) return true
+  }
+  const rootInJsRoots = jsRoots.includes(cwd)
+  if (!rootInJsRoots) {
     const rootPkgPath = join(cwd, 'package.json')
     if (existsSync(rootPkgPath)) {
       const rootPkg = JSON.parse(await readFile(rootPkgPath, 'utf8'))
@@ -224,40 +227,91 @@ const defaultRunner = {
 }
 
 /**
- * Збирає JS-метрики покриття + мутаційного тестування.
+ * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує кожен
+ * JS-root з `resolveAllJsRoots()` (включно з glob-патернами на кшталт `cf/*`),
+ * запускає vitest+Stryker у кожному та сумує lcov/mutation. Шляхи файлів у
+ * `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs` знаходив джерела.
  * @param {string} cwd корінь проєкту
  * @param {{runner?: typeof defaultRunner}} [opts] runner-ін'єкція для тестів
  * @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
-  const jsRoot = await resolveJsRoot(cwd)
-  if (jsRoot === null) throw new Error('js-lint coverage: package.json не знайдено')
+  const jsRoots = await resolveAllJsRoots(cwd)
+  if (jsRoots.length === 0) throw new Error('js-lint coverage: package.json не знайдено')
+
+  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  let mutation = { caught: 0, total: 0 }
+  const survived = []
+
+  for (const jsRoot of jsRoots) {
+    const wsRel = relative(cwd, jsRoot)
+
+    // 1. Coverage через vitest run --coverage (v8 provider пише lcov.info у lcovDir)
+    const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
+    try {
+      const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
+      if (code !== 0) throw new Error(`JS coverage exit ${code}`)
+      coverage = addCoverage(coverage, parseLcov(await readFile(join(lcovDir, 'lcov.info'), 'utf8')))
+    } finally {
+      await rm(lcovDir, { recursive: true, force: true })
+    }
+
+    // 2. Mutation через Stryker
+    await runner.runStryker({ cwd: jsRoot })
+    let mutationReport
+    try {
+      mutationReport = JSON.parse(await readFile(join(jsRoot, 'reports', 'stryker', 'mutation.json'), 'utf8'))
+    } catch {
+      throw new Error(
+        'js-lint coverage: stryker не залишив mutation.json — ' +
+          'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
+          'або налаштуй його вручну'
+      )
+    }
+    const parsed = parseStrykerReport(mutationReport, jsRoot)
+    mutation = addMutation(mutation, { caught: parsed.caught, total: parsed.total })
 
-  // 1. Coverage через vitest run --coverage (v8 provider пише lcov.info у lcovDir)
-  const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
-  let coverage
-  try {
-    const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
-    if (code !== 0) throw new Error(`JS coverage exit ${code}`)
-    coverage = parseLcov(await readFile(join(lcovDir, 'lcov.info'), 'utf8'))
-  } finally {
-    await rm(lcovDir, { recursive: true, force: true })
+    for (const group of parsed.survived) {
+      survived.push({
+        ...group,
+        file: wsRel === '' ? group.file : join(wsRel, group.file),
+        exampleTest: group.exampleTest
+          ? {
+              ...group.exampleTest,
+              testFile: wsRel === '' ? group.exampleTest.testFile : join(wsRel, group.exampleTest.testFile)
+            }
+          : null
+      })
+    }
   }
 
-  // 2. Mutation через Stryker
-  await runner.runStryker({ cwd: jsRoot })
-  let mutationReport
-  try {
-    mutationReport = JSON.parse(await readFile(join(jsRoot, 'reports', 'stryker', 'mutation.json'), 'utf8'))
-  } catch {
-    throw new Error(
-      'js-lint coverage: stryker не залишив mutation.json — ' +
-        'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
-        'або налаштуй його вручну'
-    )
+  return [{ area: 'JS', coverage, mutation, survived }]
+}
+
+/**
+ * Сумування coverage-totals — імпортується з оркестратора при потребі; тут
+ * локальна копія, щоб уникнути циклу test/coverage → js-lint/coverage.
+ * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} a перший
+ * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} b другий
+ * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} сума
+ */
+function addCoverage(a, b) {
+  return {
+    lines: { covered: a.lines.covered + b.lines.covered, total: a.lines.total + b.lines.total },
+    functions: {
+      covered: a.functions.covered + b.functions.covered,
+      total: a.functions.total + b.functions.total
+    }
   }
-  const { caught, total, survived } = parseStrykerReport(mutationReport, jsRoot)
+}
 
-  return [{ area: 'JS', coverage, mutation: { caught, total }, survived }]
+/**
+ * Сумування mutation-counts.
+ * @param {{caught:number,total:number}} a перший
+ * @param {{caught:number,total:number}} b другий
+ * @returns {{caught:number,total:number}} сума
+ */
+function addMutation(a, b) {
+  return { caught: a.caught + b.caught, total: a.total + b.total }
 }

package/rules/test/auto.md

@@ -1 +1 @@
-якщо у проекті є хоча б один файл `*.test.mjs`
+завжди

package/scripts/auto-rules.mjs

@@ -51,6 +51,7 @@ export const AUTO_RULE_ORDER = Object.freeze([
   'rust',
   'security',
   'style-lint',
+  'test',
   'text',
   'vue'
 ])
@@ -674,6 +675,7 @@ export async function detectAutoRules({
   }
   addRule('adr')
   addRule('security')
+  addRule('test')
   addRule('text')
   if (facts.hasVueSource) {
     addRule('vue')

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

@@ -1,33 +1,48 @@
 /**
  * Резолвить корінь JS-коду в проєкті: для workspace-projects — перший workspace
- * (наприклад `app/` у mail app), для single-package — корінь cwd. Спільна утиліта
- * для coverage-провайдера js-lint і test-концерну stryker_config (DRY).
+ * (з підтримкою glob-патернів типу `cf/*`), для single-package — корінь cwd.
+ * Спільна утиліта для coverage-провайдера js-lint і test-концерну stryker_config (DRY).
  */
 import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
+import { glob, readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
+const WORKSPACE_GLOB_IGNORE = ['**/node_modules/**', '**/.git/**']
+
+/**
+ * Розгортає один workspace-патерн у список абсолютних шляхів каталогів з package.json.
+ * Літеральні патерни перевіряються через existsSync; glob-патерни — через node:fs/promises#glob.
+ * @param {string} cwd корінь проєкту
+ * @param {string} pattern workspace-патерн з package.json (наприклад, `app` або `cf/*`)
+ * @returns {Promise<string[]>} абсолютні шляхи до workspace-каталогів
+ */
+async function expandWorkspacePattern(cwd, pattern) {
+  if (!pattern.includes('*')) {
+    const wsPath = join(cwd, pattern)
+    return existsSync(join(wsPath, 'package.json')) ? [wsPath] : []
+  }
+  const results = []
+  for await (const rel of glob(`${pattern}/package.json`, { cwd, exclude: WORKSPACE_GLOB_IGNORE })) {
+    const wsRel = rel.replace(/[/\\]package\.json$/, '')
+    results.push(join(cwd, wsRel))
+  }
+  return results.sort()
+}
+
 /**
  * @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
+  const roots = await resolveAllJsRoots(cwd)
+  if (roots.length === 0) return null
+  return roots[0]
 }
 
 /**
  * Plural-варіант: повертає всі JS-roots проєкту. Для workspace-projects — кожен
- * workspace з власним `package.json`; для single-package — `[cwd]`. Порожній
- * масив без кореневого package.json. Використовується test-концерном
- * `stryker_config` для per-workspace baseline-копіювання.
+ * workspace з власним `package.json` (з розгортанням glob-патернів); для
+ * single-package — `[cwd]`. Порожній масив без кореневого package.json.
  * @param {string} cwd корінь проєкту
  * @returns {Promise<string[]>} абсолютні шляхи до всіх JS-roots
  */
@@ -35,12 +50,11 @@ 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 patterns = Array.isArray(rootPkg.workspaces) ? rootPkg.workspaces : []
+  if (patterns.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)
+  for (const pattern of patterns) {
+    roots.push(...(await expandWorkspacePattern(cwd, pattern)))
   }
   return roots.length > 0 ? roots : [cwd]
 }