@7n/test 0.10.2 → 0.10.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.10.3] - 2026-07-03
+
+### Added
+
+- COVERAGE.md тепер записується і при --no-mutation: береться per-file line coverage з останньої ітерації циклу тестування (без мутаційних даних) замість повного пропуску запису звіту.
+
 ## [0.10.2] - 2026-07-02
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",

package/src/coverage-per-file.mjs

@@ -148,6 +148,35 @@ export function getUncoveredFiles(files, threshold = 80) {
   return files.filter(f => f.pct < threshold)
 }
 
+/**
+ * Рендерить per-file line coverage як Markdown-таблицю без мутаційних даних.
+ * Використовується для `COVERAGE.md`, коли мутаційне тестування пропущено
+ * (`--no-mutation`) і провайдери `.n-cursor.json#rules` не викликались.
+ * @param {Array<{file: string, pct: number, linesFound: number, linesCovered: number}>} files per-file coverage rows
+ * @returns {string} Markdown з заголовком `# Coverage`
+ */
+export function renderPerFileMarkdown(files) {
+  const sorted = files.toSorted((a, b) => a.pct - b.pct || a.file.localeCompare(b.file))
+  const lines = [
+    '# Coverage',
+    '',
+    '_Мутаційне тестування пропущено (`--no-mutation`) — лише per-file покриття рядків._',
+    '',
+    '| Файл | Рядки | % |',
+    '| --- | --- | --- |'
+  ]
+  let coveredTotal = 0
+  let foundTotal = 0
+  for (const f of sorted) {
+    lines.push(`| ${f.file} | ${f.linesCovered}/${f.linesFound} | ${f.pct.toFixed(2)}% |`)
+    coveredTotal += f.linesCovered
+    foundTotal += f.linesFound
+  }
+  const totalPct = foundTotal === 0 ? 100 : (coveredTotal / foundTotal) * 100
+  lines.push(`| **Разом** | ${coveredTotal}/${foundTotal} | ${totalPct.toFixed(2)}% |`)
+  return `${lines.join('\n')}\n`
+}
+
 const SOURCE_EXT_RE = /\.(mjs|js|ts|vue|py)$/
 const IGNORE_DIRS = new Set([
   'node_modules',

package/src/docs/coverage-per-file.md

@@ -3,7 +3,7 @@ type: JS Module
 title: coverage-per-file.mjs
 resource: npm/src/coverage-per-file.mjs
 docgen:
-  crc: 54eea127
+  crc: edc508cb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98
@@ -20,12 +20,14 @@ docgen:
 measureCoveragePerFile запускає Vitest з генерацією покриття та звітністю у форматі JSON у єдиному проході, повертаючи дані про покриття по файлах та список тестів, що не пройшли. При цьому ігноруються папки та файли, такі як node_modules та .git, і винятки у процесі вимірювання обробляються, не викликаючи збоїв.
 getUncoveredFiles відфільтровує файли, покриття яких нижче заданого порогового значення.
 findSourceFiles рекурсивно знаходить усі файли вихідного коду в заданому каталозі, виключаючи тестові файли та директорії, визначені як ігнорувані.
+renderPerFileMarkdown рендерить per-file покриття рядків (без мутаційних даних) як Markdown-таблицю з підсумковим рядком «Разом», відсортовану за зростанням відсотка покриття.
 
 ## Публічний API
 
 - measureCoveragePerFile — Вимірює покриття коду за файлами, збираючи результати покриття Vitest та логуючи провалені тести за один прохід.
 - getUncoveredFiles — Повертає список файлів, які не досягли встановленого порогу покриття.
 - findSourceFiles — Рекурсивно шукає файли вихідного коду в директорії, ігноруючи тестові файли та проігноровані каталоги, використовуючи це для ініціалізації у разі відсутності даних про покриття.
+- renderPerFileMarkdown — Форматує масив per-file coverage рядків у Markdown-документ `# Coverage` для запису в `COVERAGE.md`, коли мутаційне тестування пропущено.
 
 ## Гарантії поведінки
 

package/src/docs/run.md

@@ -3,7 +3,7 @@ type: JS Module
 title: run.mjs
 resource: npm/src/run.mjs
 docgen:
-  crc: b932be1d
+  crc: f71ad579
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.95
@@ -12,21 +12,22 @@ docgen:
 
 ## Огляд
 
-Main auto-test loop забезпечує автоматизований цикл тестування з метою підвищення покриття коду. У першій фазі відбувається вимірювання покриття коду по файлах через vitest+lcov. Якщо покриття нижче заданого порогу, генеруються тести для відповідних файлів. Процес повторюється, доки покриття не досягне максимуму або не буде досягнуто обмежень ітерацій. Друга фаза включає мутаційне тестування, яке проводиться з використанням існуючих провайдерів покриття, залежність від .n-cursor.json. Після виявлення виживших мутантів, pi agent автоматично їх виправляє. Функція runAutoTest перехоплює можливі помилки, запобігаючи виняткам на виході, але не виконує кешування.
+Main auto-test loop забезпечує автоматизований цикл тестування з метою підвищення покриття коду. У першій фазі відбувається вимірювання покриття коду по файлах через vitest+lcov. Якщо покриття нижче заданого порогу, генеруються тести для відповідних файлів. Процес повторюється, доки покриття не досягне максимуму або не буде досягнуто обмежень ітерацій. Друга фаза включає мутаційне тестування, яке проводиться з використанням існуючих провайдерів покриття, залежність від .n-cursor.json. Після виявлення виживших мутантів, pi agent автоматично їх виправляє. З опцією `noMutation` друга фаза повністю пропускається, а натомість `COVERAGE.md` записується з per-file покриттям, отриманим в останній ітерації першої фази. Функція runAutoTest перехоплює можливі помилки, запобігаючи виняткам на виході, але не виконує кешування.
 
 ## Поведінка
 
 Поведінка
 
 1. Викликається `runAutoTest` для запуску циклу автоматичного тестування.
-2. У циклі до п'яти ітерацій вимірюється покриття кожної функції у проекті.
+2. У циклі до п'яти ітерацій вимірюється покриття кожної функції у проекті; результат останньої ітерації зберігається для можливого запису в `COVERAGE.md`.
 3. Якщо існують падіння тестів, вони автоматично виправляються через агент, і цикл продовжується.
 4. Якщо немає тестів, відбувається запуск процесу Bootstrap: скануються вихідні файли, класифікуються, і для тих, що потребують тестів, генеруються початкові тести.
 5. Обчислюється загальне покриття. Якщо воно досягло встановленого порогу, цикл зупиняється.
 6. Якщо покриття не покращилося порівняно з попередньою ітерацією, цикл зупиняється.
 7. Якщо покриття недостатнє, генеруються тести для некритичних файлів і цикл повторюється.
-8. Після завершення циклу, якщо не вказано інакше, запускається мутаційне тестування, яке залежить від конфігурації в `.n-cursor.json`.
-9. У разі успішного виживання мутантів, виконується повторний запуск покриття для перевірки.
+8. Якщо передано опцію `noMutation`, мутаційне тестування пропускається: `COVERAGE.md` записується з per-file покриттям останньої ітерації (без мутаційних даних), або лишається незаписаним, якщо даних покриття не отримано.
+9. Інакше запускається мутаційне тестування, яке залежить від конфігурації в `.n-cursor.json`.
+10. У разі успішного виживання мутантів, виконується повторний запуск покриття для перевірки.
 
 ## Гарантії поведінки
 

package/src/run.mjs

@@ -7,17 +7,24 @@
  *   3. Bootstrap: when no tests exist, scan sources and quickClassify locally.
  *   4. Repeat until coverage maxes out or no improvement.
  *
- * Phase 2:
+ * Phase 2 (skipped entirely with --no-mutation, which instead writes
+ * COVERAGE.md from the last Phase 1 per-file measurement):
  *   5. Mutation testing via existing coverage providers (requires .n-cursor.json#rules).
  *   6. Auto-fix survived mutants via pi agent.
  */
-import { measureCoveragePerFile, getUncoveredFiles, findSourceFiles } from './coverage-per-file.mjs'
+import {
+  measureCoveragePerFile,
+  getUncoveredFiles,
+  findSourceFiles,
+  renderPerFileMarkdown
+} from './coverage-per-file.mjs'
 import { quickClassify } from './assess-need.mjs'
 import { generateTests } from './gen-tests.mjs'
 import { fixFailingTests } from './fix-tests.mjs'
 import { runCoverageSteps } from './coverage/coverage.mjs'
 import { withLock } from './scripts/utils/with-lock.mjs'
 import { readFileSync } from 'node:fs'
+import { writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
 const MAX_ITERATIONS = 5
@@ -25,18 +32,20 @@ const COVERAGE_THRESHOLD = 80
 
 /**
  * @param {string} dir absolute path to project root
- * @param {{ noMutation?: boolean }} [opts]
+ * @param {{ noMutation?: boolean }} [opts] опції запуску
  * @returns {Promise<number>} exit code
  */
 export async function runAutoTest(dir, opts = {}) {
   console.log(`\n📁 ${dir}\n`)
 
   let prevUncoveredCount = Infinity
+  let lastFiles = []
 
   for (let i = 1; i <= MAX_ITERATIONS; i++) {
     console.log(`\n── Ітерація ${i}/${MAX_ITERATIONS}: coverage ──\n`)
 
     const { files: allFiles, failingTests } = await measureCoveragePerFile(dir)
+    lastFiles = allFiles
 
     if (failingTests.length > 0) {
       console.log(`\n── ${failingTests.length} тестів падають — виправляю (pi agent) ──\n`)
@@ -107,6 +116,12 @@ export async function runAutoTest(dir, opts = {}) {
 
   if (opts.noMutation) {
     console.log('\n── Мутаційне тестування пропущено (--no-mutation) ──\n')
+    if (lastFiles.length > 0) {
+      await writeFile(join(dir, 'COVERAGE.md'), renderPerFileMarkdown(lastFiles), 'utf8')
+      console.log('✓ COVERAGE.md (тільки per-file покриття, без мутантів)')
+    } else {
+      console.log('⚠ Немає даних покриття — COVERAGE.md не записано.')
+    }
     return 0
   }