@nitra/cursor 1.28.4 → 1.28.5

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 Формат — [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

package/package.json

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

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/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]
 }